Skip to main content
Seed3D 1.0 是基于 Diffusion Transformer(DiT)架构实现的 3D 生成模型,能够在几分钟内输出包含多边形面片与 PBR 材质的高精度资产,其生成结果具备边缘锐利清晰、薄面结构稳定不变形的特征,所有几何细节在 6K 分辨率下仍保持清晰可见,能够满足不同领域对高精度 3D资产的需求。

模型参数

不支持3D生成 API 中的以下参数:
  • multi_view_images
  • result_format
  • enable_pbr
附:Seed3D 1.0 官方 API 文档
Doubao-Seed3d-1.0 官方 API 参数与极客智坊3D API 参数差异较大,下面是如何通过极客智坊视频 API 调用 Doubao-Seed3d-1.0 的说明: 通过3D生成 API 的 prompt + image 传值,极客智坊会自动将其组装为 doubao-seed3d-1.0 的 content 参数传递到豆包官方 API:
  • prompt:文本提示,可选参数
  • image:目前仅支持单张参考图传入,必填参数,所有图片均支持传入图片 URL 或者 Base64 编码的图片数据
对于其他模型参数,你可以按照官方 API 文档中介绍的那样通过在文本提示词后追加 --[parameters] ,控制3D内容输出的规格,包括文件格式、多边形面的数量等:
其中 subdivisionlevel 和 fileformat 是 Doubao-Seed3d-1.0 模型特有的参数,具体含义如下:
  • subdivisionlevel:3D文件中多边形面的数量,目前仅支持默认值 medium,表示中等面数100000面
  • fileformat:输出3D文件格式,支持 glb 、obj、usd、usdz,默认值为 glb

图生 3D

Seed3D 1.0 是一个图生3D模型,仅支持通过文字描述+参考图(1张)来生成对应3D资产:

生成结果

生成成功后,返回结果中 data 字段包含3D资产的下载链接:

异步任务

对于3D生成任务,由于生成时间较长,建议使用异步任务接口进行调用。 3D生成 API 中的 async 参数用于控制是否异步生成3D,默认为 false,表示创建3D生成接口会同步等待3D资产生成完毕并返回。如果设置为 true,则会异步生成3D资产并返回任务ID,你可以使用该任务ID轮询3D资产生成状态:
响应中会包含任务ID:
你可以使用返回的任务 ID 来查询生成状态和获取3D资产结果:
注意将 {task_id} 替换为实际的任务 ID。 你可以根据3D生成任务状态 task_status 值判断3D资产是否已经生成完成,这个状态值包括四种情况:
  • pending:任务已创建,在队列中等待处理
  • running:任务正在处理
  • succeed:任务成功完成,可以获取结果
  • failed:任务处理失败
如果任务还在运行中,返回结果如下:
如果任务执行成功,则响应和同步模式的3D生成接口响应格式相同:
你可以通过 data 字段中的 URL 下载生成的 3D 资产文件。