Skip to main content
Model ID 
kling-3.0-turbo-i2v
Calling method: async

​
Kling I2V (v3.0 Turbo) API Documentation

Kling v3.0 Turbo is a high-speed image-to-video foundation model. It animates a single source image into cinematic video, with an optional text prompt to direct the motion and selectable resolution (720p/1080p), optimized for fast “turbo” generation.

​
1. API Endpoint & Authentication

Base URL: https://console.gmicloud.ai Endpoint: POST /api/v1/ie/requestqueue/apikey/requests Header: Authorization: Bearer YOUR_API_KEY Content-Type: application/json

​
2. Model Specifications

  • Pricing: 0.112persecond(0.112 per second (0.14 per second at 1080p)
  • Duration: 3-15 seconds
  • Resolution: 720p (default) or 1080p
  • Features: Turbo (accelerated) generation, single-image animation, optional prompt-guided motion

​
3. Generation Logic

​
Image-to-Video Synthesis

Provide a starting frame image and the model animates it into video. A text prompt is optional. Supplying one lets you steer the motion and action; omitting it lets the model infer plausible motion from the image alone.

​
Resolution

Output defaults to 720p at the base rate. Selecting 1080p increases the per-second rate to $0.14. The output framing follows the dimensions of the source image.

​
4. Parameter Reference

ParameterTypeRequiredDescription
first_frameimageYesThe starting frame image for video generation (Base64 string or URL).
promptstringNoDescribe the motion and action (up to 2500 chars).
resolutionenumNoOutput resolution: ‘720p’ or ‘1080p’. Default: “720p”.
durationenumNoTotal duration in seconds (3-15). Default: “5”.

​
5. Example CURL Request

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo-i2v",
    "payload": {
      "first_frame": "https://example.com/start_frame.jpg",
      "prompt": "A cinematic shot of a dragon taking flight from a cliffside.",
      "resolution": "720p",
      "duration": "5"
    }
  }'

​
6. Checking Request Status

Endpoint: GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
  • queued: Request is waiting to be processed by GPU resources.
  • processing: Video generation is currently in progress.
  • success: Generation completed. URLs available in outcome.media_urls.
  • failed: Video generation failed. Check logs for details.