Tripo-P1.0 多图生 3D 模型（2 张图）API 使用文档
基于 Tripo Professional 1.0 模型的多图生 3D 接口，通过 /v1/responses 端点以异步任务方式调用。固定接收 4 个视角的图像数组（前、左、后、右），不需要的视角传入空对象 {} 即可，实际有效图片数量支持 2~4 张；本示例演示「前 + 后」两张图（左、右传空对象）的双视角生成场景。模型最高输出 2 万面 3D 网格，支持 PBR 材质与可选高清贴图（detailed），适合电商商品、卡通角色、工业件等需要从有限视角快速重建 3D 模型的应用。
接口地址
| 接口 | 请求方式 | URL |
|---|---|---|
| 提交任务 | POST | https://www.dmxapi.cn/v1/responses |
| 获取结果 | POST | https://www.dmxapi.cn/v1/responses |
WARNING
请妥善保管您的 API Key！严禁将密钥泄露给他人、硬编码到代码中或提交到公开的代码仓库。如果怀疑密钥已泄露，请立即前往 DMXAPI 官网重新生成。
模型名称
Tripo-P1.0
多图生 3D 模型（2 张图）示例代码
python
import requests
import json
# ===============================================================
# 步骤1: 配置 API 连接信息
# ===============================================================
# DMXAPI 服务端点地址
url = "https://www.dmxapi.cn/v1/responses"
# DMXAPI 密钥 (请替换为您自己的密钥)
# 获取方式: 登录 DMXAPI 官网 -> 个人中心 -> API 密钥管理
api_key = "sk-***********************************************"
# ===============================================================
# 步骤2: 配置请求头
# ===============================================================
headers = {
"Content-Type": "application/json", # 指定请求体为 JSON 格式
"Authorization": f"{api_key}", # token 认证方式
}
# ===============================================================
# 步骤3: 配置请求参数
# ===============================================================
payload = {
# 【model】(string, 必填) 调用的模型名称
"model": "Tripo-P1.0",
# 【input】(object, 必填) 输入信息
# prompt / image / images 三者互斥，仅能选择其中一种输入方式，同时传入多个将会报错
# 多图生 3D 场景固定使用 images 字段
"input": {
# 【images】(array[object], 条件必填) 多张图像的对象列表
# 仅在多图生 3D 模型时必填
# 数组长度固定为 4，对应图片顺序为：前、左、后、右
# 不需要传入图片的视角填入空对象 {} 即可，实际有效图片数量为 2~4 张
# 多张图像的分辨率和宽高比不要求一致；每张图像限制：
# - 格式: JPEG、PNG
# - 分辨率: 宽和高范围 [20, 6000] 像素，建议边长 > 256 像素
# - 文件大小: ≤ 20MB
# 每个图像对象包含两个字段:
# - type (string) 图像格式，可选值: "jpeg" / "png"
# - file_token(string) 图像的公网 URL，支持 HTTP / HTTPS 协议
# 本示例传入"前 + 后"两个视角，左、右视角传入空对象 {}
"images": [
{"type": "png", "file_token": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/liafix/tripo-images-1.png"}, # 前
{}, # 左视角不传入图像
{"type": "png", "file_token": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/zjqhyn/tripo-images-3.png"}, # 后
{}, # 右视角不传入图像
]
},
# 【parameters】(object, 可选) 3D 模型生成参数
"parameters": {
# 【texture_quality】(string, 可选) 贴图质量
# 贴图是覆盖在 3D 模型表面的纹理图像，决定模型的外观细节和视觉效果
# 可选值:
# - "standard"(默认值，标清贴图)
# - "detailed"(高清贴图)
"texture_quality": "standard"
},
}
# ===============================================================
# 步骤4: 发送请求并输出结果
# ===============================================================
# 发送 POST 请求到 API 服务器
response = requests.post(url, headers=headers, json=payload)
# 格式化输出 JSON 响应
# - indent=2: 缩进 2 空格，便于阅读
# - ensure_ascii=False: 正确显示中文字符
print(json.dumps(response.json(), indent=2, ensure_ascii=False))返回示例
json
{
"request_id": "56011a61-813d-9041-9bda-e1b9ff06d75e",
"output": [
{
"type": "message",
"content": [
{
"type": "output_text",
"text": "{\"task_id\":\"3d520b47-2364-4d3d-9934-de6198c954ea\",\"task_status\":\"PENDING\"}"
}
]
}
],
"usage": {
"total_tokens": 35000,
"input_tokens": 0,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens": 35000,
"output_tokens_details": {
"reasoning_tokens": 0
}
}
}获取生成模型 示例代码
python
"""
╔═══════════════════════════════════════════════════════════════╗
║ DMXAPI 自研接口 ║
╚═══════════════════════════════════════════════════════════════╝
📝 功能说明:
本脚本演示如何使用 requests 库调用 DMXAPI 的自研接口
═══════════════════════════════════════════════════════════════
"""
import requests
import json
# ═══════════════════════════════════════════════════════════════
# 🔑 步骤1: 配置 API 连接信息
# ═══════════════════════════════════════════════════════════════
# 🌐 DMXAPI 服务端点地址
url = "https://www.dmxapi.cn/v1/responses"
# 🔐 DMXAPI 密钥 (请替换为您自己的密钥)
# 获取方式: 登录 DMXAPI 官网 -> 个人中心 -> API 密钥管理
api_key = "sk-***********************************************"
# ═══════════════════════════════════════════════════════════════
# 📋 步骤2: 配置请求头
# ═══════════════════════════════════════════════════════════════
headers = {
"Content-Type": "application/json", # 指定请求体为 JSON 格式
"Authorization": f"{api_key}", # token 认证方式
}
# ═══════════════════════════════════════════════════════════════
# 💬 步骤3: 配置请求参数
# ═══════════════════════════════════════════════════════════════
payload = {
"model": "Tripo-P1.0-get",
"input": "83357750-efae-452f-9dfd-8dddf906df4e"
}
# ═══════════════════════════════════════════════════════════════
# 📤 步骤4: 发送请求并输出结果
# ═══════════════════════════════════════════════════════════════
# 发送 POST 请求到 API 服务器
response = requests.post(url, headers=headers, json=payload)
# 格式化输出 JSON 响应
# - indent=2: 缩进 2 空格，便于阅读
# - ensure_ascii=False: 正确显示中文字符
print(json.dumps(response.json(), indent=2, ensure_ascii=False))返回示例
json
{
"request_id": "47fe482e-acb2-9e41-8bac-d1017ca068ea",
"output": [
{
"type": "message",
"content": [
{
"type": "output_text",
"text": "{\"task_id\":\"a57f88ad-5ada-4257-b8bd-163d31337db4\",\"task_status\":\"SUCCEEDED\",\"submit_time\":\"2026-05-28 23:13:55.082\",\"scheduled_time\":\"2026-05-28 23:13:55.111\",\"end_time\":\"2026-05-28 23:15:13.369\",\"results\":[{\"pbr_model_url\":\"https://openapi.cdn.tripo3d.com/tcli_6ec7f9db277c4bca984cf4ee598502c1/20260528/f830f982-3ad5-4d1a-a062-02f57ecdd609/tripo_pbr_model_f830f982-3ad5-4d1a-a062-02f57ecdd609.glb?auth_key=1779988512-IUSzc8lR-0-1f19a2b6a2b0038a9d24fc02c09422b4\",\"rendered_image_url\":\"https://openapi.cdn.tripo3d.com/tcli_6ec7f9db277c4bca984cf4ee598502c1/20260528/f830f982-3ad5-4d1a-a062-02f57ecdd609/legacy_mesh.webp?auth_key=1779988512-lHDHysK4-0-6dd610c8ab8ee02450d75550bd7ffa8e\"}]}"
}
]
}
],
"usage": {
"total_tokens": 0,
"input_tokens": 0,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens": 0,
"output_tokens_details": {
"reasoning_tokens": 0
}
}
}© 2026 DMXAPI Tripo-P1.0 多图生 3D 模型（2 张图）