Tripo3D P1 Image to 3D API
tripo3d/p1/image-to-3dTripo3D P1 Image to 3D 将单张物体图片生成清晰的低面数三维模型,支持设置目标面数、纹理和几何种子。参考图中的可见轮廓为造型提供依据,你可以配置网格预算并旋转检查结果。
输入
拖拽文件、粘贴剪贴板素材,或输入 URL。 包含一个公开可访问 HTTP(S) 图片地址的数组。
1/1 个素材
目标面数,填写 48 至 20,000 的整数;留空由模型决定。
true 生成纹理;false 生成纯几何模型。
用于复现几何生成的整数种子。对比迭代时保持输入和设置一致。
输出
已完成
Tripo3D P1 Image to 3D API
快速开始
提交请求并获取生成文件。
认证
使用 Vidgo API Key 作为 Bearer 令牌。
- 接口
- POST
https://api.vidgo.ai/api/generate/submit - 认证
- Authorization: Bearer $VIDGO_API_KEY
提交
提交模型 ID 和输入设置。
REQUEST_BODY=$(cat <<'JSON'
{
"model": "tripo3d/p1/image-to-3d",
"input": {
"face_limit": 3000,
"texture": true,
"model_seed": 927201,
"image_urls": [
"https://cdn.vidgo.ai/apis/models/tripo3d/p1/image-to-3d/v1/01/input.png"
]
}
}
JSON
)
RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
CODE=$(printf '%s' "$RESPONSE" | jq -r '.code // empty')
if [ "$CODE" != "0" ] && [ "$CODE" != "200" ]; then
printf 'API error: %s
' "$RESPONSE" >&2
exit 1
fi
printf '%s
' "$RESPONSE"查询任务
使用返回的任务 ID 获取进度。
状态
GET https://api.vidgo.ai/api/generate/status/{task_id}使用 task_id 查询进度和文件。
not_startedrunningfinishedfailed{
"code": 200,
"data": {
"task_id": "CLVWVQ6PG66A0RK7",
"status": "running",
"created_time": "2026-09-27T22:04:54"
}
}{
"code": 200,
"data": {
"task_id": "CLVWVQ6PG66A0RK7",
"status": "finished",
"files": [
{
"file_url": "https://cdn.vidgo.ai/apis/models/tripo3d/p1/image-to-3d/v1/01/00-output.glb",
"file_type": "3d"
},
{
"file_url": "https://cdn.vidgo.ai/apis/models/tripo3d/p1/image-to-3d/v1/01/01-output.png",
"file_type": "image"
}
],
"created_time": "2026-09-27T22:04:54",
"error_message": null,
"progress": 100
}
}使用文件
任务完成后读取 files 数组。
set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"
REQUEST_BODY=$(cat <<'JSON'
{
"model": "tripo3d/p1/image-to-3d",
"input": {
"face_limit": 3000,
"texture": true,
"model_seed": 927201,
"image_urls": [
"https://cdn.vidgo.ai/apis/models/tripo3d/p1/image-to-3d/v1/01/input.png"
]
}
}
JSON
)
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
BUSINESS_CODE=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.code // empty')
if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
printf 'Submit failed:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
if [ -z "$TASK_ID" ]; then
printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
START_TIME=$(date +%s)
POLL_DELAY=2
while true; do
if [ $(( $(date +%s) - START_TIME )) -ge 600 ]; then
printf 'Timed out after 600 seconds
' >&2
exit 1
fi
STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
--url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
--header "Authorization: Bearer $VIDGO_API_KEY")
STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')
BUSINESS_CODE=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.code // empty')
if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
printf 'Status request failed:
%s
' "$STATUS_RESPONSE" >&2
exit 1
fi
case "$STATUS" in
finished)
printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
break
;;
failed)
printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
exit 1
;;
not_started|running)
sleep "$POLL_DELAY"
if [ "$POLL_DELAY" -lt 10 ]; then POLL_DELAY=$((POLL_DELAY + 1)); fi
;;
*)
printf 'Unexpected task status: %s
' "$STATUS" >&2
exit 1
;;
esac
done输入参数
在请求根级设置 model 和可选的 callback_url,将下列字段放入 input。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| image_urls | string[] | 是 | — | 包含一个公开可访问 HTTP(S) 图片地址的数组。 |
| face_limit | integer | 否 | — | 目标面数,填写 48 至 20,000 的整数;留空由模型决定。 |
| texture | boolean | 否 | true | true 生成纹理;false 生成纯几何模型。 |
| model_seed | integer | 否 | — | 用于复现几何生成的整数种子。对比迭代时保持输入和设置一致。 |
响应字段
保存任务 ID 及返回文件的完整元数据。
| 字段 | 类型 | 说明 |
|---|---|---|
| task_id | string | 任务标识。 |
| status | string | 当前任务状态。 |
| files | array | 生成文件列表,包括模型资产与预览图。 |
| files[].file_url | string | 公开文件地址。 |
| files[].file_type | string | 3d / image / other |
| files[].label | string | 资产用途,例如 model_glb 或 thumbnail。 |
| files[].format | string | 返回时提供的文件格式。 |
| files[].file_name | string | 返回时提供的文件名。 |
| files[].file_size | integer | 返回时提供的文件大小,单位为字节。 |
| files[].content_type | string | 返回时提供的 MIME 类型。 |
任务状态
持续查询至 finished 或 failed。
not_started排队中
running生成中
finished已完成
failed生成失败
结果处理
- 查询任务使用返回的 task_id 查询状态,进入终态后结束轮询。
- 完成回调在请求根级设置 callback_url,接收任务完成通知。
- 预览与下载打开 GLB 模型进行交互检查,并保留全部返回文件供下载。
接口规格
| 项目 | 取值 | 说明 |
|---|---|---|
| image_urls | 1 | 包含一个公开可访问 HTTP(S) 图片地址的数组。 |
| face_limit | 48–20000 | 目标面数,填写 48 至 20,000 的整数;留空由模型决定。 |
| texture | true | true 生成纹理;false 生成纯几何模型。 |
| model_seed | integer | 用于复现几何生成的整数种子。对比迭代时保持输入和设置一致。 |
Tripo3D P1 Image to 3D 相关工作流
Tripo3D P1 Image to 3D API 常见问题
Tripo3D P1 Image to 3D API 是什么?
Tripo3D P1 Image to 3D 是 Tripo AI 用于根据单张图片生成三维物体的模型。它以参考图为输入,提供目标面数、纹理选择和几何种子设置,适合道具与产品原型。P1 侧重清晰的轻量网格,可用面数目标控制网格预算,并在相同输入设置下用种子复现几何。你可以通过 API 进行程序化调用,也可以在体验区直接试用。
Tripo3D P1 Image to 3D 适合怎样的物体参考图?
选择一张主体明确、轮廓可见的物体图片;均匀光照有助于展示形状和可见细节。可使用物体照片或概念图作为参考。
Tripo3D P1 Image to 3D 怎样提交单张参考图?
在体验区上传一张图片,或在 Image Urls 中填写一条公开可访问的 HTTP(S) 图片地址。API 请求中的 image_urls 数组包含这一条地址。
Tripo3D P1 Image to 3D 如何设置低面数网格预算?
将 Face Limit 设为 48 至 20,000 的整数,作为生成模型的目标面数。对比不同设置下的轮廓与表面细节,再选择适合参考物体的预算。
Tripo3D P1 Image to 3D 的纹理选择如何影响费用?
Texture 默认开启,每次带纹理生成收取 70 积分($0.350);选择纯几何模型时,每次生成收取 56 积分($0.280)。两档均按一次生成计费。
Tripo3D P1 Image to 3D 如何用种子复现几何?
填写整数 Model Seed,并保存参考图、面数目标和纹理设置。再次使用相同输入与设置时,种子用于复现几何生成。
Tripo3D P1 Image to 3D 适合制作哪些道具原型?
单张物体照片或概念图可用于探索工具、容器、家具等道具的三维造型。设置目标面数后,在预览中检查轮廓与比例。
何时选择 Tripo3D P1 Image to 3D 而不是 Tripo3D P1 Text to 3D?
已有一张物体照片或概念图时,选择 Image to 3D,让参考图为造型提供依据。只有文字构想时,选择 Text to 3D,从提示词生成三维模型。
