API 规范
Rodin Agentic
通过 Rodin Agentic 从图片生成 3D 资产。
实验性功能
该功能目前为beta测试版本。 Rodin Agentic 使用 AI 选择最合适的生成模式，因此结果可能会携带一些不确定性。
POST
bearerheader
AuthorizationBearer <token>multipart/form-data- body
images*array<>一到五张参考图片，每张最大 25 MiB。
prompt?string可选。若省略或为空，服务会根据图片生成提示词。
Length
length <= 1024Default
""tier?string可选。生成档位： - `basic`: 基础档位，仅支持有限的功能。 - `standard`: 标准档位，支持更多功能。 - `pro`: Pro 档位，支持所有功能。
Default
"standard"Value in
"basic""standard""pro"export_type?string可选。最终导出格式：`glb`（默认）、`usdz`、`fbx`、`stl`。
Default
"glb"Value in
"glb""usdz""fbx""stl"application/json- response
uuid*string提交的生成任务的唯一标识符。
Format
uuidjob*一个包含生成过程中执行的各个任务详细信息的工作对象。
producer*string生成资产的生产管线：`high-poly` 或 `n-gons`。 - `high-poly` 表示 Rodin 路径。 - `n-gons` 表示 agentic 路径。
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"}输入
提交一到五张参考图片 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 下载结果。