Kling 2.1

What this model is for

Use this page after trying Kling 2.1 in the APIXO playground. It shows the model ID, request body, result format, and the shared async workflow links you need for API integration.

Model ID, endpoint, and auth

Model ID: kling-2-1
Base URL: https://api.apixo.ai/api/v1

Method	Endpoint	Description
POST	`/api/v1/generateTask/kling-2-1`	Create generation task
GET	`/api/v1/statusTask/kling-2-1`	Query task status

Authentication

All requests require an API Key in the header:

Authorization: Bearer YOUR_API_KEY

Request Body

{
  "request_type": "async",
  "callback_url": "https://...",
  "provider": "auto",
  "input": {
    "mode": "standard-image-to-video",
    "prompt": "...",
    "duration": 5,
    "image_urls": ["..."],
    "aspect_ratio": "16:9",
    "negative_prompt": "...",
    "cfg_scale": 0.5
  }
}

Parameters

request_type

string

default:"async"

async (polling) or callback (webhook)

callback_url

string

Callback URL, required when request_type=callback (conditional)

provider

string

default:"auto"

Routing strategy: auto, value, or official

input

object

required

Model input parameters

Show properties

mode

string

default:"standard-image-to-video"

required

Generation mode (see options below)

prompt

string

required

Text description, 1-5000 characters

duration

integer

default:"5"

required

Video duration in seconds: 5 or 10

image_urls

string[]

Reference images, 1-2 depending on mode (conditional)

aspect_ratio

string

default:"16:9"

16:9, 9:16, or 1:1 (required for master-text-to-video) (conditional)

negative_prompt

string

Negative prompt, max 500 characters

cfg_scale

number

default:"0.5"

Guidance scale, 0-1, step 0.1

Mode Options:

standard-image-to-video — Standard tier image-to-video, requires 1 image
pro-image-to-video — Pro tier image-to-video, supports 1-2 images (end frame)
master-text-to-video — Master tier text-to-video
master-image-to-video — Master tier image-to-video, requires 1 image

Copy-paste quickstart

Standard Image-to-Video

curl -X POST "https://api.apixo.ai/api/v1/generateTask/kling-2-1" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "provider": "value",
    "input": {
      "mode": "standard-image-to-video",
      "prompt": "animate this still life scene with subtle camera movement",
      "duration": 5,
      "image_urls": ["https://example.com/std_ref.jpg"],
      "negative_prompt": "blur, low quality",
      "cfg_scale": 0.6
    }
  }'

Pro Image-to-Video (with End Frame)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/kling-2-1" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "callback",
    "callback_url": "https://your-server.com/callback",
    "provider": "official",
    "input": {
      "mode": "pro-image-to-video",
      "prompt": "city skyline timelapse from day to night",
      "duration": 10,
      "image_urls": [
        "https://example.com/pro_start.jpg",
        "https://example.com/pro_end.jpg"
      ],
      "cfg_scale": 0.4
    }
  }'

Master Text-to-Video

curl -X POST "https://api.apixo.ai/api/v1/generateTask/kling-2-1" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "master-text-to-video",
      "prompt": "a futuristic drone flying through neon-lit streets at night",
      "duration": 5,
      "aspect_ratio": "9:16",
      "negative_prompt": "grainy, noisy, static",
      "cfg_scale": 0.3
    }
  }'

Response and result format

POST /api/v1/generateTask/kling-2-1

Returns taskId on success for subsequent status queries. Success:

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_12345678"
  }
}

Error:

{
  "code": 400,
  "message": "Insufficient credits",
  "data": null
}

GET /api/v1/statusTask/kling-2-1

Query task execution status and results via taskId.

curl -X GET "https://api.apixo.ai/api/v1/statusTask/kling-2-1?taskId=task_12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"

Success:

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_12345678",
    "state": "success",
    "resultJson": "{\"resultUrls\":[\"https://r2.apixo.ai/video.mp4\"]}",
    "createTime": 1767965610929,
    "completeTime": 1767965652317,
    "costTime": 41388
  }
}

Failed:

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_12345678",
    "state": "failed",
    "failCode": "CONTENT_VIOLATION",
    "failMsg": "Content does not meet safety guidelines"
  }
}

Polling result fields

taskId

string

Unique task identifier.

state

string

Current task state: pending, processing, success, or failed.

resultJson

string

JSON string containing resultUrls array. Only present on success. Parse with JSON.parse().

failCode

string

Error code. Only present when state is failed. See Error Codes.

failMsg

string

Human-readable error message. Only present when state is failed.

createTime

integer

Task creation timestamp (Unix milliseconds).

completeTime

integer

Task completion timestamp (Unix milliseconds).

costTime

integer

Processing duration in milliseconds.

Polling and webhook result retrieval

Use request_type: "async" with the status endpoint when your app wants to poll for completion. Use request_type: "callback" with callback_url when your production service should receive the final result automatically. See Webhooks for delivery details.

Common errors

Code	Description
400	Invalid parameters or request error
401	Invalid or missing API Key
429	Rate limit exceeded

Fail Code	Description
`CONTENT_VIOLATION`	Content violates safety guidelines
`INVALID_IMAGE_URL`	Cannot access provided image URL

Rate Limits

Limit	Value
Requests	10000 / minute
Concurrent tasks	1000

Exceeding limits returns 429 error. Wait and retry.

Tips

Generation time:
- 5-second video: ~60-90 seconds
- 10-second video: ~90-120 seconds
- Submit task, wait 60 seconds, then poll every 5 seconds
Callback mode: Video generation takes time, strongly recommend using callback mode.
Video expiration: Result URLs are valid for 15 days. Download promptly.
Content moderation: Prompts must comply with content safety guidelines.
Tier selection:
- standard: Best value, for batch generation
- pro: Supports start/end frame control, for precise creation
- master: Highest quality, for professional production
End frame feature: pro mode supports 2 images — first as start frame, second as end frame.
Negative prompt: Use negative_prompt to avoid unwanted elements.
CFG Scale:
- Higher values: Follows prompt more strictly, may lose creativity
- Lower values: More creative, may deviate from prompt
- Recommended: 0.3-0.7
Image formats: image_urls supports JPG, PNG, WebP, max 10MB per image.

Video generation takes longer than images — use callback mode for production workloads. Result URLs expire after 15 days; download important outputs promptly.

Getting Started

Image Models

Video Models

Audio Models

What this model is for

Model ID, endpoint, and auth

Authentication

Request Body

Parameters

Copy-paste quickstart

Response and result format

POST /api/v1/generateTask/kling-2-1

GET /api/v1/statusTask/kling-2-1

Polling result fields

Polling and webhook result retrieval

Common errors

Rate Limits

Tips

Getting Started

Image Models

Video Models

Audio Models

Documentation Index

​What this model is for

​Model ID, endpoint, and auth

​Authentication

​Request Body

​Parameters

​Copy-paste quickstart

​Response and result format

​POST /api/v1/generateTask/kling-2-1

​GET /api/v1/statusTask/kling-2-1

​Polling result fields

​Polling and webhook result retrieval

​Common errors

​Rate Limits

​Tips

​Related links

What this model is for

Model ID, endpoint, and auth

Authentication

Request Body

Parameters

Copy-paste quickstart

Response and result format

POST /api/v1/generateTask/kling-2-1

GET /api/v1/statusTask/kling-2-1

Polling result fields

Polling and webhook result retrieval

Common errors

Rate Limits

Tips

Related links