官方格式
图片生成视频
使用 Runway 官方格式 POST /runwayml/v1/image_to_video 创建图片生成视频任务，支持运动提示词和多种宽高比。
POST
/
runwayml
/
v1
/
image_to_video
创建图片生成视频任务
curl --request POST \
--url https://api.deerapi.com/runwayml/v1/image_to_video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Runway-Version: <x-runway-version>' \
--data '
{
"promptImage": "https://example.com/your-image.jpg",
"model": "gen3a_turbo"
}
'{
"id": "4534fbe1-effa-4a12-b401-02923dace753"
}通过此端点使用 Runway 官方 API 格式创建图片生成视频任务。
调用前准备
- 必须在请求头中传递
X-Runway-Version，例如2024-11-06 promptImage须为稳定可访问的 HTTPS 图片地址- 使用
model: gen3a_turbo - 可选传入
promptText描述期望的运动效果
任务流程
轮询任务状态
使用查询任务状态端点，传入上一步获取的
id 查询进度。刚创建的任务可能短暂不可见，等待几秒后重试。Authorizations
Bearer token 认证。使用 DeerAPI Key。
Headers
Runway API 版本标识，例如 2024-11-06。
Body
application/json
源图片 URL，须为稳定可访问的 HTTPS 地址。
Runway 模型 ID。
随机种子，用于获得可复现的结果。范围：0–999999999。
文本提示词，描述期望的运动或场景变化。最多 512 个字符。
是否在输出视频上添加水印。
视频时长（秒）。可选值：5 或 10。
输出视频的宽高比。
Available options:
1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280 Response
200 - application/json
任务创建成功，返回任务 ID。
任务唯一标识符，用于后续查询任务状态。
⌘I
创建图片生成视频任务
curl --request POST \
--url https://api.deerapi.com/runwayml/v1/image_to_video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Runway-Version: <x-runway-version>' \
--data '
{
"promptImage": "https://example.com/your-image.jpg",
"model": "gen3a_turbo"
}
'{
"id": "4534fbe1-effa-4a12-b401-02923dace753"
}