id and poll the
retrieve endpoint until succeeded,
failed, or cancelled. Read completed videos from outputs.videos.
Request validation
- Kling 3.0 accepts prompts up to 2,500 characters in both modes.
- Kling 3.0 Turbo accepts up to 3,072 characters for text-to-video and 2,500 for image-to-video.
- Longer prompts are rejected with
provider.invalid_request; they are never silently truncated. - Watermarks are no longer supported. Omit
controls.watermarkor set it tofalse, which is accepted and ignored for compatibility.truereturns HTTP 400 with a clear unsupported-watermark message. The same rule applies to Kling watermark overrides; values must be boolean. - Only
kling-3.0andkling-3.0-turboaccept new requests. Previously created tasks remain queryable.
Error handling
Use
error_code for application logic. Error text and optional upstream diagnostic fields
are not stable identifiers. Terminal failed tasks expose failureReason.
Completion and output URLs
Customer webhook subscriptions are not available. Processing and reconciliation do not require an open browser. If a submission has an uncertain outcome but returns a task ID, keep polling that ID. Contact support if a disconnected submission returned no ID. Output URLs are signed and expire. Query the same task again to obtain a fresh URL for stored output, or copy the video to storage you control for durable access. Historical tasks may remain subject to their original output retention.Unsupported deletion
The public Kling API does not support cancellation or deletion. A sharedDELETE request
returns provider.operation_not_supported; it does not cancel generation or release its reservation.