POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks
本文介绍创建 3D 生成任务 API 的输入输出参数，供您使用接口时查阅字段含义。模型会依据传入的图片信息生成 3D，待生成完成后，您可以按条件查询任务并获取生成的 3D 文件。
模型能力
- doubao-seed3d
doubao-seed3d-2-0-260328：图生 3D，根据您输入图片（1 张）+ 参数（可选）生成一个带纹理和 PBR 材质的 3D 文件。
参数传入方式说明
弱校验方式：在文本提示词后追加参数
{
"model": "doubao-seed3d-2-0-260328",
"content": [
{
"type": "text",
"text": "--subdivisionlevel medium --fileformat obj"
},
{
"type": "image_url",
"image_url": {
"url": "<IMAGE_URL>"
}
}
]
}
鉴权#
本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。
- API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
请求参数#
Body 参数#
model string 必选 | 模型 ID
您需要调用的模型的 ID（Model ID）。开通模型服务 后可 查询 Model ID。
您也可通过 Endpoint ID 来调用模型，获得限流、计费类型（前付费 / 后付费）、运行状态查询、监控、安全等高级能力，可参考 获取 Endpoint ID。
content object[] 必选 | 输入内容列表
输入给模型生成 3D 内容的信息，支持文本、图片等类型的元素。
支持以下几种组合：
- 纯文本
- 文本（可选）+ 图片
文本信息 object
文本部分，作为生成内容的文本提示词。
text string 必选 | 文本提示词
content.text
输入给模型的文本提示词，描述期望生成的 3D 内容。
type string 必选 | 内容类型
content.type
输入内容的类型，此处固定为 text。
图片信息 object
输入给模型的图片信息。
image_url object 必选 | 图片对象
content.image_url
输入给模型的图片对象。
url string 必选 | 图片来源
content.image_url.url
图片 URL、图片 Base64 编码。
- 图片 URL：填入图片的公网 URL。
- Base64 编码：将本地文件转换为 Base64 编码字符串后提交给大模型，遵循格式
data:image/<图片格式>;base64,<Base64 编码>，注意<图片格式>需小写，如data:image/png;base64,{base64_image}。
type string 必选 | 内容类型
content.type
输入内容的类型，此处固定为 image_url。
file_format string 默认值 glb | 输出文件格式
生成的 3D 文件格式。可选值：glb、obj、usd、usdz。
subdivision_level string 默认值 medium | 多边形面数
3D 文件中多边形面的数量。可选值：
high：1000000medium：500000low：100000。
响应参数#
id string | 任务 ID
3D 生成任务 ID。仅保存 7 天（从 created_at 时间戳开始计算），超时后将自动清除。
创建 3D 生成任务为异步接口，获取 ID 后需要通过 查询 3D 生成任务 API 来查询任务状态。任务成功后会输出生成 3D 内容的 file_url。