# kling-v3.0-omni-standard-image-to-video > Kling v3 Omni at 720P. Multi-image reference video generation — supply up to 4 images and reference them in your prompt with <<>>. Apimart-backed. ## Overview - **Endpoint**: `POST https://api.muapi.ai/api/v1/kling-v3.0-omni-standard-image-to-video` - **Model ID**: `kling-v3.0-omni-standard-image-to-video` - **Category**: image to video - **Variant**: Omni Standard I2V - **Family**: kling-v3-omni - **Cost**: 0.42 credits per call (some models compute cost dynamically based on params) ## API Usage MuApi uses a **submit-then-poll** pattern: submit a job, get a `request_id`, then poll the predictions endpoint until `status` is `completed`. Optionally pass `?webhook=YOUR_URL` on the submit call to receive a POST callback when the job finishes (skip polling). **Authentication**: send your MuApi key in the `x-api-key` header. Get one at https://muapi.ai/access-keys. ### 1. Submit a job ```http POST https://api.muapi.ai/api/v1/kling-v3.0-omni-standard-image-to-video Content-Type: application/json x-api-key: YOUR_API_KEY ``` **Minimum (required only):** ```json { "prompt": "", "images_list": "https://d3adwkbyhxyrtq.cloudfront.net/webassets/videomodels/kling-v3.0-omni-standard-image-to-video.jpg" } ``` **Full example (all params):** ```json { "prompt": "", "images_list": "https://d3adwkbyhxyrtq.cloudfront.net/webassets/videomodels/kling-v3.0-omni-standard-image-to-video.jpg", "aspect_ratio": "16:9", "duration": 5, "generate_audio": false } ``` **Response:** ```json { "request_id": "abc123", "status": "processing" } ``` ### 2. Poll for the result ```http GET https://api.muapi.ai/api/v1/predictions/{request_id}/result x-api-key: YOUR_API_KEY ``` Possible `status` values: `queued`, `pending`, `processing`, `completed`, `failed`, `cancelled`. Poll every 2-5 seconds until terminal. When `completed`, the result URLs are in the `outputs` array. **Example response when `completed`:** ```json { "id": "abc123", "status": "completed", "outputs": [ "https://cdn.muapi.ai/.../output.png" ], "urls": { "get": "https://api.muapi.ai/api/v1/predictions/abc123/result" }, "created_at": "2026-05-08T12:34:56Z", "has_nsfw_contents": [] } ``` ### cURL ```bash # 1. Submit REQUEST_ID=$(curl -s -X POST https://api.muapi.ai/api/v1/kling-v3.0-omni-standard-image-to-video \ -H "x-api-key: $MUAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt":"","images_list":"https://d3adwkbyhxyrtq.cloudfront.net/webassets/videomodels/kling-v3.0-omni-standard-image-to-video.jpg"}' | jq -r .request_id) # 2. Poll until completed while :; do RESP=$(curl -s https://api.muapi.ai/api/v1/predictions/$REQUEST_ID/result -H "x-api-key: $MUAPI_API_KEY") STATUS=$(echo "$RESP" | jq -r .status) [ "$STATUS" = "completed" ] && echo "$RESP" | jq .outputs && break [ "$STATUS" = "failed" ] && echo "$RESP" && exit 1 sleep 3 done ``` ### Python ```python import os, time, requests API = "https://api.muapi.ai/api/v1" headers = {"x-api-key": os.environ["MUAPI_API_KEY"]} r = requests.post(f"{API}/kling-v3.0-omni-standard-image-to-video", headers=headers, json={"prompt":"","images_list":"https://d3adwkbyhxyrtq.cloudfront.net/webassets/videomodels/kling-v3.0-omni-standard-image-to-video.jpg"}) request_id = r.json()["request_id"] while True: res = requests.get(f"{API}/predictions/{request_id}/result", headers=headers).json() if res["status"] == "completed": print(res["outputs"]); break if res["status"] == "failed": raise RuntimeError(res.get("error")); time.sleep(3) ``` ## Input Schema The API accepts the following input parameters: - **`prompt`** (`string`, _required_): Text prompt. Reference images via <<>> (1-indexed). If omitted, <<>> is auto-prepended. - **`images_list`** (`array`, _required_): Up to 4 reference images. Address them in the prompt with <<>> through <<>>. - **`aspect_ratio`** (`string`, _optional_): Aspect ratio of the output video. - Default: `"16:9"` - Options: `"9:16"`, `"16:9"`, `"1:1"` - **`duration`** (`int`, _optional_): Duration of the generated video in seconds. - Default: `5` - Options: `"3"`, `"4"`, `"5"`, `"6"`, `"7"`, `"8"`, `"9"`, `"10"`, `"11"`, `"12"`, `"13"`, `"14"`, `"15"` - **`generate_audio`** (`boolean`, _optional_): When enabled, generate native audio with the video (adds to cost). - Default: `false` ## Output Schema The polling endpoint returns the following fields: - **`id`** (`string`): The request ID. - **`status`** (`string`): One of `queued`, `pending`, `processing`, `completed`, `failed`, `cancelled`. - **`outputs`** (`array`): URLs to generated images/videos/audio. Empty until `status` is `completed`. - **`urls.get`** (`string`): Self-link to re-fetch this prediction. - **`error`** (`string` | `null`): Error message if `status` is `failed`. - **`created_at`** (`string`): ISO-8601 timestamp of when the request was created. - **`has_nsfw_contents`** (`array of boolean`): Per-output NSFW detection flags. ## Webhooks (optional) Append `?webhook=https://your-server/path` to the submit URL. When the job reaches a terminal state, MuApi will POST the same shape as the polling response to your URL — no polling needed. ## Agent Integration MuApi ships an MCP server and CLI so agents (Claude Code, Cursor, custom) can call this endpoint without writing HTTP code: ```bash # Install the CLI npm install -g muapi-cli # Authenticate once muapi auth login # Expose all MuApi models as MCP tools to your agent muapi mcp serve ``` The MCP server exposes tools that wrap submit + poll for every model, including `kling-v3.0-omni-standard-image-to-video`. See `muapi --help` for category-specific shortcuts (`muapi image generate`, `muapi video from-image`, etc.). ## Related Models - [Omni Standard T2V](https://muapi.ai/playground/kling-v3.0-omni-standard-text-to-video) - [Omni Standard I2V](https://muapi.ai/playground/kling-v3.0-omni-standard-image-to-video) - [Omni Pro I2V](https://muapi.ai/playground/kling-v3.0-omni-pro-image-to-video) - [Omni 4K I2V](https://muapi.ai/playground/kling-v3.0-omni-4k-image-to-video) - [Omni 4K T2V](https://muapi.ai/playground/kling-v3.0-omni-4k-text-to-video) - [Omni Pro T2V](https://muapi.ai/playground/kling-v3.0-omni-pro-text-to-video) ## Resources - [Playground Page](https://muapi.ai/playground/kling-v3.0-omni-standard-image-to-video) - [API Reference](https://muapi.ai/playground/kling-v3.0-omni-standard-image-to-video?tab=2) - [Global llms.txt](https://muapi.ai/llms.txt)