Tripo -- 3D 生成

POST

/services/aigc/video-generation/3d-generation

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/3d-generation' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "Tripo/Tripo-P1.0",
  "input": {
    "prompt": "一只可爱的猫"
  },
  "parameters": {
    "texture_quality": "standard"
  }
}'

{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  }
}

Tripo 3D 生成模型支持文生 3D、单图生 3D 和多图生 3D。

前提条件

前往模型广场，搜索"Tripo"，找到 Tripo 模型卡片，单击立即开通。
获取 API Key。

常见问题

Tripo 模型版本如何与官方 API 对应？

千问云提供的 Tripo 模型与 Tripo 官方 API 版本的对应关系如下：

千问云模型名称	对应 Tripo 官方 API 版本
`Tripo/Tripo-H3.1`	`v3.1-20260211`
`Tripo/Tripo-P1.0`	`P1-20260311`

如果您之前使用 Tripo 官方 API，迁移到千问云时，只需将官方 API 的版本号替换为对应的千问云模型名称即可。例如：

官方 API 使用 v3.1-20260211 → 千问云使用 Tripo/Tripo-H3.1
官方 API 使用 P1-20260311 → 千问云使用 Tripo/Tripo-P1.0

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

enum<string>

必填

必须设置为 enable，表示异步提交任务。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称。可选值：

Tripo/Tripo-H3.1：高精度 3D 模型生成，输出产物最高 200 万面。对应 Tripo 官方 API 版本 v3.1-20260211。
Tripo/Tripo-P1.0：专业 3D 模型生成，输出产物最高 2 万面，速度更快。对应 Tripo 官方 API 版本 P1-20260311。

可选值：Tripo/Tripo-H3.1,Tripo/Tripo-P1.0

示例:Tripo/Tripo-P1.0

object

必填

输入信息。prompt、image、images 三者互斥，仅能选择其中一种输入方式。同时传入多个将会报错。

显示子属性

string

文本提示词，用于描述期望生成的 3D 模型。仅在文生 3D 模型时必填。支持多语言（中文、英文等），每个字符均计为 1 个字符，最大长度 1024 个字符。

示例:一只可爱的猫

string

单张图像的 URL。仅在单图生 3D 模型时必填。格式：JPEG、PNG。分辨率：宽和高的范围为 [20, 6000] 像素，建议边长大于 256 像素。文件大小：不超过 20 MB。支持 HTTP 和 HTTPS 协议。

string[]

多张图像的 URL 列表。仅在多图生 3D 模型时必填。图像数量为 2~4 张。每张图像的限制与 image 参数相同。多张图像的分辨率和宽高比不要求一致。

取值范围：items: 2–4

object

3D 模型生成参数。

显示子属性

enum<string>

默认值"standard"

贴图质量。贴图是覆盖在 3D 模型表面的纹理图像，决定了模型的外观细节和视觉效果。可选值：

standard（默认）：标清贴图。
detailed：高清贴图。

可选值：standard,detailed

enum<string>

默认值"standard"

几何精度。仅 Tripo/Tripo-H3.1 支持。可选值：

standard（默认）：标准版，生成的 3D 模型最高 150 万面。
ultra：超清版，生成的 3D 模型最高 200 万面。

可选值：standard,ultra

boolean

默认值true

是否生成 PBR 材质模型。默认值：true。当 pbr 为 true 时，会强制启用贴图（即 texture 也会被设为 true），返回结果中包含 pbr_model_url。

boolean

默认值true

是否生成贴图。默认值：true。如需生成无贴图模型，需同时设置 texture 和 pbr 为 false，返回结果中包含 base_model_url。

响应

200-application/json

string

请求唯一标识，用于链路追踪和问题排查。

示例:4909100c-7b5a-9f92-bfe5-xxxxxx

object

显示子属性

string

任务 ID，用于后续轮询查询任务状态。配合 GET /tasks/{task_id} 使用。

示例:0385dc79-5ff8-4d82-bcb6-xxxxxx

enum<string>

初始任务状态，通常为 PENDING。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED

​前提条件

​常见问题

​Tripo 模型版本如何与官方 API 对应？

鉴权

Header 参数

请求体

响应

前提条件

常见问题

Tripo 模型版本如何与官方 API 对应？