Skywork AI Skyreels V4 Text To Video API Documentation

Skywork AI Skyreels V4 Text To Video API Documentation

Playground

SkyReels V4 Text to Video is a fast AI video generation model that creates high-quality videos from text prompts using the SkyReels V4 text2video workflow. Ready-to-use REST inference API for cinematic clips, storytelling videos, social media content, advertising creatives, product visuals, concept videos, and professional text-to-video workflows with simple integration, no coldstarts, and affordable pricing.

Features

Skywork AI SkyReels V4 Text-to-Video generates videos from natural-language prompts with flexible duration, aspect ratio, resolution, optional sound effects, and selectable quality modes. It is designed for cinematic short-form generation, social video, concept visualization, and rapid creative iteration across both standard-quality and faster-generation workflows.

Why Choose This?

• Prompt-based video generation Turn natural-language scene descriptions into short video clips with controllable duration and format.

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

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

• Flexible aspect ratios Choose 16:9, 9:16, or 1:1 for widescreen, vertical, or square delivery.

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

• Production-ready API Suitable for short-form content, ad concepts, storytelling, social media clips, and rapid prototyping.

Parameters

How to Use

1. Write your prompt — describe the scene, action, camera motion, atmosphere, and visual style you want.
2. Choose duration — select a clip length between 3 and 15 seconds.
3. Choose aspect ratio — use 16:9, 9:16, or 1:1 based on your target platform.
4. Choose resolution — set 480p, 720p, or 1080p depending on quality and cost needs.
5. Choose mode — use std for higher quality or fast for quicker generation.
6. Enable sound (optional) — turn this on if you want generated sound effects. If using fast, keep sound=false.
7. Submit — run the model and download the generated video.

Example Prompt

A cinematic tracking shot through a neon-lit city street at night, light rain on the pavement, reflections shimmering, subtle crowd movement, dramatic atmosphere, realistic camera motion

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

• Social media clips — Generate short vertical, square, or widescreen content for modern platforms.
• Creative prototyping — Test visual ideas quickly with fast mode.
• Cinematic concept videos — Use std mode for more polished short-form storytelling.
• Advertising concepts — Create quick ad visuals, hero motion, and campaign explorations.
• Mood and scene generation — Turn descriptive prompts into stylized or realistic motion clips.

Pro Tips

• Be specific in your prompt about action, lighting, camera movement, and atmosphere.
• Use fast mode for quick iteration, then switch to std for higher-quality final output.
• Use 480p or 720p when testing prompt ideas before committing to 1080p.
• Keep sound=false when using fast mode.
• Start with shorter durations to validate the concept, then extend to longer clips if needed.

Notes

• prompt is required.
• duration supports 3–15 seconds.
• aspect_ratio defaults to 16:9.
• 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 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 Single Avatar — Higher-quality single-avatar speaking video generation.
• 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",
  "duration": 5,
  "aspect_ratio": "16:9",
  "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/text-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