Sora 2 (Kie.ai) icon

Sora 2 (Kie.ai)

Generate videos using Sora 2 via Kie.ai API

Actions6

Storyboard

AI-generated

Summary

Generate a storyboard video by specifying a sequence of shots, each with its own text prompt and duration, using the Kie.ai Sora 2 Pro storyboard model.

Inputs

  • shotsJson (required) — A JSON array of shot objects where each shot has a 'prompt' describing the scene and a 'duration' as a string in seconds. The total duration of all shots must be exactly 10, 15, or 25 seconds.
  • nFrames — Select the total duration of the video in seconds (10 or 15 seconds). This must match the sum of durations in shotsJson.
  • size — Choose the video quality: High (1080p) or Standard (720p).
  • replyUrl — Optional webhook URL that the API will call upon task completion.
  • replyRef — Optional custom reference string sent back during webhook callback.
  • captchaToken — Optional reCAPTCHA token if required by the API.
  • waitForCompletion — Whether to poll the API and wait for the task's completion before returning results. Defaults to true.

Output shape

a JSON object per input with the creation response or the completed task result from the Kie.ai API

If 'waitForCompletion' is true, the operation polls every 3 seconds (up to 5 minutes timeout) until the storyboard video generation task completes. Otherwise, returns immediately with task creation details.

Examples

Example 1: Generate a 10-second storyboard video with two scenes described in shotsJson, using high quality and landscape aspect ratio, waiting for the task to complete.

Provide 'shotsJson' as '[{"prompt": "Scene one description", "duration": "5"}, {"prompt": "Scene two description", "duration": "5"}]', set 'nFrames' to '10', 'size' to 'high', and 'waitForCompletion' to true.

Links

Discussion