Tripo H3.1 API：价格、参数与代码

Name: Tripo H3.1 API
SKU: tripo/h3.1/image-to-3d
Price: 0.432 USD
Availability: InStock

关于 Tripo H3.1

一张产品照出结构准、颜色真的 3D 模型。

在 POST /jobs/createTask 里把模型名写成 tripo/h3.1/image-to-3d 即可调用，US$0.432 起。

简介

Tripo H3.1 是 Tripo AI 于 2026 年 3 月推出的图生 3D 模型，面向可直接投入生产的资产，相比此前的 H 系列模型，几何更锐利、与输入图片的对齐更准确，贴图质量也更高。你发送一张图片（image_url），返回一个二进制 glTF 文件（.glb）。与只有单一开关的转换工具不同，流水线的每个阶段都可以控制：是否为网格生成贴图、是否加入 PBR 贴图、高清贴图、精细几何、四边面拓扑、目标面数、真实尺寸缩放、最终朝向，以及两个独立的 seed。没有提示词。

主要特点

形状忠于图片

在我们的靴子测试中，模型保持了照片的比例，并把后跟环、鞋带挂钩和鞋底花纹放到了正确的一侧，尽管照片只拍到了正面。带贴图的结果把磨损的皮革、红色鞋带和缝线都带到了网格上。

贴图可开关、可升级

贴图默认开启，并以完整的 PBR 套件输出。我们的默认设置文件在一个材质中包含 2048 像素的基础色贴图、金属粗糙度贴图和法线贴图。

拓扑与尺寸由你掌控

face_limit 可把面数限制在 1,000 到 2,000,000 之间，quad_mesh 切换为四边面，便于在建模软件中编辑，geometry_quality: detailed 会在精细的表面细节上投入更多计算。auto_size 把网格缩放到真实尺寸，model_orientation: align_image 让网格朝向与图片一致。

我们的实测

使用默认设置时，一张 1024×1024 的皮靴正面图在 167 秒后返回一个 45.8 MB 的 GLB 文件，包含 1,471,382 个三角面和三张贴图。面数如此密集，所以任何要在浏览器中展示的内容都应设置 face_limit。

请求参数

参数	必填	说明
`auto_size`	否	将网格缩放到估算的真实尺寸。默认关闭。默认值: false
`face_limit`	否	目标面数，1,000 到 2,000,000。留空则由模型决定（常超过一百万面）。不影响价格。 ≥ 1000 · ≤ 2000000
`generate_pbr`	否	添加 PBR 材质贴图（金属-粗糙度与法线）。默认开启，并会同时打开贴图。默认值: true
`generate_texture`	否	给网格绘制贴图。默认开启；关闭后，只有 generate_pbr 也关着时才会真正去掉贴图。默认值: true
`geometry_quality`	否	几何细节：standard（默认）或 detailed。detailed 会刻画更细的表面细节，价格更高。 standard · detailed · 默认值: standard
`image_url`	是	作为起点的那张图。
`model_orientation`	否	default 保持标准朝向；align_image 把模型旋转到与图片一致。 default · align_image · 默认值: default
`quad_mesh`	否	返回四边面（quad）而非三角面，方便在建模软件里编辑；此时文件以 FBX 而非 GLB 返回。默认关闭，会增加价格。默认值: false
`seed`	否	使用相同的种子值和参数，更便于在一致条件下比较结果。 ≥ 0 · ≤ 2147483647
`texture_alignment`	否	贴图对齐到原图（默认）或生成的几何体。 original_image · geometry · 默认值: original_image
`texture_quality`	否	贴图分辨率：standard（默认）或 detailed。detailed 更贵，且只对带贴图的网格生效。 standard · detailed · 默认值: standard
`texture_seed`	否	贴图步骤使用的种子。保持 seed 不变、改这个值，可以在同一形状上试不同贴图。 ≥ 0 · ≤ 2147483647

价格

价格以美元计。API 使用独立的美元余额。网站积分不能用于 API，也不能转入 API 余额；API 余额同样不能转为网站积分。任务受理时，从 API 余额中冻结报价的最高金额；完成后按实际用量结算，实扣不超过冻结额，并释放剩余金额。任务失败则释放冻结额。

选项	USD /次
标准	US$0.432

运行前，将相同请求体发送到 POST /jobs/quote，可查看预计费用和最高费用，单位为美元。报价不会运行任务或扣款。

适用场景

游戏、AR 与实时场景资产

把 face_limit 设为场景的预算；若资产之后还要编辑，开启 quad_mesh；保持 PBR 开启，让模型能响应场景光线。

产品可视化与打印

用于产品查看器时，保持贴图开启，并在标签或缝线需要清晰可读时使用 texture_quality: detailed。用于 3D 打印或雕塑时，关闭两个贴图开关，并设置 auto_size，让网格以真实比例输出。

提示词指南与进阶技巧

从干净的图片开始

一个主体、完整入框、纯色背景。四分之三视角比正面平视图更能告诉模型深度信息。接受 JPEG、PNG 或 WebP，不超过 10 MB。

只开启需要的功能

先用默认设置加上 face_limit 跑一遍，再只升级未达标的那个阶段。

用两个 seed 迭代

seed 固定几何，texture_seed 固定贴图。保持 seed 不变、修改 texture_seed，可以在同一形状上尝试新的表面；保持 texture_seed 不变，则可以探索不同的形状。

检查被遮挡的一面

使用前，在查看器中打开 GLB 并完整旋转一圈。如果看不见的一面不对，换一个源图片的拍摄角度，比调任何参数都更有效。

API 快速上手

三步调用 Tripo H3.1 API

创建 API 密钥. 登录 PopNow，在 API 控制台创建密钥。密钥以 sk-popnow- 开头，API 调用使用独立的美元余额。
发送请求. 向 POST /jobs/createTask 发请求，model 填 tripo/h3.1/image-to-3d，input 按参数表填写。响应会立刻返回任务 ID。
取回结果. 用任务 ID 轮询 GET /jobs/recordInfo，或者传 callBackUrl，结果会推送到这个地址。任务成功后下载输出链接。

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "tripo/h3.1/image-to-3d",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "generate_texture": true,
    "generate_pbr": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "model_orientation": "default"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

请替换为自己的提示词与素材链接。响应格式、轮询与回调说明请参阅 API 页签。

Tripo H3.1 API 常见问题

Tripo H3.1 API 怎么收费？

Tripo H3.1：US$0.432/次。API 使用独立的美元余额。网站积分不能用于 API，也不能转入 API 余额；API 余额同样不能转为网站积分。任务受理时，从 API 余额中冻结报价的最高金额；完成后按实际用量结算，实扣不超过冻结额，并释放剩余金额。任务失败则释放冻结额。

Tripo H3.1 在 API 里的调用名是什么？

在 POST /jobs/createTask 的 model 字段里填图片转 3D用 tripo/h3.1/image-to-3d。

Tripo H3.1 API 有哪些限制？

单个文件大小上限：10 MB。超出这些限制的请求会在扣费之前被拒绝。

不写代码能试 Tripo H3.1 吗？

无需 API 密钥，即可在 Playground 用 API 美元余额运行 Tripo H3.1。每次运行记入开发者历史，并附对应代码。

关于 Tripo H3.1 的更多内容

试用: Tripo H3.1 AI 生图在线使用在 PopNow 用 Tripo H3.1 生成图片
文档: API 文档里的 Tripo H3.1 模型名与输入格式 PopNow API 快速上手：发送第一个请求 PopNow API 图片生成指南 Webhook：不轮询也能拿到 Tripo H3.1 的结果