GEgenaipro
Veo V2

Text to Video

Changed on

Generate one or more videos from a text prompt. Returns immediately with 202 Accepted and task IDs for polling.

Example

curl -X POST https://genaipro.io/api/v2/veo/text-to-video \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A drone flying over mountains",
    "aspect_ratio": "VIDEO_ASPECT_RATIO_LANDSCAPE",
    "number_of_videos": 1
  }'

Omni 1.1, two 6-second 1080p clips with watermark:

curl -X POST https://genaipro.io/api/v2/veo/text-to-video \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A drone flying over mountains",
    "aspect_ratio": "VIDEO_ASPECT_RATIO_LANDSCAPE",
    "number_of_videos": 2,
    "model": "omni_flash",
    "duration": 6,
    "resolution": "1080p",
    "watermark": true
  }'

Rate limit: 30 requests/minute — shared across all four Veo creation endpoints.

post/v2/veo/text-to-video

Request

Request body

promptstring required

Text description of the video to generate

aspect_ratio'VIDEO_ASPECT_RATIO_LANDSCAPE' | 'VIDEO_ASPECT_RATIO_PORTRAIT' required

Video aspect ratio

number_of_videosinteger required

Number of videos to generate (1–4)

model'veo' | 'omni_flash'

Video model — veo (default) or omni_flash (Omni 1.1, see Video models in the Veo V2 tag). 403 omni_disabled if Omni is not enabled for your account.

duration4 | 6 | 8 | 10

Omni only — clip length in seconds.

resolution'360p' | '720p' | '1080p'

Omni only — output resolution (1080p = 720p + upscale; upscale_resolution is ignored for Omni).

watermarkboolean

Omni only — cheaper clip with a ✦ watermark. Requires resolution 720p or 1080p.

upscale_resolution'' | 'none' | '1080p'

Optional upscale resolution. Leave empty or none to disable upscale. 4k is not supported for video and returns 400. Veo only — ignored for omni_flash (use resolution instead).

callback_urlstring

Optional webhook URL. When the task reaches a terminal state (completed or failed), GenAIPro POSTs the task status (same shape as GET /v2/veo/tasks/{id}) to this URL.

Example request

{
  "prompt": "A cat walking on the beach at sunset",
  "aspect_ratio": "VIDEO_ASPECT_RATIO_LANDSCAPE",
  "number_of_videos": 2
}

Response

Task accepted for processing. Returns exactly one history item representing the parent task; use its id to poll GET /v2/veo/tasks/{id}.

Example response

{
  "histories": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "prompt": "A cat walking on the beach at sunset",
      "status": "processing",
      "created_at": "2026-04-03T10:00:00Z"
    }
  ]
}

Changes

  • 031a52a1288bRevision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

  • c2782cee0caaRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status