SkyReels V4

通过 BeansAI 提交 SkyReels V4 异步视频任务，支持文生视频、图生视频和 Omni 视频参考。

概览

SkyReels 原生接口按能力拆分，例如 POST /api/v1/video/text2video/submit、POST /api/v1/video/image2video/submit 和 POST /api/v1/video/omni-video/submit。查询任务使用对应的 GET /api/v1/video/:operation/task/:task_id。

BeansAI 对外保持统一入口：POST /videos 和 GET /videos/:task_id。relay 会把参数转换成 SkyReels 原生请求，把节点密钥写入 api_key，并用 beansvids_... 包装任务 ID 以便后续轮询。

Models

Model	Operation	Use
skyreels-v4-text-std	text2video	Text prompt to video, standard mode
skyreels-v4-text-fast	text2video	Text prompt to video, fast mode
skyreels-v4-image-std	image2video	First-frame image to video, standard mode
skyreels-v4-image-fast	image2video	First-frame image to video, fast mode
skyreels-v4-omni-std	omni-video	Omni references without video-reference pricing
skyreels-v4-omni-fast	omni-video	Fast omni references without video-reference pricing
skyreels-v4-omni-video-std	omni-video	Omni video-reference workflow, standard mode
skyreels-v4-omni-video-fast	omni-video	Omni video-reference workflow, fast mode

Submit text to video

text-to-video.sh

curl https://api.beansai.dev/v1/videos \
  -H "Authorization: Bearer sk-beans-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "skyreels-v4-text-std",
    "content": [
      {
        "type": "text",
        "text": "A polished green coffee bean logo forms from soft studio light, cinematic product reveal"
      }
    ],
    "ratio": "16:9",
    "duration": "5",
    "resolution": "1080p",
    "mode": "std",
    "generate_audio": false
  }'

Submit image to video

在 content[] 中放入参考图，BeansAI 会转成 SkyReels 的 first_frame_image。

image-to-video.sh

curl https://api.beansai.dev/v1/videos \
  -H "Authorization: Bearer sk-beans-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "skyreels-v4-image-std",
    "content": [
      { "type": "text", "text": "Animate this product photo into a clean 5 second launch reveal" },
      { "type": "image_url", "image_url": { "url": "https://example.com/product.png" } }
    ],
    "ratio": "9:16",
    "duration": "5",
    "resolution": "720p",
    "mode": "std"
  }'

Submit omni video

Omni 视频参考工作流使用 video_url 内容块。BeansAI 会转成 SkyReels ref_videos，并保持任务 ID 可以通过 /videos/:task_id 查询。

omni-video.sh

curl https://api.beansai.dev/v1/videos \
  -H "Authorization: Bearer sk-beans-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "skyreels-v4-omni-video-std",
    "content": [
      { "type": "text", "text": "Use the reference motion, replace the subject with a green coffee bean mascot, keep the camera movement smooth" },
      { "type": "video_url", "video_url": { "url": "https://example.com/motion-reference.mp4" } }
    ],
    "ratio": "16:9",
    "duration": "5",
    "resolution": "720p",
    "mode": "std"
  }'

Poll task status

保存返回的 id 或 task_id。BeansAI 返回的 SkyReels 任务 ID 以 beansvids_ 开头。

poll-task.sh

curl https://api.beansai.dev/v1/videos/beansvids_... \
  -H "Authorization: Bearer sk-beans-..."

Native mapping

SkyReels 原生接口把 API Key 放在 JSON body 里。BeansAI 里由管理员把这个 key 配在 provider node 上，客户端仍然只使用 BeansAI 的 Bearer key。

skyreels-native-example.sh

curl https://api-gateway.skyreels.ai/api/v1/video/text2video/submit \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "sk-skyreels-...",
    "prompt": "A cinematic product reveal",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p",
    "mode": "std",
    "sound": false
  }'

使用技巧

ratio 会映射到 SkyReels 的 aspect_ratio；generate_audio 会映射到 sound。
resolution 支持 480p、720p、1080p；mode 支持 fast 或 std。
如需指定某个 SkyReels 原生端点，可以传 skyreels_operation。

概览