Kling 3.0 Turbo

Kling 3.0 Turbo provides separate asynchronous task APIs for text-to-video and image-to-video generation.

Text to video

Item	Value
Method	`POST`
URL	`https://api.tokenhub.belivestudios.com/text-to-video/kling-3.0-turbo`
Authentication	Header `Authorization: Bearer sk-your-belive-studios-key`
Content-Type	`application/json`

curl https://api.tokenhub.belivestudios.com/text-to-video/kling-3.0-turbo \
  -H "Authorization: Bearer sk-your-belive-studios-key" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A girl sits on a train and looks out the window, her head swaying gently with the train.",
  "settings": {
    "resolution": "720p",
    "aspect_ratio": "9:16",
    "duration": 3
  },
  "options": {
    "watermark_info": {
      "enabled": false
    }
  }
}'

Field	Type	Required	Default	Values	Description
`prompt`	string	Yes	—	—	Positive or negative text prompt; maximum 3,072 characters, with 2,500 recommended.
`settings`	object	No	—	—	Resolution, aspect ratio, and duration settings.
`settings.resolution`	string	No	`720p`	`720p`, `1080p`	Output resolution.
`settings.aspect_ratio`	string	No	`16:9`	`16:9`, `9:16`, `1:1`	Output aspect ratio.
`settings.duration`	integer	No	`5`	`3`–`15`	Duration in seconds.
`options`	object	No	—	—	Callback, custom task ID, and watermark settings.
`options.callback_url`	string	No	—	—	Callback URL for status updates.
`options.external_task_id`	string	No	—	—	Account-unique custom task ID.
`options.watermark_info`	object	No	—	—	Watermark configuration.
`options.watermark_info.enabled`	boolean	No	`false`	—	Whether to generate a watermarked result.

Multi-shot prompts use shot n, m, words; syntax, with up to six shots. Each shot must be at least one second, and shot durations must sum to settings.duration; each shot prompt is limited to 512 characters.

Create response

The create response returns a system task ID. status starts as submitted and may become processing, succeeded, or failed.

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "id": "893605946402811985",
    "status": "submitted",
    "create_time": 1781080778802,
    "update_time": 1781080794151,
    "external_id": "text-task-001"
  }
}

Field	Type	Description
`code`	integer	Error code; `0` indicates success.
`message`	string	Error or status message.
`request_id`	string	System-generated request ID.
`data.id`	string	System-generated task ID.
`data.status`	string	`submitted`, `processing`, `succeeded`, or `failed`.
`data.create_time` / `update_time`	integer	Creation/update time as Unix milliseconds.
`data.external_id`	string	Custom task ID, when provided.

Query by task ID

GET https://api.tokenhub.belivestudios.com/tasks requires exactly one of task_ids and external_task_ids; comma-separated batches are supported.

Query parameter	Type	Required	Description
`task_ids`	string	One of two	System task IDs, comma-separated for batches.
`external_task_ids`	string	One of two	Custom task IDs, comma-separated for batches.

curl "https://api.tokenhub.belivestudios.com/tasks?external_task_ids=text-task-001" \
  -H "Authorization: Bearer sk-your-belive-studios-key" \
  -H "Content-Type: application/json"

Query response

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": [
    {
      "id": "893605946402811985",
      "status": "succeeded",
      "message": "string",
      "create_time": 1781080778802,
      "update_time": 1781080794151,
      "external_id": "text-task-001",
      "outputs": [
        {
          "type": "video",
          "id": "video-output-id",
          "url": "string",
          "watermark_url": "string",
          "duration": "10"
        }
      ],
      "billing": [
        {
          "charge_type": "unit",
          "amount": "1",
          "package_type": "video"
        }
      ]
    }
  ]
}

data[].message may contain the failure reason. Video outputs contain type, id, url, watermark_url, and duration. The common task API may also return image (url, watermark_url, group_id), audio (id, MP3/WAV URLs and durations), voice, or element outputs. Billing entries may contain charge_type, cash_type, amount, currency, package_type, and list_price. Result URLs are cleaned up after 30 days.

Cursor query

POST https://api.tokenhub.belivestudios.com/tasks

This endpoint only queries asynchronous, non-real-time tasks. For the first request, use a time range and filters. For subsequent pages, pass the previous response's data.next_cursor as cursor; when cursor is supplied, start_time and end_time are ignored.

Field	Type	Default	Description
`start_time`	string	30 days before `end_time`	Start of creation-time range, Unix milliseconds; must be earlier than `end_time`.
`end_time`	string	Current time	End of creation-time range, Unix milliseconds.
`cursor`	string	—	Previous `data.next_cursor`; when supplied, the time range is ignored.
`limit`	integer	`100`	Number of tasks, maximum 500.
`filters[].key`	string	—	`status` or `product_type`.
`filters[].values`	array	—	Status values: `submitted`, `processing`, `succeeded`, `failed`; product types: `video`, `image`, `try_on`.

The response contains data.result, data.count, data.next_cursor, and data.has_more; result fields match the task-ID query. To fetch the next page, pass data.next_cursor as cursor in the next request:

{
  "cursor": "data.next_cursor from the previous response",
  "limit": 100,
  "filters": [
    {
      "key": "product_type",
      "values": ["video"]
    }
  ]
}