POST /v1/3d/generations 会返回任务 ID 和 poll_url,完成后可以从 model_url 等地址下载。
选择输入类型
这个 API 不使用
operation。模型标有 text-to-3d 时可以接收提示词,标有 image-to-3d 时可以接收图片。
image、image_url、format、quality、style 或 seed 前,请查看模型详情。
创建 3D 任务
https 地址即可。图片不能公开访问时,可以用内联 base64 image,但服务端必须能接收更大的请求体。
输出格式
glb适合网页预览。fbx和obj常用于 DCC 工具,前提是模型支持。usdz可用于 Apple AR,前提是模型支持。- 更高的
quality可能等待更久、费用更高,应当让用户自己选择。 - 只有模型支持时,
seed才能影响结果的可重复性。
获取生成结果
使用创建响应中的poll_url 查询。客户端需要固定地址时,可以调用 GET /v1/tasks/{id}。
model_url,也可能包含 glb_url、fbx_url、obj_url 或 usdz_url。如果产品需要长期下载或版本历史,请把文件保存到自己的存储中。
让结果可以长期访问
- 保存
task_id、poll_url、模型、输出格式和你自己的文件 ID。 - 页面刷新后继续查询原任务,不要重新创建。
- 提交前确认源图片大小合适、URL 可以访问。
- 文件地址不能展示给无权访问的用户。
- 返回
billing_transaction_id时一并保存,方便核对费用。