Tracy Draw Developer API

图片生成 API

通过一个异步任务接口调用 Tracy Draw 的 GPT-Image-2 生图能力，并使用同一账户积分结算。

管理 API Key 下载 OpenAPI JSON

快速开始

使用 Bearer API Key 鉴权。发起生成后轮询任务接口，直到任务进入 succeeded、partially_succeeded 或 failed 状态。

基础地址https://api.leolovetracy.com/v1
bash
curl https://api.leolovetracy.com/v1/images/generations \
  -H "Authorization: Bearer td_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: generation-20260729-001" \
  -d '{"model":"gpt-image-2","prompt":"A quiet reading room","n":1,"size":"1:1"}'

鉴权

在每个请求中发送 Authorization: Bearer td_live_...。密钥被撤销或过期后立即失效，请只在服务端保存和使用。

http
Authorization: Bearer td_live_YOUR_API_KEY

幂等性

Idempotency-Key 为必填请求头。同一个 Key 与相同请求体重复提交会返回同一任务；若请求体不同则返回 409。

POST/v1/images/generations

发起生图

n 默认 1，最大 9。image_urls 可传最多 5 个公开 HTTPS 图片地址，不支持 localhost、内网地址或带凭据的 URL。

请求示例

bash
curl https://api.leolovetracy.com/v1/images/generations \
  -H "Authorization: Bearer td_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: generation-20260729-001" \
  -d '{"model":"gpt-image-2","prompt":"A quiet reading room","n":1,"size":"1:1"}'

响应示例

json
{
  "ok": true,
  "data": {
    "task_id": "task_q1w2e3...",
    "object": "image.generation.task",
    "status": "queued",
    "model": "gpt-image-2",
    "n": 1,
    "size": "1:1",
    "credits_reserved": 20,
    "results_expires_at": "2026-08-01T08:00:00.000Z",
    "items": []
  }
}
GET/v1/tasks/{task_id}

查询结果

建议每 2 至 5 秒查询一次。任何属于同一用户的有效 API Key 都可以查询该用户通过 API 创建的任务。

请求示例

bash
curl https://api.leolovetracy.com/v1/tasks/task_q1w2e3... \
  -H "Authorization: Bearer td_live_YOUR_API_KEY"

响应示例

json
{
  "ok": true,
  "data": {
    "task_id": "task_q1w2e3...",
    "status": "succeeded",
    "items": [{
      "item_id": "task_q1w2e3..._1",
      "status": "succeeded",
      "image_url": "https://cdn.example.com/result.png",
      "error": null
    }]
  }
}
GET/v1/models

模型能力

查询当前模型、支持画幅、单次最大图片数和参考图数量。

请求示例

bash
curl https://api.leolovetracy.com/v1/models \
  -H "Authorization: Bearer td_live_YOUR_API_KEY"

响应示例

json
{
  "ok": true,
  "data": { "list": [{
    "id": "gpt-image-2",
    "sizes": ["1:1", "4:3", "3:4", "1:2", "16:9", "9:16"],
    "max_images": 9,
    "max_reference_images": 5
  }] }
}
GET/v1/credits

积分与价格

查询余额以及当前用户角色优惠后的实际单张价格。API 与网页共用积分、角色价格和失败图片退款规则。

请求示例

bash
curl https://api.leolovetracy.com/v1/credits \
  -H "Authorization: Bearer td_live_YOUR_API_KEY"

响应示例

json
{
  "ok": true,
  "data": {
    "balance": 980,
    "model": "gpt-image-2",
    "standard_unit_credits": 20,
    "actual_unit_credits": 16
  }
}

结果保留

返回的图片 URL 保证至少可访问 72 小时。请在有效期内下载并保存到自己的存储。

状态码

400参数或请求头不合法
401API Key 无效、已撤销或已过期
402积分不足
404任务不存在或不属于当前用户
409幂等键冲突或请求正在处理中
500服务内部错误

V1 暂不设置频率或并发限制；平台会根据运行情况调整并提前更新文档。