API 参考

Runway Aleph Edit-Video

创建文生视频任务，并跟踪其完成或失败状态。

查看 Markdown

概览

使用支持的模型创建异步文生视频任务。使用返回的任务 ID 查询状态，或提供 callback_url 接收终态投递。

快速开始

创建 API Key，并将其设置为 RUNAPI_API_KEY。
选择一个支持的模型，并发送与该模型 Schema 匹配的 POST 请求。
保存返回的任务 ID，随后轮询到终态，或处理终态回调。

POST /api/v1/runway_aleph/edit_video

基础 URL: https://runapi.ai
API 版本: v1
身份验证: Authorization: Bearer YOUR_API_TOKEN

支持的模型

打开模型页可查看当前价格、限流和商业使用详情。

runway-aleph

请求 Schema

JSON 请求体

字段和允许的取值取决于所选模型。提供 callback_url 后，它会收到任务终态投递。

runway-aleph8 个字段

aspect_ratiostring

可选 可选值: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9

callback_urlstring

可选

modelstring

可选

promptstring

必填

reference_image_urlstring

可选

seedinteger

可选

source_video_urlstring

必填

watermarkstring

可选

创建已接受

HTTP 202

POST /api/v1/runway_aleph/edit_video

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}

轮询处理中

HTTP 200

GET /api/v1/runway_aleph/edit_video/:id

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}

轮询已完成

HTTP 200

GET /api/v1/runway_aleph/edit_video/:id

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "images": [
    {
      "url": "https://file.runapi.ai/reference-image.png"
    }
  ],
  "status": "completed",
  "videos": [
    {
      "url": "https://file.runapi.ai/reference-video.mp4"
    }
  ]
}

轮询失败

HTTP 200

GET /api/v1/runway_aleph/edit_video/:id

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "error": "Task processing failed.",
  "id": "tsk_reference_demo",
  "status": "failed"
}

客户回调：已完成

HTTP 200

POST callback_url

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "images": [
    {
      "url": "https://file.runapi.ai/reference-image.png"
    }
  ],
  "status": "completed",
  "videos": [
    {
      "url": "https://file.runapi.ai/reference-video.mp4"
    }
  ]
}

客户回调：失败

HTTP 200

POST callback_url

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "error": {
    "code": "generation_failed",
    "message": "Task processing failed."
  },
  "id": "tsk_reference_demo",
  "status": "failed"
}

错误

HTTP 400

JSON

{
  "error": {
    "code": "invalid_request",
    "message": "A required request field is missing."
  }
}

生成的代码示例

直接使用 cURL，或安装所用语言的 SDK。每个示例都会提交本参考中经过验证的请求。

CURL

curl -X POST https://runapi.ai/api/v1/runway_aleph/edit_video \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"model":"runway-aleph","prompt":"Replace the sky with a clear sunrise.","source_video_url":"https://file.runapi.ai/source-video.mp4"}'

Runway Aleph Edit-Video

概览

快速开始

端点

支持的模型

请求 Schema

创建已接受

轮询处理中

轮询已完成

轮询失败

客户回调：已完成

客户回调：失败

错误

生成的代码示例

相关指南