全部接口
查询视频任务(免费
查询视频任务(免费
generate(文生视频
generate(参考图片)
video2video(视频转视频 风格重绘
提交视频生成任务
模型信息
| 模型 ID | runway-aleph | 供应商 | Runway |
|---|---|---|---|
| 输入模态 | 未注明 | 输出模态 | 未注明 |
| 分类 | 未注明 | 发布时间 | 2025-08-18 11:11:58 |
调用接口
| 分组 | 接口 | 渠道 | 方法 | 路径 |
|---|---|---|---|---|
| 全部接口 | 查询视频任务(免费 | 本站 AI 中转站 | GET | /runwayml/v1/tasks/{task_id} |
| 全部接口 | 查询视频任务(免费 | 本站 AI 中转站 | POST | /runway/v1/feed |
| 全部接口 | generate(文生视频 | 本站 AI 中转站 | POST | /runway/v1/pro/generate |
| 全部接口 | generate(参考图片) | 本站 AI 中转站 | POST | /runway/v1/pro/generate |
| 全部接口 | video2video(视频转视频 风格重绘 | 本站 AI 中转站 | POST | /runway/v1/pro/video2video |
| 全部接口 | 提交视频生成任务 | 本站 AI 中转站 | POST | /runwayml/v1/image_to_video |
GET /runwayml/v1/tasks/{task_id}
{
"summary": "查询视频任务(免费",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"id",
"status",
"createdAt",
"progress"
],
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string"
},
"progress": {
"type": "number"
},
"createdAt": {
"type": "string"
}
}
}
}
},
"description": "成功"
}
},
"parameters": [
{
"in": "path",
"name": "task_id",
"schema": {
"type": "string"
},
"required": true,
"description": ""
},
{
"in": "header",
"name": "X-Runway-Version",
"schema": {
"type": "string",
"example": "2024-11-06"
},
"required": true,
"description": ""
}
],
"description": ""
}POST /runway/v1/feed
{
"summary": "查询视频任务(免费",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "查询视频任务(免费",
"$schema": "",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string"
}
},
"x-apifox-id": "259399394"
}
}
},
"required": true
}
}POST /runway/v1/pro/generate
{
"summary": "generate(文生视频",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "generate(文生视频",
"$schema": "",
"required": [
"ratio",
"prompt",
"style",
"model",
"options",
"callback_url"
],
"properties": {
"image": {
"type": "string",
"description": "选填,不传则是文生视频"
},
"model": {
"enum": [
"gen2",
"gen3",
"gen4"
],
"type": "string",
"title": "模型"
},
"ratio": {
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4",
"21:9"
],
"type": "string",
"title": "画面尺寸",
"description": "gen-3仅支持16:9和9:16，图生视频也要传比例,不传默认16:9,枚举值16:9,9:16,1:1,4:3,3:4,21:9"
},
"style": {
"type": "string",
"title": "风格",
"description": "请看style 列表文档"
},
"prompt": {
"type": "string",
"title": "描述词"
},
"options": {
"type": "object",
"required": [
"seconds",
"motion_vector"
],
"properties": {
"seconds": {
"enum": [
5,
10
],
"type": "integer",
"title": "视频时长",
"description": "目前仅支持gen-3、4；传5或10"
},
"motion_vector": {
"type": "object",
"title": "镜头控制",
"required": [
"x",
"y",
"z",
"r",
"bg_x_pan",
"bg_y_pan"
],
"properties": {
"r": {
"type": "integer",
"title": "旋转",
"description": "-10.0到10.0之间"
},
"x": {
"type": "integer",
"title": "水平",
"description": "-10.0到10.0之间"
},
"y": {
"type": "number",
"title": "垂直",
"description": "-10.0到10.0之间"
},
"z": {
"type": "integer",
"title": "缩放",
"description": "-10.0到10.0之间"
},
"bg_x_pan": {
"type": "integer",
"title": "左右方向倾斜",
"description": "-10.0到10.0之间"
},
"bg_y_pan": {
"type": "integer",
"title": "上下方向倾斜",
"description": "-10.0到10.0之间"
}
},
"description": "目前仅支持gen-2"
}
}
},
"callback_url": {
"type": "string"
}
},
"x-apifox-id": "259399395"
}
}
},
"required": true
}
}POST /runway/v1/pro/generate
### generate(参考图片)
### 请求参数
|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|Authorization|header|string| 否 ||none|
|body|body|object| 否 ||none|
|» image|body|string| 是 | 参考的图片|可供互联网访问并可下载的图片链接|
|» style|body|string| 否 | 风格|目前仅支持gen-2|
|» model|body|string| 否 | 模型|none|
|» prompt|body|string| 是 | 描述词|支持中文|
|» options|body|object| 是 | 参数|none|
|»» motion_vector|body|object| 是 | 镜头控制|目前仅支持gen-2|
|»»» x|body|number| 是 | 水平|-10.0到10.0之间|
|»»» y|body|integer| 是 | 垂直|-10.0到10.0之间|
|»»» z|body|integer| 是 | 缩放|-10.0到10.0之间|
|»»» r|body|integer| 是 | 旋转|-10.0到10.0之间|
|»»» bg_x_pan|body|integer| 是 | 左右方向倾斜|-10.0到10.0之间|
|»»» bg_y_pan|body|integer| 是 | 上下方向倾斜|-10.0到10.0之间|
|»» seconds|body|integer| 是 | 视频时长|目前仅支持gen-3|
|»» flip|body|boolean| 是 | 是否竖屏|默认为宽屏,即16:9；仅 gen3 可用|
|» last_image|body|string| 否 | 尾帧|none|
{
"summary": "generate(参考图片)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "### generate(参考图片)\n### 请求参数\n\n|名称|位置|类型|必选|中文名|说明|\n|---|---|---|---|---|---|\n|Authorization|header|string| 否 ||none|\n|body|body|object| 否 ||none|\n|» image|body|string| 是 | 参考的图片|可供互联网访问并可下载的图片链接|\n|» style|body|string| 否 | 风格|目前仅支持gen-2|\n|» model|body|string| 否 | 模型|none|\n|» prompt|body|string| 是 | 描述词|支持中文|\n|» options|body|object| 是 | 参数|none|\n|»» motion_vector|body|object| 是 | 镜头控制|目前仅支持gen-2|\n|»»» x|body|number| 是 | 水平|-10.0到10.0之间|\n|»»» y|body|integer| 是 | 垂直|-10.0到10.0之间|\n|»»» z|body|integer| 是 | 缩放|-10.0到10.0之间|\n|»»» r|body|integer| 是 | 旋转|-10.0到10.0之间|\n|»»» bg_x_pan|body|integer| 是 | 左右方向倾斜|-10.0到10.0之间|\n|»»» bg_y_pan|body|integer| 是 | 上下方向倾斜|-10.0到10.0之间|\n|»» seconds|body|integer| 是 | 视频时长|目前仅支持gen-3|\n|»» flip|body|boolean| 是 | 是否竖屏|默认为宽屏,即16:9；仅 gen3 可用|\n|» last_image|body|string| 否 | 尾帧|none|",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "generate(参考图片)",
"$schema": "",
"required": [
"image",
"style",
"model",
"prompt",
"options"
],
"properties": {
"image": {
"type": "string"
},
"model": {
"type": "string"
},
"style": {
"type": "string",
"description": "目前仅支持gen-2"
},
"prompt": {
"type": "string"
},
"options": {
"type": "object",
"required": [
"motion_vector"
],
"properties": {
"motion_vector": {
"type": "object",
"required": [
"x",
"y",
"z",
"r",
"bg_x_pan",
"bg_y_pan"
],
"properties": {
"r": {
"type": "integer"
},
"x": {
"type": "number"
},
"y": {
"type": "integer"
},
"z": {
"type": "integer"
},
"bg_x_pan": {
"type": "integer"
},
"bg_y_pan": {
"type": "integer"
}
},
"description": "目前仅支持gen-2"
}
}
}
},
"x-apifox-id": "259399482"
}
}
},
"required": true
}
}POST /runway/v1/pro/video2video
### video2video(视频转视频 风格重绘
### 请求参数
|名称|位置|类型|必选|中文名|说明|
|---|---|---|---|---|---|
|body|body|object| 否 ||none|
|» video|body|string| 是 ||none|
|» model|body|string| 是 | 模型|none|
|» prompt|body|string| 是 | 描述词|支持中文|
|» options|body|object| 是 | 参数|none|
|»» structure_transformation|body|number| 是 | 结构改造|0-1之间|
|»» flip|body|boolean| 否 | 是否竖屏|默认为宽屏,即16:9|
{
"summary": "video2video(视频转视频 风格重绘",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "### video2video(视频转视频 风格重绘\n### 请求参数\n|名称|位置|类型|必选|中文名|说明|\n|---|---|---|---|---|---|\n|body|body|object| 否 ||none|\n|» video|body|string| 是 ||none|\n|» model|body|string| 是 | 模型|none|\n|» prompt|body|string| 是 | 描述词|支持中文|\n|» options|body|object| 是 | 参数|none|\n|»» structure_transformation|body|number| 是 | 结构改造|0-1之间|\n|»» flip|body|boolean| 否 | 是否竖屏|默认为宽屏,即16:9|",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "video2video(视频转视频 风格重绘",
"$schema": "",
"required": [
"video",
"model",
"prompt",
"options"
],
"properties": {
"model": {
"type": "string",
"description": "gen3"
},
"video": {
"type": "string"
},
"prompt": {
"type": "string"
},
"options": {
"type": "object",
"required": [
"structure_transformation",
"flip"
],
"properties": {
"flip": {
"type": "boolean"
},
"structure_transformation": {
"type": "number"
}
}
}
},
"x-apifox-id": "259399518"
}
}
},
"required": true
}
}POST /runwayml/v1/image_to_video
### 提交视频生成任务
{
"summary": "提交视频生成任务",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
}
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "### 提交视频生成任务",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "提交视频生成任务",
"$schema": "",
"required": [
"model",
"promptText"
],
"properties": {
"seed": {
"type": "integer"
},
"model": {
"type": "string",
"description": "\"gen3a_turbo\"、\"gen4_turbo\""
},
"ratio": {
"type": "string",
"description": "gen3a_turbo 仅支持 1280:768为横屏 768:1280为竖屏，gen4_turbo 支持 1280:720 720:1280 1104:832 832:1104 960:960 1584:672"
},
"duration": {
"type": "integer",
"description": "5 \\ 10"
},
"watermark": {
"type": "boolean"
},
"promptText": {
"type": "string"
},
"promptImage": {
"type": "array",
"items": {
"type": "object",
"required": [
"uri",
"position"
],
"properties": {
"uri": {
"type": "string",
"description": "A HTTPS URL or data URI containing an encoded image. See our docs on image inputs for more information."
},
"position": {
"enum": [
"first",
"last"
],
"type": "string",
"description": "图像在输出视频中的位置。“first”将使用图像作为视频的第一帧，“last”将使用图像作为视频的最后一帧。"
}
}
}
}
},
"x-apifox-id": "234029137"
}
}
},
"required": true
}
}价格
| 价格组 | 渠道 | 计费项 | 价格 | 单位 |
|---|---|---|---|---|
| default | AI 中转站 | request | CNY 1.5 | request |
服务级错误码参照(error_code)：
| 错误码 | 说明 | |
|---|---|---|
| 221301 | 数据源超时 | |
| 221303 | 认证失败 认证失败，请稍后重试 认证失败,该卡当日连续多次认证不通过被限制校验,次日恢复 |
|
| 221306 | 参数错误 参数错误：姓名格式不正确 参数错误：手机号格式不正确 参数错误：身份证格式不正确 参数错误：银行卡号格式不正确 同一银行卡请求过于频繁 |
系统级错误码参照：
| 错误码 | 说明 | |
|---|---|---|
| 10001 | 错误的请求KEY | |
| 10002 | 该KEY无请求权限 | |
| 10003 | KEY过期 | |
| 10004 | 错误的OPENID | |
| 10005 | 应用未审核超时，请提交认证 | |
| 10007 | 未知的请求源 | |
| 10008 | 被禁止的IP | |
| 10009 | 被禁止的KEY | |
| 10011 | 当前IP请求超过限制 | |
| 10012 | 请求超过次数限制 | |
| 10013 | 测试KEY超过请求限制 | |
| 10014 | 系统内部异常(调用充值类业务时，请务必联系客服或通过订单查询接口检测订单，避免造成损失) | |
| 10020 | 接口维护 | |
| 10021 | 接口停用 |
错误码格式说明（示例：200201）：
| 2 | 002 | 01 | |
|---|---|---|---|
| 服务级错误（1为系统级错误） | 服务模块代码(即数据ID) | 具体错误代码 |
使用文档下载
| 附件标题/下载链接 | 更新时间 | |
|---|---|---|
| 接口资料：GET /runwayml/v1/tasks/{task_id}（查询视频任务(免费） | 2026-09-09 15:29:07 | |
| 接口资料：POST /runway/v1/feed（查询视频任务(免费） | 2026-09-09 15:29:07 | |
| 接口资料：POST /runway/v1/pro/generate（generate(文生视频） | 2026-09-09 15:29:07 | |
| 接口资料：POST /runway/v1/pro/generate（generate(参考图片)） | 2026-09-09 15:29:07 | |
| 接口资料：POST /runway/v1/pro/video2video（video2video(视频转视频 风格重绘） | 2026-09-09 15:29:07 | |
| 接口资料：POST /runwayml/v1/image_to_video（提交视频生成任务） | 2026-09-09 15:29:07 | |
| 价格分组：default（CNY 1.5/request） | 2026-09-09 15:29:07 | |
| 供应商令牌分组折扣资料 | 2026-09-09 15:29:07 |
常见问题：
| 标题 | 更新时间 | |
|---|---|---|
| Token 是什么？中文、英文与上下文窗口如何计算 | 2026-09-21 00:31:09 | |
| LLM API 费用如何计算？如何选择合适的模型 | 2026-09-21 01:16:03 | |
| Word-to-Token 转换与用量估算指南 | 2026-09-21 00:31:09 |
gemini-3.8-flash-thinking-medium
gemini-3.8-flash-thinking-high
京公网安备11010802020088号