Opone API

API 文档

用 API 密钥从 MCP、CLI 或任意脚本生成 AI 视频——文生视频、图生视频,由 AI Agent 智能调度 Veo、Seedance 等顶级视频模型,9:16 竖屏与 16:9 横屏多比例一次产出;同样支持图像生成。提交即返回任务 ID,客户端断开也不会丢——轮询任务接口获取结果。

认证

在个人中心创建 API 密钥(需有效付费订阅)。密钥仅显示一次。每个请求都用 Bearer 头携带:

Authorization: Bearer opone_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

基础地址

https://opone.ai/api/v1

端点

POST/v1/generate-video

提交视频生成(文生视频或图生视频),立即返回任务 ID。

curl -X POST https://opone.ai/api/v1/generate-video \
  -H "Authorization: Bearer $OPONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model-id>",
    "input": { "prompt": "a red fox running through fresh snow", "aspect_ratio": "9:16", "duration": 5 }
  }'
# → 202 { "id": "<job-id>", "status": "queued", "credits_charged": 20 }

POST/v1/generate-image

提交图像生成(也可作为图生视频的首帧),立即返回任务 ID。

curl -X POST https://opone.ai/api/v1/generate-image \
  -H "Authorization: Bearer $OPONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model-id>",
    "input": { "prompt": "a red fox in snow", "aspect_ratio": "16:9" },
    "num_images": 1
  }'
# → 202 { "id": "<job-id>", "status": "queued", "credits_charged": 7 }

GET/v1/jobs/{id}

轮询任务状态与结果(终态:done / failed / cancelled / timeout)。

curl https://opone.ai/api/v1/jobs/<job-id> \
  -H "Authorization: Bearer $OPONE_API_KEY"
# → { "id": "...", "status": "done", "output_urls": ["https://..."] }

GET/v1/models

列出可用的视频/图像模型(Veo、Seedance 等顶级视频模型)及其计费与输入参数。

curl https://opone.ai/api/v1/models -H "Authorization: Bearer $OPONE_API_KEY"

GET/v1/credits

查询剩余积分余额。

curl https://opone.ai/api/v1/credits -H "Authorization: Bearer $OPONE_API_KEY"

限流与错误

请求按订阅档限流:限流触发的 429 会带 Retry-After 与 X-RateLimit-* 头,请据此退避;并发已满同样返回 429(不带限流头),稍后重试即可。其他状态码:401 密钥无效 · 403 无有效付费订阅 · 402 积分不足 · 422 模型类型不符 · 400 参数错误。