Generate high-quality AI videos using Kling v3.0 Omni with support for reference images, elements (image + video), reference videos, and multi-shot generation.

Model

kuaishou/kling-3.0-omni-video

Parameters

ParameterTypeRequiredDefaultDescription
promptstringYes*-Text prompt. *Required if no multi_shot
modestringNo"std""std" or "pro"
durationintegerNo53–15 seconds
aspect_ratiostringNo"16:9""16:9", "9:16", "1:1", "auto" (auto for frames only)
countintegerNo11–4
image_urlsstring[]No-Up to 7 reference image URLs, ref as @image_1 in prompt
elementsElementInput[]No-Up to 7, IMAGE + VIDEO. Shared pool with image_urls
start_image_urlstringNo-Start frame URL
end_image_urlstringNo-End frame URL
video_urlstringNo-Reference video URL, ref as @video_1 in prompt
video_modestringNo"reference""reference" or "transform"
keep_audiobooleanNofalseKeep audio from reference video
multi_shotShot[]No-2–6 shots, total duration 3–15s. Mutually exclusive with prompt
Shot object: { "prompt": string, "duration": int }

Elements

Elements are created automatically from your input, used during generation, then auto-deleted on completion. v3 Omni supports both IMAGE and VIDEO elements.
"elements": [
  {"name": "Hero", "description": "Woman in red jacket", "image_urls": ["front.jpg", "side.jpg"]},
  {"name": "Actor", "description": "Man dancing", "video_url": "dance.mp4"}
]
Each element accepts:
  • name (required, max 15 chars)
  • description (required, max 100 chars)
  • image_urls (1–4 images) — for IMAGE element
  • video_url (1 mp4, 3–8s) — for VIDEO element
  • Exactly one of image_urls or video_url required
Reference in prompt as @element_1, @element_2, etc.

Example - Basic Generation

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "kuaishou/kling-3.0-omni-video",
    "input": {
      "prompt": "Animate this scene with gentle movement",
      "start_image_url": "https://example.com/image.jpg",
      "duration": 5,
      "mode": "pro",
      "aspect_ratio": "16:9"
    }
  }'

Example - With Elements

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "kuaishou/kling-3.0-omni-video",
    "input": {
      "prompt": "@element_1 walks through a park at sunset",
      "elements": [
        {"name": "Hero", "description": "Woman in red jacket", "image_urls": ["https://example.com/front.jpg"]}
      ],
      "duration": 10,
      "mode": "pro",
      "aspect_ratio": "16:9"
    }
  }'

Example - Multi-Shot

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "kuaishou/kling-3.0-omni-video",
    "input": {
      "aspect_ratio": "16:9",
      "mode": "pro",
      "multi_shot": [
        { "prompt": "Wide shot of city skyline", "duration": 5 },
        { "prompt": "Close-up of glass buildings", "duration": 5 }
      ]
    }
  }'

Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "pending"
  }
}

Pricing

ModePrice
std (720p)$0.075/s
pro (1080p)$0.100/s