---
title: "create image by text or image"
method: POST
path: "/generation/kling-ai/kling-v3-omni/image"
tags: ["generation", "image generation"]
---

# create image by text or image

`POST /generation/kling-ai/kling-v3-omni/image`

## Request

- Base URL: `https://pollo.ai/api/platform`
- URL: `https://pollo.ai/api/platform/generation/kling-ai/kling-v3-omni/image`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/pollo/apis/pollo-ai-video-collection/docs/generation/kling-ai/kling-v3-omni/image/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `input` union, required
    - object
      - `prompt` string, required: The prompt of the generation
      - `resolution` '1k' | '2k' | '4k': The resolution of the generation
      - `resultType` 'single' | 'series'
      - `n` integer
      - `aspectRatio` '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '3:2' | '2:3' | '21:9' | 'auto'
      - `imageUrl` string, required
      - `images` string[]: Only image URLs are accepted (HTTPS preferred); base64 is not allowed. Supported formats include JPG, PNG, and JPEG. Image aspect ratio must be less than 1:4 or 4:1.
    - object
      - `prompt` string, required: The prompt of the generation
      - `resolution` '1k' | '2k' | '4k': The resolution of the generation
      - `resultType` 'single' | 'series'
      - `n` integer
      - `aspectRatio` '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '3:2' | '2:3' | '21:9' | 'auto'
      - `imageUrl` string
      - `images` string[], required: Only image URLs are accepted (HTTPS preferred); base64 is not allowed. Supported formats include JPG, PNG, and JPEG. Image aspect ratio must be less than 1:4 or 4:1.
    - object
      - `prompt` string, required: The prompt of the generation
      - `aspectRatio` '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '3:2' | '2:3' | '21:9' | 'auto'
      - `resolution` '1k' | '2k' | '4k': The resolution of the generation
      - `resultType` 'single' | 'series'
      - `n` integer
  - `webhookUrl` string
  - `clientSource` string

## Response `200`

Successful response

- object
  - `taskId` string, required
  - `status` 'waiting' | 'succeed' | 'failed' | 'processing', required

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/pollo/apis/pollo-ai-video-collection.md) - [All operations](https://skmtc.dev/pollo/apis/pollo-ai-video-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/pollo/apis/pollo-ai-video-collection/revisions/b3c228cf4e87?raw)