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-video-edit",
  "prompt": "Gestalte das Licht wärmer und lasse alles andere unverändert.",
  "video_urls": [
    "https://example.com/source.mp4"
  ],
  "quality": "auto",
  "duration": "auto",
  "aspect_ratio": "auto"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-video-edit",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 60,
    "video_duration": 5
  },
  "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-video-edit",
    "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 Videobearbeitung

Gemini Omni 1.2 Flash (gemini-omni-1.2-flash-video-edit) bearbeitet ein Video anhand eines Text-Prompts und optionaler Referenzbilder.
Video: video_urls benötigt genau 1 Video mit höchstens 15 Sekunden.
Bilder: Optional bis zu 10 Referenzbilder über image_urls.
Auflösung: quality: 360p, 720p, 1080p, 4k oder auto; Standard auto übernimmt die Eingabeauflösung. Ein konkreter Wert kann die Ausgabeauflösung erhöhen oder senken.
Dauer: duration erlaubt nur auto, zugleich Standard; die Ausgabe folgt der Eingabedauer.
Seitenverhältnis: aspect_ratio erlaubt nur auto, zugleich Standard; die Ausgabe folgt der Eingabe.
Gewünschte Änderungen über prompt beschreiben. Negative Vorgaben direkt dort angeben; kein separater negativer Prompt.
Synchronisiertes natives Audio wird automatisch erzeugt, ohne zusätzlichen Parameter.
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-video-edit",
  "prompt": "Gestalte das Licht wärmer und lasse alles andere unverändert.",
  "video_urls": [
    "https://example.com/source.mp4"
  ],
  "quality": "auto",
  "duration": "auto",
  "aspect_ratio": "auto"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "gemini-omni-1.2-flash-video-edit",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 60,
    "video_duration": 5
  },
  "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-video-edit",
    "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-video-edit

erforderlich

Modellname, fest auf gemini-omni-1.2-flash-video-edit eingestellt

Verfügbare Optionen:

gemini-omni-1.2-flash-video-edit

Beispiel:

"gemini-omni-1.2-flash-video-edit"

prompt

string

erforderlich

Anweisung für die gewünschte Bearbeitung und unveränderte Inhalte.

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:

"Gestalte das Licht wärmer und lasse alles andere unverändert."

video_urls

string<uri>[]

erforderlich

Array mit genau 1 zu bearbeitenden Video. Nur HTTP/HTTPS-Video-URLs im Format mp4. Höchstens 15 Sekunden, ohne Mindestdauer; auch kurze Videos von 1–2 Sekunden sind erlaubt.

Required array length: 1 element

Beispiel:

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

image_urls

string<uri>[]

Optionales Referenzbild-Array mit maximal 10 Bildern zur Vorgabe von Motiv, Stil oder Elementen.

Eingabeanforderungen:

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

Abrechnung: Jedes Referenzbild zählt als Eingabe-Token.

Required array length: 1 - 10 elements

Beispiel:

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

quality

enum<string>

Standard:auto

Ausgabeauflösung; Standard auto.

360p: kurze Kante 360.
720p: kurze Kante 720.
1080p: kurze Kante 1080.
4k: kurze Kante 2160.
auto: übernimmt die Eingabeauflösung; Standardwert.

Ein konkreter Wert kann die Ausgabeauflösung erhöhen oder senken.

Abrechnung: Ausgabevideo-Tokens steigen mit der Ausgabeauflösung. Eingabevideos zählen ebenfalls als Tokens; höhere Auflösungen kosten mehr.

Verfügbare Optionen:

360p,

720p,

1080p,

4k,

auto

Beispiel:

"auto"

duration

enum<string>

Standard:auto

Nur auto ist zulässig und zugleich Standard. Die Dauer folgt dem Eingabevideo.

Verfügbare Optionen:

auto

Beispiel:

"auto"

aspect_ratio

enum<string>

Standard:auto

Nur auto ist zulässig und zugleich Standard. Das Verhältnis folgt dem Eingabevideo.

Verfügbare Optionen:

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-video-edit"

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 Videobearbeitung

Autorisierungen

Body

Antwort