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-reference-to-video",
  "prompt": "Lass die Figur aus dem Referenzbild durch die Referenzszene spazieren.",
  "image_urls": [
    "https://example.com/character.png",
    "https://example.com/scene.png"
  ],
  "quality": "720p",
  "aspect_ratio": "16:9",
  "duration": 3
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-reference-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-reference-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 Referenz-zu-Video

Gemini Omni 1.2 Flash (gemini-omni-1.2-flash-reference-to-video) erzeugt Videos mit nativem Audio aus Referenzbildern, optionalen Referenzvideos und einem Text-Prompt.
Bilder: image_urls akzeptiert 1–10 Bilder als Vorgabe für Motive, Stil oder Elemente.
Videos: video_urls ist optional, maximal 3 Videos als Referenz für Bewegung, Kameraführung oder Stil. Bei duration über 10 Sekunden höchstens 1 Referenzvideo.
Auflösung: 360p, 720p, 1080p oder 4k; Standard 720p.
Dauer: duration als ganze Sekunden von 3 bis 15; Standard 3.
Seitenverhältnis: 16:9, 9:16 oder auto; Standard auto.
Synchronisiertes natives Audio wird automatisch erzeugt, ohne zusätzlichen Parameter.
Negative Vorgaben direkt in prompt schreiben, etwa No dialogue; kein separater negativer Prompt.
Mit seed lässt sich die Reproduzierbarkeit verbessern.
Asynchron: Mit der Aufgaben-ID den Aufgabenstatus abfragen.
Videolinks sind 24 Stunden gültig; bitte rechtzeitig speichern.

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-reference-to-video",
  "prompt": "Lass die Figur aus dem Referenzbild durch die Referenzszene spazieren.",
  "image_urls": [
    "https://example.com/character.png",
    "https://example.com/scene.png"
  ],
  "quality": "720p",
  "aspect_ratio": "16:9",
  "duration": 3
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-reference-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-reference-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"
  }
}

Autorisierungen

Authorization

string

header

erforderlich

##Alle APIs erfordern Bearer-Token-Authentifizierung##

API-Schlüssel erhalten:

Besuchen Sie die API-Schlüsselverwaltungsseite, um Ihren API-Schlüssel zu erhalten

Zum Anfrage-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

Standard:gemini-omni-1.2-flash-reference-to-video

erforderlich

Modellname, fest auf gemini-omni-1.2-flash-reference-to-video eingestellt

Verfügbare Optionen:

gemini-omni-1.2-flash-reference-to-video

Beispiel:

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

prompt

string

erforderlich

Prompt für Motiv, Stil und Bewegung aus den Referenzen.

Unterstützt Chinesisch und Englisch. Beschreibe die gewünschte Aktion und die Änderungen klar, um stabilere Ergebnisse zu erhalten. Negative Vorgaben wie No dialogue oder Kein Text direkt in prompt schreiben; es gibt keinen separaten Parameter für negative Prompts.

Der Prompt ist erforderlich und darf weder leer sein noch ausschließlich aus Leerraum bestehen.

Minimum string length: 1

Pattern: \S

Beispiel:

"Ein Kätzchen spielt mit einem Wollknäuel und stupst es mit den Pfoten an."

image_urls

string<uri>[]

erforderlich

Array von Referenzbild-URLs. Erforderlich; 1 bis 10 Bilder zur Vorgabe von Motiv, Stil oder Elementen.

Eingabeanforderungen:

Nur HTTP/HTTPS-Bild-URLs
Unterstützte Formate: png, jpeg, webp

Required array length: 1 - 10 elements

Beispiel:

[
  "https://example.com/character.png",
  "https://example.com/scene.png"
]

video_urls

string<uri>[]

Optionales Array mit Referenzvideos. Höchstens 3; bei duration über 10 Sekunden höchstens 1.

Kann mit image_urls kombiniert werden, um Bewegung, Kameraführung oder Stil vorzugeben.

Eingabe: Nur HTTP/HTTPS-Video-URLs, Format mp4.

Abrechnung: Jedes Referenzvideo wird entsprechend seiner Dauer als Eingabe-Tokens berücksichtigt.

Jedes Referenzvideo darf höchstens 10 Sekunden lang sein.

Required array length: 1 - 3 elements

Beispiel:

["https://example.com/reference.mp4"]

quality

enum<string>

Standard:720p

Videoauflösung; Standard 720p.

Unterstützte Werte:

360p: Querformat 640×360 / Hochformat 360×640
720p: Querformat 1280×720 / Hochformat 720×1280; Standard
1080p: Querformat 1920×1080 / Hochformat 1080×1920
4k: Querformat 3840×2160 / Hochformat 2160×3840

Die Ausrichtung wird durch aspect_ratio bestimmt: 16:9 erzeugt Querformat, 9:16 Hochformat.

Abrechnung: Ausgabe-Token steigen linear mit der Auflösung. Gegenüber 720p benötigt 360p etwa ein Drittel, 1080p etwa das 1,5-Fache und 4k etwa das 3-Fache. Die tatsächliche Abrechnung richtet sich nach der generierten Nutzung.

Verfügbare Optionen:

360p,

720p,

1080p,

4k

Beispiel:

"720p"

duration

integer

Standard:3

Videodauer in Sekunden; Standard 3. Erlaubt sind ganze Zahlen von 3 bis 15. Die Dauer beeinflusst die Abrechnung direkt.

Erforderlicher Bereich: 3 <= x <= 15

Beispiel:

3

aspect_ratio

enum<string>

Standard:auto

Seitenverhältnis: 16:9, 9:16 oder auto; Standard auto.

Verfügbare Optionen:

16:9,

9:16,

auto

Beispiel:

"auto"

seed

integer

Zufalls-Seed; standardmäßig zufällig. Bereich: 0–4294967295. Ein fester Seed reduziert beim Optimieren des Prompts Schwankungen durch Parameteränderungen und verbessert die Reproduzierbarkeit.

Erforderlicher Bereich: 0 <= x <= 4294967295

Beispiel:

42

callback_url

string<uri>

HTTPS-Callback-Adresse nach Aufgabenabschluss

Callback-Zeitpunkt:

Wird ausgelöst, wenn die Aufgabe abgeschlossen (completed), fehlgeschlagen (failed) oder abgebrochen (cancelled) wurde
Wird nach Abschluss der Abrechnungsbestätigung gesendet

Sicherheitsbeschränkungen:

Nur HTTPS-Protokoll wird unterstützt
Callback an interne IP-Adressen ist verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, usw.)
URL-Länge darf 2048 Zeichen nicht überschreiten

Callback-Mechanismus:

Timeout: 10 Sekunden
Maximal 3 Wiederholungsversuche bei Fehler (Wiederholung nach 1 Sekunde/2 Sekunden/4 Sekunden)
Das Format des Callback-Antwortkörpers entspricht dem Antwortformat der Aufgabenabfrage-API
Ein 2xx-Statuscode der Callback-Adresse gilt als erfolgreich, andere Statuscodes lösen eine Wiederholung aus

Beispiel:

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

Antwort

Videoaufgabe erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1757169743

string

Aufgaben-ID

Beispiel:

"task-unified-1757169743-7cvnl5zw"

model

string

Tatsächlich verwendeter Modellname

Beispiel:

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

object

enum<string>

Spezifischer Aufgabentyp

Verfügbare Optionen:

video.generation.task

progress

integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100

Beispiel:

0

status

enum<string>

Aufgabenstatus. Der Erstellungsendpunkt gibt immer processing zurück; auch der interne Status pending wird Clients als processing angezeigt.

Verfügbare Optionen:

pending,

processing,

completed,

failed

Beispiel:

"processing"

task_info

object

Detaillierte Informationen zur Videoaufgabe

Show child attributes

type

enum<string>

Aufgaben-Ausgabetyp

Verfügbare Optionen:

text,

image,

audio,

video

Beispiel:

"video"

usage

object

Nutzungs- und Abrechnungsinformationen

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Gemini Omni 1.2 Flash Referenz-zu-Video

Autorisierungen

Body

Antwort