快速开始

快速开始

API

MCP 服务
API 概览认证可用模型

指南

快速开始任务与轮询错误处理

计费与限制

定价与积分速率限制

集成

OpenAPI 规范与 SDK
API

认证

如何使用 API 密钥进行认证

认证

3D 模型生成器 API 使用 API 密钥 进行认证。API 密钥是用户级别的,继承您账户的积分余额和订阅等级。

API 密钥格式

所有 API 密钥均以 tr_ 前缀开头:

tr_a1b2c3d4e5f6...

API 密钥在创建时 仅显示一次。请妥善保存。如果丢失,必须创建新密钥。

创建 API 密钥

  1. 进入 设置 → API 密钥
  2. 点击 创建密钥
  3. 输入描述性名称(例如"生产环境应用")
  4. 立即复制生成的密钥 — 它不会再次显示

使用 API 密钥

在 Authorization 请求头中通过 Bearer token 传递您的 API 密钥:

curl https://trellis2.app/api/v1/models \
  -H "Authorization: Bearer tr_your_key_here"

速率限制

每个 API 密钥都有内置的速率限制:

等级速率限制
免费版5 次请求/分钟
专业版20 次请求/分钟
企业版无限制

当被限流时,API 将返回 429 状态码:

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error"
  }
}

删除密钥

您可以随时在 设置 → API 密钥 中删除 API 密钥。已删除的密钥将立即失效。

删除密钥不会取消正在进行的任务。它们将继续执行至完成。

API 概览

3D 模型生成器 API — 通过编程方式实现图片转 3D 模型

可用模型

通过 API 可用的 3D 生成模型

目录

认证
API 密钥格式
创建 API 密钥
使用 API 密钥
速率限制
删除密钥