Skip to main content
POST
  1. After submission, a task_id will be returned. If you provided a callback_url, PoYo sends a POST request when the task becomes finished or failed.
  2. You can always retrieve the result through the unified Query Task Status endpoint.

Available Models

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

Input Routing

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.

Parameter Compatibility

Elements is a reference-image workflow that uses 1 to 4 images to guide the generated video. 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.

Key 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.

Pricing

  • kling-1.6/standard: 9 credits per second.
  • kling-1.6/pro: 15 credits per second.

Authorizations

Authorization
string
header
required

All API endpoints require Bearer Token authentication

Get your API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

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.

callback_url
string<uri>

Webhook callback URL for result notifications

Example:

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

Response

200 - application/json

Task submitted successfully

code
integer
required

HTTP status code

Example:

200

data
object
required