Skip to main content
Kling tasks are asynchronous. Save the returned GENGEN 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.watermark or set it to false, which is accepted and ignored for compatibility. true returns HTTP 400 with a clear unsupported-watermark message. The same rule applies to Kling watermark overrides; values must be boolean.
  • Only kling-3.0 and kling-3.0-turbo accept 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 shared DELETE request returns provider.operation_not_supported; it does not cancel generation or release its reservation.