Skywork AI Skyreels V4 Image To Video API Documentation

Skywork AI Skyreels V4 Image To Video API Documentation

Playground

SkyReels V4 Image to Video is a fast AI image-to-video generation model that creates high-quality videos from image references and text prompts using the SkyReels V4 image2video workflow. Ready-to-use REST inference API for animating images, product videos, character motion, branded storytelling, social media clips, advertising creatives, and professional image-to-video workflows with simple integration, no coldstarts, and affordable pricing.

Features

Skywork AI SkyReels V4 Image-to-Video generates videos from a starting image, with optional middle-frame and end-frame guidance for stronger visual control. It supports standard and fast generation modes, multiple resolutions, optional sound effects, and prompt-driven motion design for cinematic, product, and storytelling workflows.

Why Choose This?

• Image-guided video generation Start from a first-frame image and turn it into a motion video clip with prompt-based control.

• Multi-frame guidance Optionally add middle-frame images and an end-frame image to better control progression, structure, and visual consistency.

• Two generation modes Choose std for higher-quality output or fast for quicker, lower-cost generation.

• Multiple resolution options Supports 480p, 720p, and 1080p to balance quality and budget.

• Optional sound effects Enable sound when you want the video generated with audio effects.

• Production-ready workflow Suitable for product videos, stylized motion design, short-form storytelling, and visual prototyping.

Parameters

How to Use

1. Upload the first frame — provide the starting image for the video.
2. Write your prompt — describe the motion, camera movement, pacing, and visual behavior you want.
3. Add guide frames (optional) — upload middle-frame images and/or an end-frame image for more controlled progression.
4. Choose duration — select a clip length between 3 and 15 seconds.
5. Choose resolution — use 480p, 720p, or 1080p depending on quality and budget needs.
6. Choose mode — use std for higher quality or fast for quicker generation.
7. Enable sound (optional) — turn this on if you want generated sound effects. If using fast, keep sound=false.
8. Submit — run the model and download the generated video.

Example Prompt

A cinematic product reveal with smooth forward camera motion, soft reflections, elegant studio lighting, subtle object rotation, and premium commercial pacing.

Pricing

Pricing depends on duration, resolution, and mode.

Standard Mode

Fast Mode

Example Costs

Standard Mode

Fast Mode

Billing Rules

• Base multiplier starts from $0.10 per second
• Pricing scales linearly with duration
• std and fast use different resolution multipliers
• sound does not affect pricing directly
• fast mode currently requires sound=false

Best Use Cases

• Product motion videos — Turn still product shots into polished reveal clips.
• Storytelling sequences — Use start, middle, and end guidance to shape a clear visual arc.
• Creative prototyping — Test motion concepts quickly with fast mode.
• Social and ad content — Generate short-form videos with clear visual direction.
• Cinematic image animation — Create controlled motion from a sequence of reference frames.

Pro Tips

• Use a strong first-frame image for better visual consistency.
• Add middle or end frames when scene progression matters more than freeform motion.
• Keep prompts focused on motion, pacing, and camera behavior rather than static visual details already present in the images.
• Use fast mode for quick iteration, then switch to std for final-quality output.
• Keep sound=false when using fast mode.
• Start with shorter durations to validate motion before generating longer clips.

Notes

• prompt and first_frame_image are required.
• images supports up to 6 optional middle-frame images.
• duration supports 3–15 seconds.
• resolution defaults to 1080p.
• mode defaults to std.
• fast mode currently requires sound=false.
• Pricing depends on duration, resolution, and mode.

Related Models

• Skywork AI SkyReels V4 Text-to-Video — Generate videos directly from text prompts.
• Skywork AI SkyReels V3 Reference-to-Video — Generate videos from one to four reference images and a prompt.
• Skywork AI SkyReels V3 Extend Video — Continue an existing video clip with newly generated footage.
• Skywork AI SkyReels V3 Pro Multi Avatar — Higher-tier two-speaker avatar generation from one scene image.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "first_frame_image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
  "duration": 5,
  "resolution": "1080p",
  "sound": false,
  "mode": "std"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/skywork-ai/skyreels-v4/image-to-video" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters