任务：生成视频

Runway 官方视频生成接口，用于将一张或多张图片生成短视频。

---

概览

• 请求方法：POST
• 请求路径：/runwayml/v1/image_to_video
• 内容类型：application/json
• 分类：视频模型（Video）/runway 官方API

认证方式

• Header：Authorization: Bearer <token>
• 额外 Header：X-Runway-Version: 2024-11-06

---

请求参数

JSON 请求体字段

字段	类型	必填	描述
promptImage	string / array	是	视频首帧图片，支持 URL 或 Base64；也可传对象数组形式指定首帧/尾帧
model	string	是	模型版本，支持 gen3a_turbo, gen4a_turbo
seed	integer	否	随机种子，不填则随机生成
promptText	string	否	视频提示词，最大 512 字符
watermark	boolean	否	是否包含 Runway 水印，默认 false
duration	integer	否	视频时长，支持 5 或 10，默认 5
ratio	string	否	视频分辨率，支持 1280:768 或 768:1280

---

请求示例

curl 示例

curl -X POST "https://api.gpt.ge/runwayml/v1/image_to_video" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_TOKEN" \
  -H "X-Runway-Version: 2024-11-06" \
  -d '{
    "promptImage": "https://pic.chaopx.com/chao_origin_pic/22/04/29/e086fae1a2ed91679fdc6a25beca5c68.jpg",
    "model": "gen4a_turbo",
    "seed": 2372601190,
    "promptText": "A dreamlike and disorienting hyperlapse racing through 1980s New York City.",
    "watermark": false,
    "duration": 5,
    "ratio": "1280:768"
  }'

JavaScript (fetch) 示例

fetch('https://api.gpt.ge/runwayml/v1/image_to_video', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Runway-Version': '2024-11-06'
  },
  body: JSON.stringify({
    promptImage: 'https://pic.chaopx.com/chao_origin_pic/22/04/29/e086fae1a2ed91679fdc6a25beca5c68.jpg',
    model: 'gen4a_turbo',
    seed: 2372601190,
    promptText: 'A dreamlike and disorienting hyperlapse racing through 1980s New York City.',
    watermark: false,
    duration: 5,
    ratio: '1280:768'
  })
}).then(res => res.json()).then(console.log)

Python 示例（requests）

import requests

resp = requests.post(
    'https://api.gpt.ge/runwayml/v1/image_to_video',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN',
        'X-Runway-Version': '2024-11-06'
    },
    json={
        'promptImage': 'https://pic.chaopx.com/chao_origin_pic/22/04/29/e086fae1a2ed91679fdc6a25beca5c68.jpg',
        'model': 'gen4a_turbo',
        'seed': 2372601190,
        'promptText': 'A dreamlike and disorienting hyperlapse racing through 1980s New York City.',
        'watermark': False,
        'duration': 5,
        'ratio': '1280:768'
    }
)
print(resp.json())

---

返回字段说明

字段	类型	描述
id	string	任务 ID，用于后续查询

---

返回示例（200）

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}