POST
javascript
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 const axios = require('axios'); const api_key = "YOUR API-KEY"; const url = "https://api.segmind.com/v1/kling-3-pro-text2video"; const data = { "prompt": "A dragon flying over mountains at sunset, vibrant colors, epic scene", "negative_prompt": "fog, noise, dark lighting", "duration": 10, "aspect_ratio": "16:9", "cfg_scale": 0.6, "generate_audio": true }; (async function() { try { const response = await axios.post(url, data, { headers: { 'x-api-key': api_key } }); console.log(response.data); } catch (error) { console.error('Error:', error.response.data); } })();
RESPONSE
image/jpeg
HTTP Response Codes
200 - OKImage Generated
401 - UnauthorizedUser authentication failed
404 - Not FoundThe requested URL does not exist
405 - Method Not AllowedThe requested HTTP method is not allowed
406 - Not AcceptableNot enough credits
500 - Server ErrorServer had some issue with processing

Attributes


promptstr *

Text description for video subject and scene to generate.


negative_promptstr ( default: fog, noise, dark lighting )

List elements to exclude. Avoid 'fog', 'noise' for clearer videos.


durationenum:str ( default: 10 ) Affects Pricing

Controls video length in seconds. Short for ads; long for storytelling.

Allowed values:

min : 3,

max : 4


aspect_ratioenum:str ( default: 16:9 )

Width-height ratio. 16:9 for cinema, 1:1 for social media.

Allowed values:


cfg_scalefloat ( default: 0.6 )

Adjusts prompt adherence strength. Use 0.7 for clarity, 0.3 for creativity.

min : 0,

max : 1


generate_audiobool ( default: true )

Toggle to generate audio. Enable for immersive scenes.

To keep track of your credit usage, you can inspect the response headers of each API call. The x-remaining-credits property will indicate the number of remaining credits in your account. Ensure you monitor this value to avoid any disruptions in your API usage.

Kling 3.0: Text-to-Video Model (1080p + Native Audio)

What is Kling 3.0?

Kling 3.0 (via fal.ai) is a generative text-to-video and image-to-video model built for cinematic 1080p video generation with native audio. It’s designed for creators and developers who need structured storytelling—not just single clips—thanks to multi-shot storyboarding, consistent subject rendering, and realistic motion. Kling’s strengths show up in scenes that require camera movement, physics-driven effects (fabric, hair, liquids), and coherent visual continuity across shots.

Kling 3.0 supports workflows such as start/end frame inputs and element referencing (using images or short videos) to maintain a consistent character or product appearance across multiple scenes. Two variants are commonly used: Kling V3 for cinematic, prompt-driven video creation, and Kling O3 for pipelines that prioritize character consistency and voice control.

Key Features

  • 1080p cinematic output with realistic camera motion and scene dynamics
  • Native audio generation (multilingual) for ambience, SFX, and narration-style soundbeds
  • Text-to-video + image-to-video for prompt-first or reference-driven creation
  • Multi-shot storyboarding for structured narratives and ad-style sequences
  • Element referencing to keep characters/objects consistent across shots
  • Strong physics realism: hair, fabric, liquid motion, and natural interactions

Best Use Cases

  • Marketing and creative: product trailers, social ads, brand films (16:9 or 9:16)
  • Entertainment: cinematic previs, short-form storytelling, anime/game cutscenes
  • E-commerce: consistent product shots across multiple scenes
  • Education: explainer videos with controlled pacing and clear visuals
  • Apps & tools: “prompt to video” editors, storyboard generators, UGC pipelines

Prompt Tips and Output Quality

  • Lead with subject + action + setting, then camera language: “dolly in,” “wide shot,” “handheld,” “slow pan.”
  • Specify lighting and mood (golden hour, neon noir, soft studio light) to stabilize style.
  • Use Negative Prompt to remove artifacts (e.g., “fog, noise, dark lighting”).
  • Tune CFG Scale (0–1):
    • ~0.7 = stronger prompt adherence and clarity
    • ~0.3 = more creative variation
  • Choose Aspect Ratio intentionally: 16:9 cinematic, 9:16 shorts, 1:1 square feeds.
  • Set Duration (3–15s): shorter for punchy ads, longer for multi-beat storytelling.
  • Keep Generate Audio enabled for immersive scenes; disable if you’ll add audio in post.

FAQs

Is Kling 3.0 text-to-video or image-to-video?
Both—use prompts for text-to-video or provide an image/reference for image-to-video.

Does Kling 3.0 generate sound?
Yes. Set generate_audio: true to produce native audio alongside the video.

How do I improve prompt accuracy?
Increase cfg_scale (e.g., ~0.7) and add concrete camera/lighting details.

What parameters should I tweak first?
Start with duration, aspect_ratio, cfg_scale, and negative_prompt for the biggest quality gains.

How is Kling V3 different from Kling O3?
V3 is optimized for cinematic prompt-driven generation; O3 is geared toward workflows needing stronger character consistency and voice control.