Hyper3DHyper3D Docs
API Specification

Rodin Agentic

Generate 3D assets from images with Rodin Agentic.

Beta Feature

This feature is in beta version. Rodin Agentic uses AI to determine the most suitable generation mode, so results may carry some uncertainty.

POST
/api/v2/rodin_agentic

Authorization

bearer
headerAuthorizationBearer <token>

Request Body

multipart/form-data
  1. body
images*array<>

One to five reference images, up to 25 MiB each.

prompt?string
Lengthlength <= 1024
Default""
tier?string
Default"standard"
Value in"basic""standard""pro"
export_type?string
Default"glb"
Value in"glb""usdz""fbx""stl"

Response Body

application/json
  1. response
uuid*string

Unique identifier for the submitted generation task.

Formatuuid
job*
producer*string
Value in"high-poly""n-gons"
Example Request
curl -X POST 'https://api.hyper3d.com/api/v2/rodin_agentic' \  -F 'images=[  "string"]'
Example Response
{  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",  "job": {    "uuids": [      "52faea01-729e-4195-85e8-6050a65315e3"    ],    "subscription_key": "string"  },  "producer": "high-poly"}

Input

Submit one to five reference images, with a maximum of 25 MiB for each image. prompt is optional; when omitted, the service derives guidance from the images.

curl --fail-with-body --request POST 'https://api.hyper3d.com/api/v2/rodin_agentic' \
  --header "Authorization: Bearer ${RODIN_API_KEY}" \
  --form 'images=@./input.png' \
  --form 'tier=standard' \
  --form 'export_type=glb'

Tier & Pricing

TierDescriptionElapsed TimeCharge
basicBasic tier: Uses a lower thinking effort to prioritize faster generation speed.3 minutes0.5 credits
standardStandard tier: Applies a balanced thinking effort and generation speed. Suitable for most general-purpose use cases.5 minutes1.0 credits
proPro tier: Engages a stronger thinking effort, resulting in longer generation time but producing higher-quality output. Recommended for complex tasks that demand deeper reasoning and better results.10 minutes2.0 credits

Response and lifecycle

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "producer": "high-poly",
  "job": {
    "uuids": ["223e4567-e89b-12d3-a456-426614174000"],
    "subscription_key": "subscription-key-from-generation-response"
  }
}

Use job.subscription_key for Check Status and top-level uuid for Download Results.