---
title: "create video by text or image or reference image"
method: POST
path: "/generation/sora/sora-2"
tags: ["generation", "video generation"]
---

# create video by text or image or reference image

`POST /generation/sora/sora-2`

## Request body

- object
  - `input` union, required
    - object
      - `image` string, uri, 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. Videos with human faces are not permitted. Images with an incorrect aspect ratio will be auto-cropped.
      - `prompt` string — The prompt of the generation
      - `length` 4 | 8 | 12 | 16 | 20, required — The length of the generation
      - `aspectRatio` '16:9' | '9:16'
    - object
      - `prompt` string, required — The prompt of the generation
      - `length` 4 | 8 | 12 | 16 | 20, required — The length of the generation
      - `aspectRatio` '16:9' | '9:16'
  - `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.net/pollo/apis/pollo-ai-video-collection.md) · [All operations](https://skmtc.net/pollo/apis/pollo-ai-video-collection/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pollo/pollo-ai-video-collection/versions/b3c228cf4e87/schema)