Docs/AngeMedia

调用 AngeMedia API

API 客户端应显式指定模型,并保存任务 ID。不要假设提交视频后会同步返回最终文件。

RESTGateway KeyAsync jobs

认证

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 脱敏原因