curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gemini-omni-1.2-flash-image-to-video",
  "prompt": "The person slowly turns their head and smiles while leaves in the background sway gently in the wind.",
  "image_urls": [
    "https://example.com/portrait.jpg"
  ],
  "quality": "720p",
  "aspect_ratio": "16:9",
  "duration": 3
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 60,
    "video_duration": 3
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_token",
    "credits_reserved": 102.34,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: gemini-omni-1.2-flash-image-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Gemini Omni 1.2 Flash

Gemini Omni 1.2 Flash Image-to-Video

Gemini Omni 1.2 Flash (gemini-omni-1.2-flash-image-to-video) generates video with native audio from images and a text prompt.
First and last frames: image_urls accepts 1–2 images. One image supplies the first frame. With two images, the first is the starting frame and the second is the ending frame; the model generates the transition. A last frame cannot be supplied alone.
Resolution: quality accepts 360p, 720p, 1080p, or 4k; default 720p.
Duration: Integer seconds via duration, default 3. One first frame supports 3–15 seconds; a first-and-last-frame pair supports 3–10 seconds.
Aspect ratio: 16:9, 9:16, or auto; default auto.
Synchronized native audio is generated automatically, with no additional parameter.
Write negative requirements directly in prompt (for example, No dialogue); there is no separate negative prompt parameter.
Set seed to improve reproducibility.
Asynchronous processing: use the returned task ID to query task status.
Generated video links remain valid for 24 hours; save them promptly.

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gemini-omni-1.2-flash-image-to-video",
  "prompt": "The person slowly turns their head and smiles while leaves in the background sway gently in the wind.",
  "image_urls": [
    "https://example.com/portrait.jpg"
  ],
  "quality": "720p",
  "aspect_ratio": "16:9",
  "duration": 3
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 60,
    "video_duration": 3
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_token",
    "credits_reserved": 102.34,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: gemini-omni-1.2-flash-image-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Authorizations

Authorization

string

header

required

##All endpoints require authentication using a Bearer Token##

Get your API Key:

Visit the API Key management page to obtain your API Key

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

default:gemini-omni-1.2-flash-image-to-video

required

Model name, fixed to gemini-omni-1.2-flash-image-to-video

Available options:

gemini-omni-1.2-flash-image-to-video

Example:

"gemini-omni-1.2-flash-image-to-video"

prompt

string

required

Text prompt describing how the first frame should move and how the scene should evolve.

Supports Chinese and English. For more stable results, describe the desired action and changes clearly. Write negative requirements directly in prompt, such as No dialogue or No text; there is no separate negative prompt parameter.

The prompt is required and must not be empty or contain only whitespace.

Minimum string length: 1

Pattern: \S

Example:

"The person slowly turns their head and smiles while leaves in the background sway gently in the wind."

image_urls

string<uri>[]

required

First/last-frame image array, containing 1–2 images.

One image: the first frame.
Two images: the first frame, then the last frame. The model generates a transition between them; maximum duration is 10 seconds.
A last frame must accompany a first frame and cannot be supplied alone.

Only HTTP/HTTPS image URLs are supported. Formats: png, jpeg, webp.

Required array length: 1 - 2 elements

Example:

[
  "https://example.com/first-frame.jpg",
  "https://example.com/last-frame.jpg"
]

quality

enum<string>

default:720p

Video resolution; default 720p.

Supported values:

360p: landscape 640×360 / portrait 360×640
720p: landscape 1280×720 / portrait 720×1280; default
1080p: landscape 1920×1080 / portrait 1080×1920
4k: landscape 3840×2160 / portrait 2160×3840

Orientation is controlled by aspect_ratio: 16:9 produces landscape and 9:16 produces portrait.

Billing: Video output is billed by output tokens, which scale linearly with resolution. Relative to 720p, 360p uses about one third, 1080p about 1.5×, and 4k about 3×. Actual charges are based on generated usage.

Available options:

360p,

720p,

1080p,

4k

Example:

"720p"

duration

integer

default:3

Video duration in seconds; default 3.

One first-frame image: any integer from 3 to 15.
Two first/last-frame images: any integer from 3 to 10.
Duration directly affects billing.

Required range: 3 <= x <= 15

Example:

3

aspect_ratio

enum<string>

default:auto

Aspect ratio: 16:9, 9:16, or auto; default auto.

Available options:

16:9,

9:16,

auto

Example:

"auto"

seed

integer

Random seed; random by default.

Range: 0–4294967295.
Fixing the seed reduces variation from parameter changes when tuning prompts and improves reproducibility.

Required range: 0 <= x <= 4294967295

Example:

42

callback_url

string<uri>

HTTPS callback URL to notify when the task completes

Callback timing:

Triggered when the task completes (completed), fails (failed), or is cancelled (cancelled)
Sent after billing is confirmed

Security restrictions:

HTTPS protocol only
Callbacks to internal IP addresses are forbidden (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
URL length must not exceed 2048 characters

Callback mechanism:

Timeout: 10 seconds
Up to 3 retries on failure (retried 1s / 2s / 4s after each failure respectively)
The callback body format matches the response of the task query endpoint
A 2xx status code from the callback URL is treated as success; other status codes trigger a retry

Example:

"https://your-domain.com/webhooks/video-task-completed"

Response

Video task created successfully

created

integer

Task creation timestamp

Example:

1757169743

string

Task ID

Example:

"task-unified-1757169743-7cvnl5zw"

model

string

The model name actually used

Example:

"gemini-omni-1.2-flash-image-to-video"

object

enum<string>

The specific type of the task

Available options:

video.generation.task

progress

integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100

Example:

0

status

enum<string>

Task status. The create endpoint always returns processing; the internal pending state is also exposed to clients as processing.

Available options:

pending,

processing,

completed,

failed

Example:

"processing"

task_info

object

Detailed video task information

Show child attributes

type

enum<string>

The output type of the task

Available options:

text,

image,

audio,

video

Example:

"video"

usage

object

Usage and billing information

Show child attributes

Image Series

Video Series

Audio Series

Text Series

Account Management

Task Management

File Management

Gemini Omni 1.2 Flash Image-to-Video

Authorizations

Body

Response