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.

Let Rodin Agent choose the best parameters and forms for 3D modeling and submit the generation task.

Authorization

bearer

AuthorizationBearer <token>

In: header

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

images*array<>

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

prompt?string

Optional. If omitted or blank, the service derives the prompt from the images.

tier?string

Optional. Generation tier:

basic: Basic tier, with limited features.

standard: Standard tier, with more features.

pro: Pro tier, with all features.

export_type?string

Optional. Final export format: glb (default), usdz, fbx, or stl.

Response Body

`application/json`

curl -X POST "https://example.com/api/v2/rodin_agentic" \  -F images="[    \"string\"  ]"

{  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",  "producer": "high-poly",  "job": {    "uuids": [      "52faea01-729e-4195-85e8-6050a65315e3"    ],    "subscription_key": "string"  }}

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

Tier	Description	Elapsed Time	Charge
`basic`	Basic tier: Uses a lower thinking effort to prioritize faster generation speed.	3 minutes	`0.5 credits`
`standard`	Standard tier: Applies a balanced thinking effort and generation speed. Suitable for most general-purpose use cases.	5 minutes	`1.0 credits`
`pro`	Pro 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 minutes	`2.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.