认证

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

API 密钥格式

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

tr_a1b2c3d4e5f6...

创建 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 密钥都有内置的速率限制：

当被限流时，API 将返回 429 状态码：

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

删除密钥

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