鉴权方式：Authorization: Bearer <ACCESS_TOKEN>。以下示例仅展示公开端点。

接口目录

接口说明
POST /api/projects创建项目
GET /api/projects查询项目列表
POST /api/projects/:id/render发起渲染任务
GET /api/projects/:id/jobs查询项目任务
GET /api/jobs/:id查询任务状态
GET /api/billing/wallet查询积分余额

示例 1：创建项目

curl -X POST https://www.aitvmake.com/api/projects \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "我的第一集",
    "styleProfileId": "cn_realistic_drama",
    "contentLanguage": "zh",
    "sourceType": "paste",
    "sourceText": "这里是你的剧情文本..."
  }'
{
  "ok": true,
  "projectId": "proj_xxx",
  "longformSuggestion": {
    "enabled": false,
    "estimatedEpisodes": 0
  }
}

示例 2：发起渲染

curl -X POST https://www.aitvmake.com/api/projects/proj_xxx/render \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ "actorId": "actor_main", "quality": "standard" }'
{
  "ok": true,
  "job_id": "job_xxx"
}

示例 3：查询任务状态

curl https://www.aitvmake.com/api/jobs/job_xxx \
  -H "Authorization: Bearer <ACCESS_TOKEN>"
{
  "ok": true,
  "job": {
    "id": "job_xxx",
    "status": "RENDERING",
    "progress": 55,
    "estimated_points": 120,
    "settled_points": 0,
    "output_url": null
  }
}

错误码约定

  • 400：请求参数错误
  • 401：访问令牌无效或缺失
  • 403：无访问权限
  • 404：资源不存在
  • 409：资源状态冲突（如任务不可重试）
  • 429：请求过于频繁
  • 500：服务内部错误