POST /v1/3d/generations 创建一个TokenLab任务；完成状态响应返回可下载的模型资产，如 model_url，并在可用时返回特定格式的URL。
选择输入类型
在决定要公开哪些选项之前，请查询模型目录：
此 endpoint 使用输入类型而不是
operation 字段。模型 metadata 会以 text-to-3d 和/或 image-to-3d 表示 3D 能力；3d-generation 不是公开请求 operation。
tripo-h3.1 用于高质量文生/图生 3D 流程，tripo-p1.0 用于生产级 3D 资产生成。请用 Models API 确认所选模型支持你的输入类型和输出格式。
不要假设每个3D模型都支持两种输入类型或每种输出格式。在发送 image, image_url, format, quality, style 或 seed 之前，请检查所选模型详情。
创建3D任务
image_url。仅在您的客户端故意发送私有媒体且您的后端准备好处理更大的请求体时，才使用内联/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（如果存在）以便后续对账。