单图生 3D 模型

POST

/domi/providers/tripo/v3/generation/image-to-model

Tripo v3 原协议透明转发。请求 Authorization 使用 NewAPI AK，网关替换为 Tripo 凭证。
JSON/multipart、路径、查询串以及 Tripo 的 code/data/message 响应均保持原协议。
创建类接口返回 Tripo task_id 后，使用任务查询接口轮询。

当前网关配置支持的模型：v3.1-20260211；请求 model 填写该版本。列表依据 sql/ai_async_task.sql，实际可用性取决于部署环境启用配置及 NewAPI 授权。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

{
    "input": "https://example.com/chair.png",
    "model": "v3.1-20260211",
    "texture": true,
    "pbr": true,
    "face_limit": 10000
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway.domi-kids.com/domi/providers/tripo/v3/generation/image-to-model' \
--header 'domi-ai-metadata;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "input": "https://example.com/chair.png",
    "model": "v3.1-20260211",
    "texture": true,
    "pbr": true,
    "face_limit": 10000
}'

返回响应

🟢200

application/json

Tripo v3 成功响应

Bodyapplication/json

示例

{
    "code": 0,
    "data": {
        "task_id": "task_abc123"
    }
}

🟠400

🟠401

🟠4XX

🔴5XX

修改于 2026-09-16 09:19:31

文生 3D 模型

多视图生 3D 模型