GoogleVérification

gemini-omni-flash/image-to-video

gemini-omni-flash-image-to-video-economy

image vers vidéoSortie: VidéoEntrée: texte + image

Chargement du prix…

Prix catalogue officiel · Non vérifié

Obtenir une clé d’API

Paramètres

Obligatoire

promptprompt: string

Video prompt. Describe how the reference image should move, camera motion, visual style, and audio cues in detail. 1–2048 chars · 72/2048

imageUrlsimageUrls: string[]

Déposez des images ici ou cliquez pour les envoyerJusqu’à 3 fichiers

Reference images. Use 1 image for single-image video generation or 3 images for reference fusion. 2 images are not supported. ≤ 3 items · HTTPS image URL or media:<uuid>

durationduration: string

Video duration in seconds. Supported values: 4, 6, 8, 10.

resolutionresolution: string

Video resolution.

Options courantes

aspectRatioaspectRatio: string

Video aspect ratio.

Aperçu de la requête

{
  "model": "gemini-omni-flash-image-to-video-economy",
  "input": {
    "prompt": "make the character smile and slowly turn around, cinematic camera motion",
    "duration": "6",
    "resolution": "720p",
    "aspectRatio": "16:9"
  }
}

Le playground web envoie ce corps avec votre session connectée. Depuis votre code, envoyez le même corps avec une clé d’API.

Montant estimé

Chargement du prix…

Les crédits sont réservés à l’acceptation d’une tâche et débités seulement en cas de succès. Une tâche échouée libère la réservation ; un résultat non confirmé reste réservé jusqu’à vérification.

Ce qu’il fait

Gemini Omni Flash Image-to-Video turns reference images into dynamic short videos. It supports single-image video generation with 1 image and reference fusion with 3 images, offering 720p, 1080p, and 4k outputs with 4, 6, 8, and 10-second durations for character animation, product showcases, creative shots, and multi-reference video creation.

Image-Driven VideoSingle-Image Animation3-Image Reference Fusion720p/1080p/4k4-10s DurationFlexible Aspect Ratios

Paramètres d’entrée

Uniquement les champs acceptés par ce modèle. Les champs obligatoires doivent être fournis.

Champ	Type	Obligatoire	Par défaut	Valeurs autorisées et contraintes
`prompt`	`string`	obligatoire	`"make the character smile and slowly turn around, cinematic camera motion"`	Video prompt. Describe how the reference image should move, camera motion, visual style, and audio cues in detail. 1–2048 chars
`imageUrls`	`string[]`	obligatoire	—	Reference images. Use 1 image for single-image video generation or 3 images for reference fusion. 2 images are not supported. ≤ 3 items · HTTPS image URL or media:<uuid>
`duration`	`string`	obligatoire	`"6"`	Video duration in seconds. Supported values: 4, 6, 8, 10. Parmi: `"4"`, `"6"`, `"8"`, `"10"`
`resolution`	`string`	obligatoire	`"720p"`	Video resolution. Parmi: `"720p"`, `"1080p"`, `"4k"`
`aspectRatio`	`string`	facultatif	`"16:9"`	Video aspect ratio. Parmi: `"16:9"`, `"9:16"`

Limites et comportement

Asynchrone uniquement : soumettez une tâche, puis interrogez le résultat.
prompt: 1–2048 chars
imageUrls: ≤ 3 items
Les entrées média acceptent des URL HTTPS publiques ou des références media:<uuid> issues de POST /api/v1/media.

Point de terminaison

Tous les modèles partagent une API de tâches asynchrone. Ce modèle est sélectionné par son slug.

Soumettre

POST https://api.hermes-ai.net/api/v1/jobs

{
  "model": "gemini-omni-flash-image-to-video-economy",
  "input": {
    "prompt": "make the character smile and slowly turn around, cinematic camera motion",
    "imageUrls": [
      "https://example.com/input.png"
    ],
    "duration": "6",
    "resolution": "720p"
  }
}

Puis interrogez GET /api/v1/jobs/{id} jusqu’à ce que le statut soit final.

Authentification

Envoyez une clé d’API avec la portée jobs:create pour soumettre et jobs:read pour interroger.

En-tête	Valeur	Remarques
`Authorization`	`Bearer <API key>`	Ou envoyez la clé dans x-api-key.
`Content-Type`	`application/json`
`Idempotency-Key`	`<unique string ≤128>`	Obligatoire. Ne le réutilisez que pour retenter la même requête.

Corps de la requête

Champ	Type	Obligatoire	Remarques
`model`	`string`	obligatoire	Slug du modèle dans le catalogue.
`input`	`object`	obligatoire	Champs du schéma d’entrée du modèle.
`expectedPriceMicros`	`integer`	facultatif	Prix que vous avez affiché à l’utilisateur. En cas d’écart, 409 PRICE_CHANGED est renvoyé avant tout débit.

champs input

Les champs inconnus sont rejetés avec INVALID_MODEL_INPUT.

Champ	Type	Obligatoire	Par défaut	Valeurs autorisées et contraintes
`prompt`	`string`	obligatoire	`"make the character smile and slowly turn around, cinematic camera motion"`	Video prompt. Describe how the reference image should move, camera motion, visual style, and audio cues in detail. 1–2048 chars
`imageUrls`	`string[]`	obligatoire	—	Reference images. Use 1 image for single-image video generation or 3 images for reference fusion. 2 images are not supported. ≤ 3 items · HTTPS image URL or media:<uuid>
`duration`	`string`	obligatoire	`"6"`	Video duration in seconds. Supported values: 4, 6, 8, 10. Parmi: `"4"`, `"6"`, `"8"`, `"10"`
`resolution`	`string`	obligatoire	`"720p"`	Video resolution. Parmi: `"720p"`, `"1080p"`, `"4k"`
`aspectRatio`	`string`	facultatif	`"16:9"`	Video aspect ratio. Parmi: `"16:9"`, `"9:16"`

Réponse

202 pour une nouvelle tâche, 200 lorsqu’une relecture avec Idempotency-Key correspond. GET /api/v1/jobs/{id} renvoie la même structure sans replayed.

Champ	Type	Remarques
`id`	`string`	ID de tâche Hermes AI. Utilisez-le pour interroger.
`model`	`string`	Slug du modèle.
`status`	`string`	Voir les statuts de tâche.
`errorCode`	`string \| null`	Défini lorsqu’une tâche échoue ou doit être examinée.
`priceMicros`	`integer`	Devis fixé à l’admission, en micro-unités USD.
`currency`	`"USD"`
`createdAt / updatedAt`	`string`	Horodatages ISO 8601.
`assets[]`	`array`	{ id, type, url?, text? }. url est un lien /api/v1/results/<uuid> de même origine.
`replayed`	`boolean`	Soumission uniquement. true lorsqu’une nouvelle tentative idempotente correspond.

Statuts de tâche

Statut	Final	Signification
`queued`	non	Acceptée, en attente d’un worker.
`submitting`	non	En cours d’envoi au fournisseur du modèle.
`running`	non	Le modèle est en cours de génération.
`succeeded`	oui	Terminée. Les résultats sont dans assets.
`failed`	oui	Terminée sans résultat. La réservation est libérée.
`reconciliation_required`	oui	The result is being verified. Keep the task ID and do not resubmit automatically.

Erreurs

Chaque corps d’erreur est { code, error }. Traitez-les selon code.

HTTP	Code	Signification et action
`401`	`AUTH_REQUIRED`	Clé d’API ou session manquante ou invalide.
`403`	`INSUFFICIENT_SCOPE`	La clé d’API n’a pas la portée requise par ce point de terminaison.
`403`	`PERMISSION_DENIED`	Cet identifiant ne peut pas effectuer cette opération.
`429`	`API_KEY_RATE_LIMITED`	La limite de débit de la clé d’API est atteinte. Respectez Retry-After.
`429`	`API_KEY_USAGE_EXCEEDED`	La clé d’API a atteint sa limite d’utilisation. Créez une nouvelle clé.
`400`	`INVALID_REQUEST`	Le corps n’est pas un objet JSON ou une valeur obligatoire manque.
`400`	`INVALID_IDEMPOTENCY_KEY`	Idempotency-Key doit comporter de 1 à 128 caractères ASCII imprimables.
`400`	`INVALID_MODEL_INPUT`	input ne correspond pas au schéma du modèle (champ inconnu, champ obligatoire manquant ou valeur invalide).
`400 / 413`	`INPUT_TOO_LARGE`	Le corps de la requête dépasse 256 Ko. Importez d’abord les médias et envoyez une référence média.
`404`	`REQUEST_NOT_FOUND`	No chat request with this ID belongs to your account.
`404`	`MODEL_NOT_FOUND`	Aucun modèle n’a ce slug.
`404`	`JOB_NOT_FOUND`	Aucune tâche avec cet ID n’appartient à votre compte.
`409`	`IDEMPOTENCY_CONFLICT`	Cette Idempotency-Key a été utilisée avec une autre entrée. Utilisez une nouvelle clé pour une nouvelle requête.
`409`	`PRICE_CHANGED`	Le prix diffère de expectedPriceMicros. Récupérez le prix et confirmez à nouveau.
`409`	`MODEL_PRICE_UNAVAILABLE`	Aucun prix n’est encore configuré pour ce modèle ; il ne peut donc pas s’exécuter.
`409`	`PAYMENT_REVIEW_REQUIRED`	A refund left an uncovered balance. Contact support or cover the balance before submitting tasks.
`409`	`INSUFFICIENT_CREDITS`	Les crédits disponibles ne couvrent pas le prix de la tâche.
`429`	`RATE_LIMITED`	Trop de soumissions de tâches par minute. Réessayez plus tard.
`429`	`CONCURRENCY_LIMITED`	Trop de tâches inachevées. Attendez qu’une tâche se termine.
`503`	`EXECUTION_UNAVAILABLE`	L’exécution n’est pas configurée pour ce modèle actuellement.
`429`	`UPSTREAM_RATE_LIMITED`	The model provider is rate limiting chat requests. Retry with backoff; nothing was charged.
`502`	`UPSTREAM_ERROR`	The model provider failed the chat request. Nothing was charged; retry later.
`503`	`PLATFORM_BUDGET_EXCEEDED`	This model is temporarily unavailable. Try again later.
`503`	`EXECUTION_TEMPORARILY_UNAVAILABLE`	L’exécution est temporairement indisponible. Réessayez avec la même Idempotency-Key.
`503`	`AUTH_UNAVAILABLE`	L’authentification est temporairement indisponible. Réessayez plus tard.
`503`	`API_UNAVAILABLE`	L’API est temporairement indisponible. Réessayez plus tard.

Guide complet de l’API · OpenAPI 3.1

Prix Hermes AI

Chargement du prix…

Impossible de charger la grille tarifaire en temps réel. Actualisez pour réessayer.

Prix catalogue officiel

Tarifs API standard du fabricant en USD, avant remises de canal. Les unités et spécifications suivent la source officielle.

Prix officiel non vérifié pour ce modèle.

Ce qui influe sur le coût

Resolution, duration and output quantity can affect the quote. Review the rate card and the Playground quote before submitting.

· Only successful tasks are charged. Failed tasks release reserved credits; tasks with an unconfirmed outcome keep their reservation until the result is verified.
· Les nouvelles tentatives idempotentes avec la même clé ne créent pas de second débit.
· Envoyez expectedPriceMicros pour rejeter la tâche avec PRICE_CHANGED si le prix a changé après son affichage.

Estimation

Select the specifications in Playground to see the task quote.

// Facturation

Fonctionnement de la facturation

Tasks use prepaid credits. Add credits on the Billing page; your balance updates after payment confirmation.

Quand	Effet
Task accepted	The quoted amount is reserved from your balance.
Task succeeded	The reserved amount is charged once.
Task failed	The reserved amount is returned to your available balance.

Tasks with an unconfirmed outcome keep their reserved credits until the result is verified. Keep the task ID and contact support if you need help.

Payment refunds are reflected in your balance and transaction history on the Billing page.

Requête minimale

Champs obligatoires uniquement, générée à partir du schéma de ce modèle. Définissez HERMES_API_KEY dans votre environnement.

# 1. Submit the task (asynchronous; returns 202 with a task id)
curl -X POST https://api.hermes-ai.net/api/v1/jobs \
  -H "Authorization: Bearer $HERMES_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "gemini-omni-flash-image-to-video-economy",
  "input": {
    "prompt": "make the character smile and slowly turn around, cinematic camera motion",
    "imageUrls": [
      "https://example.com/input.png"
    ],
    "duration": "6",
    "resolution": "720p"
  }
}'

# 2. Poll until status is succeeded, failed or reconciliation_required
curl https://api.hermes-ai.net/api/v1/jobs/TASK_ID \
  -H "Authorization: Bearer $HERMES_API_KEY"

Avec les valeurs par défaut documentées

La même requête avec chaque valeur par défaut facultative explicitée, pour voir ce qu’il faut modifier.

# 1. Submit the task (asynchronous; returns 202 with a task id)
curl -X POST https://api.hermes-ai.net/api/v1/jobs \
  -H "Authorization: Bearer $HERMES_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "gemini-omni-flash-image-to-video-economy",
  "input": {
    "prompt": "make the character smile and slowly turn around, cinematic camera motion",
    "imageUrls": [
      "https://example.com/input.png"
    ],
    "duration": "6",
    "resolution": "720p",
    "aspectRatio": "16:9"
  }
}'

# 2. Poll until status is succeeded, failed or reconciliation_required
curl https://api.hermes-ai.net/api/v1/jobs/TASK_ID \
  -H "Authorization: Bearer $HERMES_API_KEY"

Importez d’abord un fichier local

Remplacez l’URL d’exemple par la référence média renvoyée.

POST /api/v1/media

curl -X POST https://api.hermes-ai.net/api/v1/media \
  -H "Authorization: Bearer $HERMES_API_KEY" \
  -H "Content-Type: image/png" \
  --data-binary @input.png
# → { "reference": "media:<uuid>", ... }  Use the reference in an image or video field.