KIE.AI
old-model
  • All Model
  • old-model
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
old-model
  • All Model
  • old-model
old-model
  • All Model
  • old-model
Suno API4o Image APIVeo3.1 API
Runway APIFlux Kontext API
Suno API4o Image APIVeo3.1 API
Runway APIFlux Kontext 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
  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
Bodyapplication/json

🔴500Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kie.ai/api/v1/veo/get-4k-video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "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