跳转到主要内容
所有3D 模型都通过 POST /api/generate/submit 调用。在 model 中传入 model ID,在 input 中传入该模型的参数,并可选传入 callback_url。请求会立即返回 task_id,任务异步执行。

工作流程

  1. 使用下表中的 model ID 向 POST /api/generate/submit 提交任务。
  2. 使用返回的 task_id 轮询获取任务状态,或在 callback_url 接收结果(参见 Webhook 回调)。
  3. 状态为 finished 时,下载 files 中的文件。
3D 任务可能返回多个文件,例如模型文件、预览图和贴图。请处理 files 数组中的每一项。

模型

注意事项

  • 每个模型页面列出了其 model ID 的参数、限制和模式。各模型之间的参数不通用。
  • 生成的文件在创建后 24 小时内有效,请及时下载并保存。
  • URL 输入必须是可公开访问的 HTTP(S) URL。如需使用本地文件,请先通过文件管理上传。