Skip to main content
Skip to main content

Kling Image V3

Kling IMAGE 3.0 is Kuaishou's image generation model from the Kling 3.0 family, launched globally February 5, 2026 - the generation model behind the 3.0-era image work.

  • 99.9% SLA
  • Official Discounts
  • Pay-as-you-go
  • Fast & Low Latency
Brand:KwaiVGIPrice: $0.031 / image

API DOCS / SIMPLIFIED

Integrate this model with one task-based API flow

Kling IMAGE 3.0 is Kuaishou's image generation model from the Kling 3.0 family, launched globally February 5, 2026 - the generation model behind the 3.0-era image work. The examples below are rendered from Kling Image V3, the current gateway base URL, and the selected public model contract using the active example "A young man with swept-back golden hair and angular jawline striding through a…".

Input mode
X-API-Key on every request
POST /api/v1/openapi/task
GET /api/v1/openapi/task/status/{task_id}
Async task workflow

Single code window

Switch language once. Each example already includes both the task creation request and the task status polling request.

Unified Example
API_KEY="<API_KEY>"
BASE_URL="https://api.musespark.ai"
REQUEST_BODY='{
  "model_id": "kling-image-v3",
  "parameters": {
    "prompt": "A young man with swept-back golden hair and angular jawline striding through a moody metropolitan street, wearing an intricately patterned gray suede jacket over a tonal gray top and dark trousers, painted in a contemporary hyperrealistic oil painting style with visible brushstrokes on the clothing texture and background architecture while maintaining photographic precision on the face and hair, the embossed floral pattern on the jacket rendered with thick impasto technique adding three-dimensional texture, background dissolving into impressionistic smears of urban gray and muted green suggesting storefronts and vehicles, warm undertone in the skin against the cool gray palette of the wardrobe, dramatic gallery-worthy portrait composition, inspired by the figurative realism of Jeremy Mann and Casey Baugh, museum-quality fine art",
    "image": "<IMAGE_URL>",
    "resolution": "1k",
    "aspect_ratio": "3:4",
    "batch_size": 1
  }
}'

CREATE_RESPONSE=$(curl --request POST "$BASE_URL/api/v1/openapi/task" \
  --header "X-API-Key: $API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw "$REQUEST_BODY")

TASK_ID="<TASK_ID_FROM_CREATE_RESPONSE>"

curl "$BASE_URL/api/v1/openapi/task/status/$TASK_ID" \
  --header "X-API-Key: $API_KEY"

Request and response JSON become the documentation

Keep the payload and task status envelope as the primary contract. Field descriptions, optionality, and enum hints now live inline as JSON comments.

Request Body

Caller payload

This is the request envelope accepted by the public gateway for the selected model contract.

Field comments and caller parameters come directly from the current item's model schema.
{
"model_id": "kling-image-v3",// target model
"parameters": {
"prompt": "A young man with swept-back golden hair and angular jawline striding through a moody metropolitan street, wearing an intricately patterned gray suede jacket over a tonal gray top and dark trousers, painted in a contemporary hyperrealistic oil painting style with visible brushstrokes on the clothing texture and background architecture while maintaining photographic precision on the face and hair, the embossed floral pattern on the jacket rendered with thick impasto technique adding three-dimensional texture, background dissolving into impressionistic smears of urban gray and muted green suggesting storefronts and vehicles, warm undertone in the skin against the cool gray palette of the wardrobe, dramatic gallery-worthy portrait composition, inspired by the figurative realism of Jeremy Mann and Casey Baugh, museum-quality fine art",// prompt for image generation · max 2500 · max length 2500
"image": "<IMAGE_URL>",// reference image for image-to-image generation · accept image/*
"resolution": "1k",// image generation resolution · enum: 1k | 2k
"aspect_ratio": "3:4",// aspect ratio of the generated image · enum: 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 3:2 | 2:3 | 21:9
"batch_size": 1// standard quantity control field. The allowed range for this item is 1-15 · min 1 · max 15
}
}
Response Body

Gateway response

This is the task status response you will query with task_id until the task reaches a terminal state.

Poll every 2-5 seconds and stop once status becomes completed, failed, cancelled.
{
"code": 200,// 200 on success
"msg": "success",
"data": {
"task_id": "task_01HQX8N2QJ0YQ8Q0T7G6N4V6K2",// use for status polling
"status": "completed",// enum: queued | running | completed | failed | cancelled
"progress": 100,// 0-100 if available
"completed_at": 1760000000,// unix timestamp
"expires_at": 1760001800,// unix timestamp
"result": {
"output_urls": [// generated files
"https://cdn.example.com/output.png"
]
}
}
}