メインコンテンツへスキップ
POST
/
v1
/
videos
/
generations
kling-3.0-turbo 動画生成
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "reference_images": [
    "<string>"
  ],
  "resolution": "<string>",
  "duration": 123,
  "aspect_ratio": "<string>",
  "watermark": true
}
'
  • Async task API, returns a task ID after submission
  • Uses the new official Kling Turbo upstream protocol
  • Supports text-to-video and image-to-video with first-frame input only
  • resolution supports 720p and 1080p
  • duration supports 3s, 4s, 5s, 6s, 7s, 8s, 9s, 10s, 11s, 12s, 13s, 14s, 15s
  • aspect_ratio applies to text-to-video requests
  • watermark is a boolean toggle only; custom watermark payloads are not supported
Use publicly accessible image URLs. Do not pass base64 image data. Upload local images with the Upload 画像API first.

Authorization

Authorization
string
必須
All endpoints require Bearer Token authentication.
Authorization: Bearer YOUR_API_KEY

リクエストパラメータ

model
string
必須
Video generation model name, fixed as kling-3.0-turbo.
prompt
string
必須
Text prompt. For image-to-video, this is sent to Kling Turbo as the prompt content item.
reference_images
string[]
任意 input images. For Kling Turbo image-to-video, only the first image is used as first_frame.
Tail frame input is not supported in this integration. Additional input images are ignored.
resolution
string
デフォルト:"720p"
Video resolution.Supported values:
  • 720p
  • 1080p
duration
integer
デフォルト:"5"
Video duration in seconds.Supported values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
aspect_ratio
string
デフォルト:"16:9"
Video aspect ratio for text-to-video.Supported values:
  • 16:9
  • 9:16
  • 1:1
watermark
boolean
デフォルト:"false"
Whether to add the official Kling watermark.

Examples

Text-to-Video

{
  "model": "kling-3.0-turbo",
  "prompt": "A cinematic shot of a red sports car driving through rain",
  "resolution": "720p",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Image-to-Video

{
  "model": "kling-3.0-turbo",
  "prompt": "Animate the character with subtle camera motion",
  "reference_images": ["https://example.com/first-frame.png"],
  "resolution": "1080p",
  "duration": 5,
  "watermark": true
}
Video generation is asynchronous. Use the Get Video Task ステータス endpoint to query progress and results.