公开 API 文档
鉴权方式:`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:服务内部错误