Sora2 Api

提供文生视频与图生视频接口。请使用 `Authorization: Bearer YOUR_API_KEY` 鉴权，积分自动扣减与退款。详见 /docs。

查看 API Keys 充值积分

调用前须知

接口为站内 Next API，需要 `Authorization: Bearer YOUR_API_KEY`。
按模型扣积分：sora-2 为 20，sora-2-pro 为 30；失败任务自动退款。
图生视频可传 imageData（base64）或 url；图片会先上传到存储再调用 Sora2 Api。

生成视频

POST /api/v1/video/sora-video 进行文生视频或图生视频，提交包含 prompt 与 model 的 JSON。

方法: POST路径: /api/v1/image/nano-banana

请求体字段

prompt（必填）：要生成的视频描述。
model（必填）：sora-2 | sora-2-pro。
nanoBananaApi.generation.fields.mode
aspectRatio（选填）：支持 16:9 或 9:16。
nanoBananaApi.generation.fields.imageSize
nanoBananaApi.generation.fields.imageFile
nanoBananaApi.generation.fields.imageUrl
imageData（选填）：图生视频的 base64 data URL。

失败返回：400：缺少必填字段 / 图生视频缺少参考图 / 模型无效。；401：未登录。；402：积分不足。；500：服务配置异常或下游错误。

示例请求

curl -X POST https://sora2-api.com/api/v1/image/nano-banana \
  -H "Authorization: Bearer api-key" \
  -F "prompt=一只穿宇航服的香蕉猫在月球" \
  -F "model=nano-banana-pro" \
  -F "mode=image-to-image" \
  -F "aspectRatio=auto" \
  -F "imageSize=1K" \
  -F "imageFile=@/path/to/ref.png"

示例响应

{
  "data": {
    "id": "task-id-xxx",
    "results": [],
    "progress": 0,
    "status": "running",
    "failure_reason": null,
    "error": null,
    "credits_cost": 20
  }
}

查询结果

POST /api/video-generations/check-result 获取进度与结果，失败自动退款。

方法: POST路径: /api/v1/image/nano-banana/result

请求体：taskId（字符串）。返回字段与生成接口一致，status=failed 时积分已退回。

失败返回：400：缺少任务 ID。；401：未登录。；500：下游查询失败或服务异常。

示例请求

curl -X POST https://sora2-api.com/api/v1/image/nano-banana/result \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer api-key" \
  -d '{
    "taskId": "task-id-xxx"
  }'

示例响应

{
  "data": {
    "id": "task-id-xxx",
    "results": [
      {
        "url": "https://example.com/generated.png",
        "content": "一只穿宇航服的香蕉猫在月球"
      }
    ],
    "progress": 100,
    "status": "succeeded",
    "failure_reason": null,
    "error": null
  }
}

开始调用

使用 API Key 直接调用站内接口，更多细节请阅读 /docs。

在线使用提升额度