Gemini Omni 1.2 Flash API

Vollständige API-Referenz für die Videogenerierungsmodelle Google Gemini Omni 1.2 Flash.

Modellvarianten

Diese API unterstützt vier Modellvarianten:

Vergleich auf einen Blick

Gemeinsamer Endpunkt

Alle Varianten von Gemini Omni 1.2 Flash verwenden den Endpunkt für Videoaufträge:

POST /api/v1/video/task

Gemini Omni 1.2 Flash Text to Video

Erforderliche Parameter

Beispielanfrage

javascriptKopieren
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'gemini-omni-1.2-flash-text-to-video',
    prompt: 'A cinematic tracking shot follows a sailboat crossing a glowing ocean at sunset',
    aspect_ratio: '16:9',
    resolution: '1080p',
    duration: 12
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Gemini Omni 1.2 Flash Image to Video

Erforderliche Parameter

Optionale Parameter

Beispielanfrage

javascriptKopieren
{
  model_name: 'gemini-omni-1.2-flash-image-to-video',
  prompt: 'The girl walks toward the camera while the city lights shimmer behind her',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  aspect_ratio: '9:16',
  resolution: '1080p',
  duration: 8
}

Gemini Omni 1.2 Flash Video Edit

Erforderliche Parameter

Hinweis: Video Edit unterstützt weder aspect_ratio noch duration. Lassen Sie beide Parameter in der Anfrage weg.

Beispielanfrage

javascriptKopieren
{
  model_name: 'gemini-omni-1.2-flash-video-edit',
  prompt: 'A small ball rolls into the scene and captures the attention of the cat',
  video_url: 'https://example.com/source-video.mp4',
  resolution: '1080p'
}

Gemini Omni 1.2 Flash Reference to Video

Referenzbilder und Referenzvideos können einzeln oder zusammen verwendet werden. Geben Sie in images oder videos mindestens ein Referenzbild oder ein Referenzvideo an.

Erforderliche Parameter

Optionale Referenzeingaben

Beispielanfrage

javascriptKopieren
{
  model_name: 'gemini-omni-1.2-flash-reference-to-video',
  prompt: 'Use the references to create a cinematic shot of a small boat approaching from the distance',
  aspect_ratio: '16:9',
  resolution: '1080p',
  duration: 12,
  images: ['https://example.com/boat-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4']
}

Antwortformat

Erste Antwort

Alle Modelle geben eine task_id für die regelmäßige Statusabfrage zurück:

jsonKopieren
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Antwort auf die Statusabfrage

Rufen Sie regelmäßig GET /api/v1/video/{taskId} auf, um den Status zu prüfen:

jsonKopieren
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Statuswerte

• submitted: Auftrag angenommen und zur Verarbeitung vorgemerkt
• processing: Videogenerierung läuft
• succeed: Videogenerierung abgeschlossen
• failed: Videogenerierung fehlgeschlagen

Empfehlungen

1. Prompt formulieren: Beschreiben Sie Motive, Handlungen, Kamerabewegungen, Beleuchtung und Szenenverlauf klar.
2. Erforderliche Einstellungen: Geben Sie immer eine unterstützte Auflösung an. Außer bei Video Edit müssen Sie auch ein unterstütztes Seitenverhältnis und eine zulässige Dauer angeben.
3. Bildeingaben: Verwenden Sie für Start-, End- und Referenzbilder stabile, öffentlich zugängliche URLs. Bei Angabe eines Endbilds muss duration zwischen 3 und 10 Sekunden liegen.
4. Eingabe für Video Edit: Prüfen Sie vor dem Senden, dass das Quellvideo höchstens 10 Sekunden lang ist.
5. Grenzwerte für Referenzen: Geben Sie mindestens ein Referenzbild oder Referenzvideo an. Senden Sie höchstens 10 Bilder und 3 Videos. Jedes Referenzvideo darf maximal 3 Sekunden lang sein.