Rodin Agentic

试验性功能

该功能目前为beta测试版本。 Rodin Agentic 使用 AI 选择最合适的生成模式，因此结果可能会携带一些不确定性。

交由 Rodin Agent 选择最合适的图生 3D 建模参数与形式并提交生成任务。

Authorization

bearer

AuthorizationBearer <token>

In: header

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

images*array<>

一到五张参考图片，每张最大 25 MiB。

prompt?string

可选。若省略或为空，服务会根据图片生成提示词。

tier?string

可选。生成档位：

basic: 基础档位，仅支持有限的功能。

standard: 标准档位，支持更多功能。

pro: Pro 档位，支持所有功能。

export_type?string

可选。最终导出格式：glb（默认）、usdz、fbx、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"  }}

输入

提交一到五张参考图片 images，每个图片最大 25 MiB。 prompt 是可选的，当未提供时，服务会根据图片推导提示词。

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 & 定价

Tier	Description	Elapsed Time	Charge
`basic`	Basic tier: 较低的思考强度和较快的生成速度。	3 minutes	`0.5 credits`
`standard`	Standard tier: 平衡的思考强度和生成速度。适用于大多数一般用途。	5 minutes	`1.0 credits`
`pro`	Pro tier: 较强的思考强度和较慢的生成速度。适用于复杂任务和更好的结果。	10 minutes	`2.0 credits`

响应与生命周期

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

用 job.subscription_key 检查状态，用 uuid 下载结果。