3D 生成
本文说明火山 Seed3D、Hyper3D、Hitem3D 等 3D 生成模型的异步任务调用方式。
一、3D 生成
适用模型：
doubao-seed3d-2.0
doubao-seed3d-2.0
Hyper3d-Gen2
Hyper3d-Gen2
Hitem3d-2.0
Hitem3d-2.0
3D 生成通常也是异步任务。创建任务后返回任务 ID，待生成完成后查询 3D 文件地址。
请求地址：
POST https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/contents/generations/tasks
文本生成 3D
curl -X POST "$AI_GATEWAY_VOLC_BASE_URL/contents/generations/tasks" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seed3d-2.0",
"content": [
{
"type": "text",
"text": "生成一个低多边形风格的科技感机器人 3D 模型，适合放在数据平台产品页中展示。"
}
]
}'
图片生成 3D
{
"model": "Hyper3d-Gen2",
"content": [
{
"type": "image_url",
"image_url": {
"url": "https://example.com/object.png"
}
}
]
}
3D 生成请求字段
| 字段 | 类型 | 必填 | 说明 |
|---|
model
model | string | 是 | 3D 生成模型名称。 |
content
content | array | 是 | 输入内容。可以是文本、图片或参考素材，取决于模型能力。 |
content[].type
content[].type | string | 是 | 内容类型，例如 text
text 、image_url
image_url 。 |
content[].text
content[].text | string | 条件必填 | 文本描述。 |
content[].image_url.url
content[].image_url.url | string | 条件必填 | 图片 URL。 |
callback_url
callback_url | string | 否 | 异步任务回调地址。是否支持取决于接入点能力。 |
查询 3D 任务
curl -X GET "$AI_GATEWAY_VOLC_BASE_URL/contents/generations/tasks/<TASK_ID>" \
-H "Authorization: Bearer $API_KEY"
成功响应通常包含 3D 文件 URL，例如
glb
glb
、
obj
obj
、
fbx
fbx
或压缩包地址，具体字段以模型返回为准。
注意：
- 火山官方 3D 任务通常仅支持查询最近 7 天的任务记录。
- 生成的 3D 文件 URL 通常会在 24 小时后清理，请及时下载并转存。
- 不同 3D 模型的输入方式和输出文件格式可能不同，接入前建议先用最小示例跑通创建任务和查询任务。
