API
API 概览
3D 模型生成器 API — 通过编程方式实现图片转 3D 模型
API 概览
3D 模型生成器 API 允许您通过编程方式将图片转换为 3D 模型（GLB 格式）。
核心功能
- 图片转 3D：发送一张或多张图片，获取可下载的 3D 模型
- 多种模型：可选择优化的生成管线（Trellis2、Tripo、Tripo Multi-View）
- 同步与异步：等待结果或自行轮询
- 积分计费：基于积分的透明按量付费
Base URL
https://trellis2.app/api/v1认证
所有请求需要通过 Authorization 请求头中的 Bearer token 携带 API 密钥：
Authorization: Bearer tr_your_api_key_hereAPI 密钥以 tr_ 前缀开头。请在 API 密钥设置 中创建和管理您的密钥。
快速示例
# 创建 3D 生成任务（异步模式）
curl -X POST https://trellis2.app/api/v1/3d/generations \
-H "Authorization: Bearer tr_your_key" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://example.com/chair.jpg",
"model": "trellis2",
"mode": "async"
}'
# 响应：202 Accepted
# {
# "id": "task_abc123",
# "object": "task",
# "status": "pending",
# "created": 1723000000,
# "data": null
# }
# 轮询任务完成状态
curl https://trellis2.app/api/v1/tasks/task_abc123 \
-H "Authorization: Bearer tr_your_key"