创建密钥
登录后进入个人中心的 API 密钥页面,创建带有 generation:write 和 assets:read 权限的 Key。完整密钥只展示一次,请妥善保存。
开发者接口
你可以在个人中心创建 API Key,然后用同一个账号余额提交生成任务、查询任务状态、读取生成素材。适合内容后台、批量素材生产、广告投放系统和自动化剪辑流程接入。
curl -X POST http://127.0.0.1:3001/api/generation/tasks \
-H "Authorization: Bearer ak_live_xxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"modelSlug": "mock-video-v1",
"mode": "text-to-video",
"prompt": "一支高端护肤品广告,清晨自然光,镜头缓慢推进,产品水珠清晰可见",
"seconds": 6,
"aspectRatio": "9:16"
}'curl "http://127.0.0.1:3001/api/generation/tasks?status=succeeded&limit=10" \ -H "Authorization: Bearer ak_live_xxxxxxxxx"
curl "http://127.0.0.1:3001/api/assets?type=video&limit=10" \ -H "Authorization: Bearer ak_live_xxxxxxxxx"
| 方法 | 路径 | 用途 | 权限 |
|---|---|---|---|
| POST | /api/generation/tasks | 提交视频生成、图片生成、图生图、图生视频任务 | generation:write |
| GET | /api/generation/tasks | 查询自己的生成任务列表、状态和结果素材 | generation:read 或 generation:write |
| GET | /api/generation/tasks/{id} | 查询单个生成任务详情 | generation:read 或 generation:write |
| GET | /api/assets | 查询自己的素材列表,可按类型或任务筛选 | assets:read 或 generation:write |
| GET | /api/assets/{id} | 查询单个素材详情和关联任务 | assets:read 或 generation:write |
| POST | /api/studio/projects | 创建漫剧、短剧或广告视频项目 | 网页登录 |
| POST | /api/studio/storyboard | 为剧集创建分镜镜头 | 网页登录 |
| POST | /api/orders | 创建人工充值订单 | 网页登录 |
| POST | /api/auth/login | 创建网页登录会话 | 邮箱与密码 |
登录后进入个人中心的 API 密钥页面,创建带有 generation:write 和 assets:read 权限的 Key。完整密钥只展示一次,请妥善保存。
调用生成任务接口提交提示词、模式、时长或图片数量。任务提交后,可通过列表或详情接口查询排队、生成中、完成和失败状态。
任务完成后,图片、视频、音频等结果会进入素材库。外部系统可以按任务、类型或素材 ID 读取结果并继续剪辑、投放或归档。