Video modelsAdvanced usersUpdated
POST/v1/videos/generations

API console

POST/v1/videos/generations
View keys

Requests use the API key you enter and follow standard API billing.

Kling V3 Omni

Request ID kling-v3-omni

Protocols

Authentication

Requests require an API key from API key management. For JSON requests, set Content-Type: application/json.

  • Authorization: Bearer YOUR_API_KEY

Request parameters

POST /v1/videos/generations

FieldTypeRequiredDescription
modelstringRequiredkling-v3-omni. Use the model ID shown on this page.
promptstringConditionalDescribe the scene, action, and camera movement. When a text prompt is required, use this field or a content item of type text.
contentarray<object>ConditionalList of reference assets and optional text items. Omit for text-only generation using prompt. Up to 2 images.
content[].typestringRequiredAccepted values are text, image_url, input_image.
content[].textstringConditionalProvide the prompt when the content item has type: "text".
content[].rolestringConditionalUse first_frame and last_frame. A last frame requires a first frame. You can instead supply up to two general reference images with no role. Do not mix frames with general references.
content[].asset_idstringConditionalUpload to POST /v1/videos/assets and use the returned id. Send kind (image) before file in the multipart form. The asset must belong to your account. Use its ID or the corresponding public HTTPS URL.
content[].image_urlstringConditionalPublic HTTPS image URL as a plain string.
resolutionstringOptionalAccepted values are 720p, 1080p, 4K. Default: 720p.
ratiostringOptionalOutput aspect ratio. Also accepts the alias aspect_ratio. Accepted values are 16:9, 9:16, 1:1. Default: 9:16.
durationintegerOptionalOutput length in seconds. Accepts whole seconds from 3 to 15. Default: 5.
generate_audiobooleanOptionalWhether to generate an audio track. Default: true.

Request examples

Set your API key in the local ICODEEASY_API_KEY environment variable and choose an endpoint that accepts direct HTTP calls. For endpoints that require a specific client, follow that client’s setup guide.

Replace example media URLs and asset IDs with your own valid assets.

Video Generations

bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "kling-v3-omni",
  "prompt": "Slow camera push toward a paper lantern swaying gently by a lake.",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5
}'

Check video task

bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

Download video

bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID/content' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -L \
  -o result.mp4

Delete a finished video task

bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -i \
  -X DELETE

Responses and tasks

HTTP 202 · Task accepted

json
{
  "id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "model": "kling-v3-omni",
  "created_at": "2026-07-30T08:00:00Z",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "queued",
  "updated_at": "2026-07-30T08:00:00Z",
  "task_id": "vid_1785398400000000000"
}

HTTP 200 · Completed task lookup

json
{
  "id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "model": "kling-v3-omni",
  "created_at": "2026-07-30T08:00:00Z",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "succeeded",
  "updated_at": "2026-07-30T08:01:00Z",
  "url": "/v1/videos/tasks/vid_1785398400000000000/content"
}

Save id. With the same API key, send GET requests to status_url until status is succeeded or failed. On success, download from content_url and follow HTTP redirects. Both paths are relative to the API base URL.

FieldTypeDescription
id / task_idstringTask ID. In the creation response, task_id equals id.
statusstringTask state, one of queued, running, succeeded, or failed.
progressintegerGeneration progress. Omitted when the service has no progress value.
error.codestringError classification for failed tasks.

Common errors

HTTPError typeDescription
400invalid_requestCheck the model, parameter combination, and reference media.
401unauthorizedCheck whether the API key is missing, invalid, or disabled.
402insufficient_balanceThe balance is insufficient to submit the task.
404not_foundIf polling returns 404, keep the task ID and check the polling URL and API key for the account that created the task. It may already have finished. Do not resubmit on this basis.
409video_not_readyThe video is still being generated. Continue polling.
503submission_unknownThe submission outcome is unknown. Contact support to check whether a task was created before sending a new request.

Full integration guide · See the full API guide for request fields, task states, and response formats.

Capabilities and limits

  • text_to_video · Supported
  • image_to_video · Supported
  • first_frame · Supported
  • last_frame · Supported
  • audio · Supported
  • reference_images · Supported
  • Limits Resolutions: 720p, 1080p, 4K · Aspect ratios: 16:9, 9:16, 1:1 · Durations: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 · Reference images: up to 2 · Input: Use first and last frames or up to two role-free reference images.

Model Capability Catalog · View pricing

Related guides

Video Generation API

Create video tasks from text, first and last frames, or references; poll status, download results, and delete finished tasks when needed.

Model Capability Catalog

Compare public text, image, and video models by normalized request ID, compatible protocols, supported clients, tool use, media capabilities, limits, and review date.

Sign up and get an API key