Skip to main content
GET
Retrieve a Kling 4.0 task
Use the GENGEN API key that owns the task and preserve the complete kling40: ID returned by creation. Poll until succeeded or failed. A successful result contains outputs.videos; save the video to your own storage because download links expire. Query the task again to obtain a refreshed link. Success is returned after output storage and billing settlement; repeated queries do not charge for generation again. Do not submit a replacement task after a timeout or uncertain creation response. If no task ID was returned, contact support before retrying.

Usage

On success, usage.hasVideoInput indicates whether video input affected the charge. Without video input, billableSeconds equals outputDurationSeconds. With video input, it equals outputDurationSeconds + max(inputVideoDurationSeconds, outputDurationSeconds). For example, 8 seconds of input and 5 seconds of output give 13 billable seconds. usage.resolution is the pricing tier string. Multiply billableSeconds by the per-second rate for usage.priceRowId in the price catalog.

Authorizations

Authorization
string
header
required

GENGEN API key

Path Parameters

id
string
required

Complete task ID returned by creation; use the owning GENGEN API key.

Pattern: ^kling40:[0-9a-f-]{36}$

Response

Task status. Save the complete public ID. Success is delivered after output storage and settlement.

id
string
required
Pattern: ^kling40:[0-9a-f-]{36}$
model
enum<string>
required

Always kling-4.0.

Available options:
kling-4.0
status
enum<string>
required
  • pending: Task accepted and awaiting processing.
  • processing: Generation, output storage or billing settlement is in progress.
  • succeeded: Output is stored and billing is settled; read outputs.videos.
  • failed: Task failed; see failureReason.
Available options:
pending,
processing,
succeeded,
failed
outputs
object
required
usage
object

Successful task detail. With video input, billable seconds equal output seconds plus the greater of input and output seconds. Otherwise only output seconds are charged.

createdAt
string<date-time>
failureReason
string

Present when the task fails.