Google

Gemini Omni 1.2

gemini-omni-1.2-flash

Modèle de génération vidéo de Google, prenant en charge la génération vidéo à partir de texte, à partir d'image et à partir d'images de référence, avec la possibilité de téléverser jusqu'à 10 images de référence, ainsi que de spécifier le point de départ et le point d'arrivée du plan à l'aide d'une image de première frame ou d'images de première et dernière frames ; adapté à la création de vidéos de présentation de produits et de contenus publicitaires pour les réseaux sociaux

gemini-omni-1.2-flash

Essayer gemini-omni-1.2-flash

Entrée

Créations

Voir toutes les créations

Sortie

video

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

gemini-omni-1.2-flash per second

Spécifications	Prix unitaire
360P	$0.0229
720P	$0.0343
1080P	$0.0343
4K	$0.080

Positionnement

Il s'agit d'un modèle de génération vidéo destiné aux développeurs, capable de produire de courts clips à partir d'une description textuelle, d'images de référence ou de premières et dernières images, d'une durée de 3 à 15 secondes par génération, et jusqu'à 10 secondes en mode première et dernière images. Une image publique peut servir de référence de contenu ou de style, et une première image peut définir l'image d'ouverture ; l'entrée par image de référence et l'entrée par image sont mutuellement exclusives. Il convient aux équipes e-commerce, marketing et créatives qui ont besoin de produire en série des contenus vidéo courts en format horizontal ou vertical.

Points clés

Deux modes de contrôle : image de référence et première/dernière images — jusqu'à 10 images publiques peuvent servir de référence pour un personnage, un produit ou un style ; les première et dernière images peuvent aussi définir les images de début et de fin.
Choisir le format et la résolution selon le canal de diffusion — le format prend en charge le 16:9 horizontal ou le 9:16 vertical, et la résolution peut être choisie parmi 360p, 720p, 1080p et 4k.
Le prompt peut décrire la scène et le mouvement de caméra — le prompt est obligatoire et limité à 20 000 caractères, et peut préciser le contenu de l'image, le mouvement et la manière dont la caméra avance.

Capacités

Texte vers vidéo et image de référence vers vidéo : il suffit de fournir un prompt pour générer une vidéo ; image_urls accepte de 1 à 10 images HTTP(S) publiques, et même une seule image est traitée comme image de référence pour contraindre le personnage, le produit ou le style.

Première image et transition entre première et dernière images : first_frame_url définit seul l'image d'ouverture ; en fournissant à la fois first_frame_url et last_frame_url, on génère un plan de transition entre les images de début et de fin, avec une durée maximale de 10 secondes et sans possibilité d'utiliser simultanément des images de référence.

Réglage de la durée, du format et de la résolution : duration est un nombre entier de 3 à 15 secondes, 10 secondes par défaut ; aspect_ratio accepte 16:9 ou 9:16 ; resolution accepte 360p, 720p, 1080p, 4k, 720p par défaut.

Style global et exclusion de contenu : system_prompt sert à définir le style visuel global, negative_prompt à décrire le contenu à exclure ; ces deux options ne sont pas disponibles lorsqu'une dernière image est spécifiée.

Cas d'usage

Équipes e-commerce : créer des clips de présentation produit — générer un clip horizontal à partir d'un prompt et de plusieurs images de référence de produits ou de personnes, pour l'utiliser comme contenu sur les pages de détail et les emplacements de fiches produit.
Équipes marketing : produire des contenus publicitaires verticaux — décrire les arguments de vente dans un prompt et choisir le format 9:16 pour générer des vidéos adaptées à la diffusion verticale sur les flux d'actualité et les plateformes de vidéos courtes.
Équipes design : transformer une image statique en contenu animé — désigner une image publique comme première image et générer un clip animé se déroulant à partir de cette image, pour animer des affiches ou des illustrations.
Équipes créatives : prévisualiser le début et la fin d'un plan — fournir une première et une dernière images pour générer un plan de transition, afin de prévisualiser le storyboard et de présenter rapidement des extraits conceptuels.

Limites et conseils de sélection

La durée d'une vidéo est limitée à 3 à 15 secondes, et le mode première/dernière images à 10 secondes maximum ; les contenus plus longs doivent être traités par segments. Les résolutions 1080p et 4k sont des sorties agrandies, et la 4k peut ne pas comporter de piste audio. Les images de référence et les première/dernière images sont mutuellement exclusives ; une fois la dernière image spécifiée, system_prompt et negative_prompt ne peuvent pas être utilisés. Tous les paramètres d'image n'acceptent que des URL HTTP(S) publiques, le Base64 n'est pas pris en charge.

Nouveautés

Voir le journal des modifications →

Nouveau modèle Gemini Omni 1.2 Flash est disponible : génération de vidéos à partir de texte, d'une première image et d'images de référence

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.

Idempotency-KeystringOptionnel

Clé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.

Clé d'idempotence

En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.

Corps

modelstringRequis

Valeur fixe actuelle : gemini-omni-1.2-flash

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour gemini-omni-1.2-flash et la route default — voir le tableau des paramètres ci-dessous.

promptstringRequisminLength 1maxLength 20000pattern \S

Invite de description de la scène, du mouvement, de la caméra et du son souhaité ; jusqu'à 20 000 caractères, une invite non vide est obligatoire dans tous les modes.

durationintegerOptionnelDéfaut: 10min 3max 15

Durée de la vidéo de sortie, en secondes entières entre 3 et 15 ; limitée à 10 secondes maximum lors d'une interpolation entre première et dernière image. Par défaut : 10 secondes.

image_urlsarrayOptionnelminItems 1maxItems 10

Tableau d'images de référence, dont les éléments sont des URL d'images ; 1 à 10 images peuvent servir de référence de personnage, de produit ou de style ; passer une seule image via ce paramètre relève toujours du mode image de référence ; pour utiliser une image unique comme image de départ, utilisez plutôt first_frame_url. Seules les adresses HTTP(S) d'images directement accessibles publiquement sont prises en charge, Base64 n'est pas pris en charge ; ne peut pas être utilisé en même temps que la première ou la dernière image.

Array [ string ]

resolutionstringOptionnelDéfaut: "720p"

Résolution de sortie ; 1080p et 4k sont des sorties agrandies, la sortie 4k peut ne pas comporter de piste audio. Par défaut : 720p.

Options：360p720p1080p4k

aspect_ratiostringOptionnelDéfaut: "16:9"

Format d'image de sortie, déterminant la composition en paysage ou en portrait. Par défaut : 16:9.

Options：16:99:16

system_promptstringOptionnel

Invite système servant à définir le style global ou l'orientation visuelle ; ne peut pas être utilisée en même temps que la dernière image.

last_frame_urlstringOptionnelminLength 1pattern ^https?://

Adresse de l'image de la dernière image, à fournir avec first_frame_url, la durée maximale est alors de 10 secondes ; seules les adresses HTTP(S) d'images directement accessibles publiquement sont prises en charge, Base64 n'est pas pris en charge ; ne peut pas être utilisé en même temps que les images de référence, system_prompt ou negative_prompt.

first_frame_urlstringOptionnelminLength 1pattern ^https?://

Adresse de l'image de la première image de la vidéo, permettant de spécifier seule l'image de départ ; doit être une URL HTTP(S) d'image directement accessible publiquement, Base64 n'est pas pris en charge, et ne peut pas être utilisée en même temps que image_urls ; obligatoire lorsque last_frame_url est fournie.

negative_promptstringOptionnel

Invite négative servant à décrire les éléments à exclure ; ne peut pas être utilisée en même temps que la dernière image.

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.

urlstringRequis

Obligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.

whenstringOptionnelDéfaut: "final"

Seul final est pris en charge pour l'instant — notifié sur success et fail.

Options：final

storagestringOptionnelDéfaut: "temp"

Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.

Options：temppersistent

Exemples de requête

# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-omni-1.2-flash",
  "input": {
    "prompt": "…",
    "duration": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gemini-omni-1.2-flash",
    input: {
      "prompt": "…",
      "duration": 10,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "gemini-omni-1.2-flash",
        "input": {
          "prompt": "…",
          "duration": 10,
          "resolution": "720p",
          "aspect_ratio": "16:9"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtenir le détail de la tâche

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

queued En file, pas encore démarrée. handling En cours de traitement. archiving Traitement terminé, préparation des artefacts. success Terminal : terminé, artefacts disponibles (output renvoyé). fail Terminal : échec (error renvoyé). Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes Unix de l'état terminal ; 0 tant que non terminal.

outputarrayOptionnel

Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).

Array [ object ]

Éléments du tableau

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description de l'erreur.

Exemples de réponse

Succès

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En cours (non terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Échec

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}