KIE.AI
English
  • English
  • Chinese
English
  • English
  • Chinese
Support
English
  • English
  • Chinese
MarketVeo3.1 API
Suno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 API
Suno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Veo3.1 API
  • Veo3.1 API Quickstart
  • Veo3.1 Video Generation Callbacks
  • Get 4K Video Callbacks
  • Generate Veo3.1 Video
    POST
  • Get Veo3.1 Video Details
    GET
  • Get 1080P Video
    GET
  • Get 4K Video
    POST
  • Extend Veo3.1 Video
    POST
English
  • English
  • Chinese
Support
English
  • English
  • Chinese
MarketVeo3.1 API
Suno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 API
Suno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Veo3.1 API

Get 4K Video

POST
/api/v1/veo/get-4k-video
Get the ultra-high-definition 4K version of a Veo 3.1 video generation task.
Legacy note: If a task was generated via a deprecated fallback path, this endpoint may not apply.

Usage Instructions#

API method difference
1080P uses GET: /api/v1/veo/get-1080p-video
4K uses POST: /api/v1/veo/get-4k-video
Credit consumption
4K requires additional credits.
The extra cost is approximately equivalent to 2× “Fast mode” video generations (see pricing details for the latest).
Supported aspect ratios
Both 16:9 and 9:16 tasks support upgrading to 1080P and 4K.
Processing time
4K generation requires significant extra processing time — typically ~5–10 minutes depending on load.
If the 4K video is not ready yet, the endpoint may return a non-200 code. Wait and retry (recommended interval: 30s+) until the result is available.
For production use, we recommend using callBackUrl to receive automatic notifications when 4K generation completes, rather than polling frequently.

Callbacks#

After submitting a 4K video generation task, use the unified callback mechanism to receive generation completion notifications:
4K Video Generation Callbacks
Learn how to configure and handle 4K video generation callback notifications

Error Responses#

When submitting repeated requests for the same task ID, the system returns a 422 status code with specific error details:
4K Video Processing
4K Video Already Generated
{
  "code": 422,
  "msg": "4k is processing. It should be ready in 5-10 minutes. Please check back shortly.",
  "data": {
    "taskId": "veo_task_example123",
    "resultUrls": null,
    "imageUrls": null
  }
}

Callbacks

on4KVideoGenerated

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Request successful
Body

🔴500Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kie.ai/api/v1/veo/get-4k-video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "taskId": "veo_task_abcdef123456",
    "index": 0,
    "callBackUrl": "http://your-callback-url.com/4k-callback"
}'
Response Response Example
200 - Example 1
{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "veo_task_abcdef123456",
        "resultUrls": null,
        "imageUrls": null
    }
}
Previous
Get 1080P Video
Next
Extend Veo3.1 Video
Built with