Kling 1.6 - PoYo AI

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-1.6/standard",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "A quiet city street after rain, soft reflections on the pavement as the camera moves forward",
    "duration": 5,
    "aspect_ratio": "16:9",
    "negative_prompt": "blur, low quality, distorted hands",
    "cfg_scale": 0.5
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2025-11-12T10:30:00"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

POST

api

generate

submit

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-1.6/standard",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "A quiet city street after rain, soft reflections on the pavement as the camera moves forward",
    "duration": 5,
    "aspect_ratio": "16:9",
    "negative_prompt": "blur, low quality, distorted hands",
    "cfg_scale": 0.5
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2025-11-12T10:30:00"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

Models

kling-1.6/standard - Cost-effective Kling 1.6 video generation
kling-1.6/pro - Higher-quality Kling 1.6 video generation

Features

Text to Video: Generate videos from a prompt, duration, and optional aspect ratio.
Image to Video: Animate a first frame image, with optional Pro-only last frame control.
Elements: Use 1 to 4 reference images to guide the generated video.
Durations: 5 or 10 seconds.
Aspect Ratios: 1:1, 16:9, and 9:16. Standard uses aspect_ratio for text-to-video and elements. Standard image-to-video does not support aspect_ratio. Pro supports it across Kling 1.6 workflows.
Prompt Controls: Optional negative_prompt; cfg_scale is available for text-to-video and image-to-video, but not for elements.

Input modes

PoYo does not require a public mode, type, or task_type field for Kling 1.6. All Kling 1.6 requests require prompt and duration.

Provide no image fields to generate text-to-video.
Provide start_image_url to generate image-to-video.
Provide start_image_url and end_image_url with kling-1.6/pro to control both the first and last frame.
Provide image_urls with 1 to 4 reference images to generate Elements.

image_urls cannot be used together with start_image_url, end_image_url, or cfg_scale.

Notes

Parameter Compatibility

Elements is a reference-image workflow that uses 1 to 4 images to guide the generated video.

Model and workflow	How PoYo detects it	Supported parameters
Text to Video (`standard` or `pro`)	No image fields	`prompt`, `duration`, `aspect_ratio`, `negative_prompt`, `cfg_scale`
Standard Image to Video	`kling-1.6/standard` with `start_image_url`	`prompt`, `duration`, `start_image_url`, `negative_prompt`, `cfg_scale`
Pro Image to Video	`kling-1.6/pro` with `start_image_url` and optional `end_image_url`	`prompt`, `duration`, `aspect_ratio`, `start_image_url`, `end_image_url`, `negative_prompt`, `cfg_scale`
Elements (`standard` or `pro`)	`image_urls`	`prompt`, `duration`, `aspect_ratio`, `negative_prompt`, `image_urls`

Notes:

end_image_url requires start_image_url and is only supported by kling-1.6/pro.
kling-1.6/standard image-to-video does not support aspect_ratio.
Elements supports 1 to 4 image_urls and does not support cfg_scale.

Authorizations

Authorization

string

header

required

All API endpoints require Bearer Token authentication.

Create an API key: sign in to PoYo, open Dashboard → API Key at poyo.ai/dashboard/api-key, and click to create a key.

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

required

Kling 1.6 public model identifier

Available options:

kling-1.6/standard,

kling-1.6/pro

input

object

required

Input parameters for generation. PoYo selects the generation workflow from the provided image fields.

Show child attributes

callback_url

string<uri>

Webhook callback URL for result notifications

Example:

"https://your-domain.com/callback"

Response

Task submitted successfully

code

enum<integer>

required

Business status code. 200 means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with code: 400 in the body.

200: Success
400: Invalid request parameters
401: Missing or invalid API key
402: Insufficient credits
403: Permission denied
404: Resource not found
408: Request timeout
429: Rate limit exceeded
500: Internal server error
502: Upstream service error
503: Service unavailable

See Error Codes for details.

Available options:

200,

400,

401,

402,

403,

404,

408,

429,

500,

502,

503

Example:

200

data

object

required

Show child attributes

​Models

​Features

​Input modes

​Notes

​Parameter Compatibility

Authorizations

Body

Response

Models

Features

Input modes

Notes

Parameter Compatibility