Quick Answer
- Kling V3 supports Text-to-Video, Image-to-Video, R2V, and Video Edit in one workflow.
- Use this model guide page to validate parameters with minimal request/response examples.
- Stabilize prompts here first, then move to production API integration.
Key Parameters
- model | string | required | kling-v3 | - | Model identifier. Use exact API value.
- mode | enum | required | text-to-video | text-to-video | image-to-video | r2v | video-edit | Selects generation/edit workflow.
- input.prompt | string | required | - | - | Main instruction for output content and style.
- input.duration | integer | optional | 5 | 2-15 | Output duration in seconds.
- input.seed | integer | optional | - | >=0 | Improves reproducibility across runs.
Common Errors
- 400 invalid_request_error: trigger=Request payload misses required fields or has invalid field types.; fix=Validate model, mode, and input schema before request.; retry=Retry only after fixing payload; avoid blind retries.
- 401 authentication_error: trigger=Missing Authorization header or invalid API key.; fix=Verify Bearer token format and API key scope.; retry=Retry after auth fix; rotate key if repeated failures continue.
- 429 rate_limit_exceeded: trigger=Request rate, concurrency, or current quota hits upstream rate limiting.; fix=Apply exponential backoff first, then review request rate, concurrency, and quota usage.; retry=Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.
- 500 internal_error: trigger=Transient upstream error or internal processing failure.; fix=Capture request id and trigger retry workflow.; retry=Retry 2-3 times with short delays; escalate if persistent.


