ModelSell 文档
3D 系列Tripo

Tripo 3D 生成

Tripo-P1.0 与 Tripo-H3.1 的文生、单图和多视角 3D 异步接口。

使用 ModelSell API Key 调用以下接口,任务 ID 使用平台返回的 output.task_id。

操作接口
创建POST /api/v1/services/aigc/video-generation/3d-generation
查询GET /api/v1/tasks/{task_id}
模型Tripo/Tripo-P1.0、Tripo/Tripo-H3.1

创建与查询

curl "$MODELSELL_BASE_URL/api/v1/services/aigc/video-generation/3d-generation" \
  -H "Authorization: Bearer $MODELSELL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"Tripo/Tripo-P1.0","input":{"prompt":"A small ceramic fox"},"parameters":{"texture_quality":"standard"}}'

curl "$MODELSELL_BASE_URL/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $MODELSELL_API_KEY"

平台自动添加上游所需的异步请求头。输入只选 input.prompt、input.image、input.images 之一。多视角图片按前、左、后、右四个位置排列,缺失位置保留 {}:

{"images":[{"type":"png","file_token":"https://example.com/front.png"},{},{"type":"png","file_token":"https://example.com/back.png"},{}]}

texture_quality 支持 standard、detailed;H3.1 另支持 geometry_quality: standard | ultra。无贴图生成需同时传 texture: false 和 pbr: false。

查询 output.task_status:PENDING、RUNNING 继续轮询,SUCCEEDED 读取 output.results 中的 pbr_model_url 或 base_model_url 下载 GLB。失败时读取 code、message。预览图片不是 3D 文件。

来源

接口参数核对于 2026-10-04:百炼 Tripo 官方 API。平台任务 ID 与上游 ID 的转换以 ModelSell 网关实现为准。

On this page