悠船图生视频

POST

/openapi/v2/youchuan/image-to-video

悠船的视频能力专注于捕捉静止艺术中的“灵魂瞬间”。它支持以单张图片作为起点，或通过“首尾双帧”设定精确的运动轨迹，在 5 秒的黄金时间内输出极具质感的动态序列。该功能提供 480p 与 720p 两种画质选择，确保了从微观的光影流转到宏大的镜头位移都能保持原图的顶级审美。无论是追求细腻的氛围渲染，还是富有冲击力的视觉转换，它都能在极短的时间内实现美学与动效的完美融合。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "prompt": "平滑的魔法过渡：法术书封面自然抬起，书页翻转并向上飘浮，金色光粒子动态旋转增强，符文亮度逐渐增强，从闭合到展开的无缝形态变化，电影级动态效果，流畅的延时动画",
    "firstImageUrl": "https://www.runninghub.cn/view?filename=861f7549d2e27505de527e491371bf87475d5a76177ad9c8aae2d1ddf9aa4842.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzAzNTUwMjQwMTMsInRzIjoxNzY5NzUwMjI0MDEzLCJzaWduIjoiMWZlY2Q0NWVmZmFjYWFjY2I0MTcyYmIzM2Q1MjdmNjEifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.1336447606892428",
    "resolution": "720p",
    "motion": "low",
    "raw": true,
    "loop": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.cn/openapi/v2/youchuan/image-to-video' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "平滑的魔法过渡：法术书封面自然抬起，书页翻转并向上飘浮，金色光粒子动态旋转增强，符文亮度逐渐增强，从闭合到展开的无缝形态变化，电影级动态效果，流畅的延时动画",
    "firstImageUrl": "https://www.runninghub.cn/view?filename=861f7549d2e27505de527e491371bf87475d5a76177ad9c8aae2d1ddf9aa4842.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzAzNTUwMjQwMTMsInRzIjoxNzY5NzUwMjI0MDEzLCJzaWduIjoiMWZlY2Q0NWVmZmFjYWFjY2I0MTcyYmIzM2Q1MjdmNjEifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.1336447606892428",
    "resolution": "720p",
    "motion": "low",
    "raw": true,
    "loop": false
}'

返回响应

🟢200成功

application/json

任务结果查询接口：/openapi/v2/query

Body

示例

提交任务响应示例任务完成（查询状态接口）响应示例

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

修改于 2026-03-10 12:42:16

海螺-02-fast

可灵图生视频o3-pro