调用 AngeMedia API
API 客户端应显式指定模型,并保存任务 ID。不要假设提交视频后会同步返回最终文件。
认证
Authorization: Bearer <GATEWAY_API_KEY>
也可使用服务支持的 X-API-Key 形式。管理员会话和 Gateway API Key 用途不同,不要混用。
图片生成
curl -X POST http://localhost:9890/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_GATEWAY_KEY" \
-d '{"model":"kolors","prompt":"a cinematic orange cat on a neon street","size":"1024x1024","response_format":"url"}'
视频任务
curl -X POST http://localhost:9890/v1/videos \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_GATEWAY_KEY" \
-d '{"model":"agnes-video-v2.0","prompt":"a slow cinematic camera move","width":1152,"height":768,"num_frames":121,"frame_rate":24}'
保存返回的 task_id,然后查询:
curl -H "Authorization: Bearer YOUR_GATEWAY_KEY" \
http://localhost:9890/v1/videos/TASK_ID
媒体路由建议
curl -X POST http://localhost:9890/v1/media/route \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_GATEWAY_KEY" \
-d '{"prompt":"Create a realistic commercial portrait with neon lighting"}'
路由接口可以提供建议,但最终请求仍应根据模型能力确认尺寸和参考输入。
错误处理
| 状态 | 客户端处理 |
|---|---|
| 401/403 | 检查 Gateway Key 和访问路径 |
| 400/422 | 检查模型、尺寸和输入字段 |
| 429 | 按 Retry-After 退避,不要立即并发重试 |
| 5xx | 记录请求 ID 和脱敏错误摘要,有限次数重试 |
| 视频 failed | 读取任务事件和 Provider 脱敏原因 |