Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt

Use this file to discover all available pages before exploring further.

Model ID 
kling-v3-image-to-video

​
Kling I2V (v3.0) API Documentation

Kling v3.0 is a professional-grade image-to-video foundation model. It specializes in cinematic 720p generation with native audio-visual synchronization and precise “start-to-end” frame guidance.

​
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

  • Duration: 3-15 seconds
  • Resolution: Cinematic 720p
  • Features: Native Audio, Start/End Frame Guidance

​
3. Motion & Guidance Logic

​
Start & End Frame Guidance

You can provide both a starting image (image) and an ending image (image_tail) to dictate the exact transition of the video. The model intelligently interpolates the motion between these two specific visual states.

​
Native Audio Generation

When ‘sound’ is enabled, the model generates synchronized ambient sound or dialogue based on the prompt. This increases the per-second rate to $0.252.

​
4. Parameter Reference

ParameterTypeRequiredDescription
promptstringYesDescribe the motion and action (up to 2500 chars).
imagestringYesThe starting frame image (Base64 string or URL).
image_tailstringNoOptional end frame image to guide the video’s conclusion.
negative_promptstringNoElements to exclude (e.g., ‘blurry, distorted’).
durationenumNoTotal duration in seconds (3-15). Default: “5”.
soundenumNoGenerate synchronized audio. Options: “on”, “off”.

​
5. Example CURL Request

curl -X POST "[https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests](https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests)" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-image-to-video",
    "payload": {
      "image": "[https://example.com/start_frame.jpg](https://example.com/start_frame.jpg)",
      "image_tail": "[https://example.com/end_frame.jpg](https://example.com/end_frame.jpg)",
      "prompt": "A cinematic shot of a dragon taking flight from a cliffside.",
      "duration": "5",
      "sound": "on"
    }
  }'

​
6. Checking Request Status

Endpoint: GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
```text
- 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.