Google

Veo 3.1 Fast

veo-3.1-fast/image-to-video

Modèle image-vers-vidéo de la série Veo 3.1 axé sur la production rapide, générant l'image et l'audio de manière synchronisée, adapté à la production de contenus finis tels que le marketing, les présentations et les réseaux sociaux

veo-3.1-fast/image-to-video veo-3.1-fast/text-to-video

Essayer veo-3.1-fast/image-to-video

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

veo-3.1-fast/image-to-video per second

Spécifications	720P	1080P	4K
Sound On	$0.250	$0.250	$0.600
Sound Off	$0.170	$0.170	$0.500

Présentation

veo-3.1-fast/image-to-video est une voie de génération vidéo à partir d'image de la série Google Veo 3.1, accessible via l'interface unifiée de HiAPI.ai. Il suffit de fournir une image de référence et un prompt décrivant la scène pour étendre une image statique en une vidéo avec audio natif. La résolution d'image est au choix de 720p à 4k, pour des durées de 4, 6 ou 8 secondes ; les détails des personnages et la fidélité au prompt sont ses principaux atouts. Il convient aux développeurs qui ont besoin de produire rapidement des vidéos finies sans recourir à des outils séparés de doublage et d'effets sonores, pour des spots marketing, des démonstrations et des contenus pour les réseaux sociaux.

Points clés

Image et audio générés en une seule fois — la vidéo et la piste audio native sont produites lors de la même génération, ce qui évite l'étape intermédiaire d'application d'outils de doublage et d'effets sonores distincts.
Résolution et durée ajustables selon les besoins — la sortie prend en charge trois paliers de résolution (720p, 1080p, 4k) et des durées de 4, 6 ou 8 secondes, à choisir selon les spécifications de la vidéo et le budget.
Point de départ verrouillé par l'image de référence — l'image fournie sert de première image de référence, et le prompt ne décrit que le mouvement, ce qui permet de stabiliser plus facilement l'apparence du sujet qu'avec une génération purement textuelle.

Capacités

Extension vidéo pilotée par l'image : accepte une image de référence au format 16:9 ou 9:16 et un prompt pour transformer une image statique en séquence animée ; les autres ratios sont recadrés pour s'adapter, et le rapport d'aspect peut aussi être spécifié manuellement ou suivre l'image d'entrée.

Activation de l'audio natif : le paramètre generate_audio détermine si une piste audio est générée avec la vidéo, activé par défaut ; il peut être désactivé pour obtenir une image seule et effectuer un post-traitement.

Contrainte par prompt négatif : un champ negative_prompt permet de décrire ce que l'on souhaite éviter, afin de supprimer les éléments d'image indésirables.

Reproductibilité par graine : le champ seed permet, une fois la graine fixée, de reproduire une génération avec les mêmes entrées et le même prompt, ce qui facilite le débogage et la comparaison.

Cas d'usage

Équipes marketing : image produit + description des arguments de vente — transformer une image de produit ou de scène en une courte vidéo avec effets sonores, directement utilisable pour les campagnes en fil d'actualité, les publications sur les réseaux sociaux et la zone d'en-tête des pages de destination.
Créateurs de contenu : image de personnage ou de scène + texte narratif — produire des séquences courtes à tonalité de voix off, pour publication sur les plateformes de vidéo courte ou production en série de contenus.
Présentations d'entreprise : schéma + texte explicatif — convertir les images statiques des supports de présentation en séquences animées, à intégrer dans des diapositives ou des pages de présentation de site pour renforcer l'expression.
Créateurs de supports pédagogiques : graphique ou image de démonstration + description explicative — générer des séquences explicatives comme complément visuel de cours ou de formations, en réduisant les coûts de tournage et de montage.

Limites et conseils de choix

La durée d'une génération est limitée à 8 secondes ; pour une narration plus longue, il faut générer par segments puis les assembler, en contrôlant la continuité visuelle de chaque segment. L'image de référence doit être d'au moins 720p et fournie en 16:9 ou 9:16, faute de quoi elle sera recadrée. La durée et la résolution influent sur la facturation, la 4k et l'activation de la piste audio correspondant à des paliers de coût plus élevés. Ces séquences conviennent mieux aux contenus de type vidéo finie qu'à une simulation physique ou de mouvement de haute précision ; si le besoin est une simulation physique rigoureuse ou un plan continu de longue durée, il faut envisager d'autres modèles ou solutions.

Questions fréquentes

Voir toutes les questions →

Veo 3.1 Fast Image to Video nécessite-t-il de téléverser une image ?

Oui. Actuellement, veo-3.1-fast/image-to-video est une voie de génération de vidéo à partir d'image : l'image d'entrée définit le sujet et la composition initiale, tandis que le Prompt gère les actions, les mouvements de caméra et les changements d'environnement.
Quelles durées et résolutions Veo 3.1 Fast Image to Video prend-il en charge ?

Le contrat de requête HiAPI actuel prend en charge 4s / 6s / 8s, avec des résolutions de sortie de 720p, 1080p et 4k. Les valeurs disponibles sont définies par le panneau de paramètres de la page et la documentation de l'API.
Comment Veo 3.1 Fast Image to Video est-il facturé ?

Les tâches sont facturées selon la durée de sortie et le niveau sélectionné. La page affiche le prix en temps réel en suivant l'unité monétaire globale ; le débit final est basé sur l'enregistrement des tâches réussies.
Comment améliorer la stabilité du sujet dans la génération de vidéo à partir d'image ?

Utilisez une image d'entrée au sujet clair, peu occulté et à la composition complète ; dans le Prompt, décrivez d'abord l'action principale et le plan, puis énumérez l'apparence, les matériaux et les relations avec l'arrière-plan qui doivent être préservés. Pour le premier test, il est recommandé d'utiliser une durée plus courte.

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 : veo-3.1-fast/image-to-video

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour veo-3.1-fast/image-to-video et la route default — voir le tableau des paramètres ci-dessous.

seedintegerOptionnel

Graine aléatoire permettant de reproduire les résultats de génération ; valeur sous forme d'entier, générée aléatoirement côté serveur si non fournie.

promptstringRequisminLength 1maxLength 20000

Invite textuelle décrivant de quelle manière l'image d'entrée doit s'animer ; valeur de type chaîne.

durationintegerRequisDéfaut: 8min 4max 8

Durée de la vidéo générée, en secondes, valeur sous forme d'entier, par défaut 8 ; le coût augmente avec la durée.

Options：468

image_urlstringRequis

URL de l'image d'entrée à animer ; résolution recommandée de 720p ou plus, ratio d'image de 16:9 ou 9:16, les autres ratios seront recadrés pour s'adapter.

resolutionstringRequisDéfaut: "720p"

Résolution de la vidéo de sortie, valeur de type chaîne, par défaut 720p ; plus la résolution est élevée, plus le coût est important.

Options：720p1080p4k

aspect_ratiostringOptionnelDéfaut: "auto"

Ratio d'image de la vidéo de sortie, valeur de type chaîne, par défaut auto, c'est-à-dire qu'il suit le ratio d'image de l'image d'entrée.

Options：auto16:99:16

generate_audiobooleanOptionnelDéfaut: true

Indique s'il faut générer une piste audio native, valeur de type booléen, par défaut true ; le prix est plus élevé lorsque cette option est activée.

negative_promptstringOptionnel

Invite négative décrivant le contenu à éviter dans la vidéo générée ; valeur de type chaîne.

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": "veo-3.1-fast/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 8,
    "image_url": "…",
    "resolution": "720p",
    "aspect_ratio": "auto",
    "generate_audio": true
  }
}'

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: "veo-3.1-fast/image-to-video",
    input: {
      "prompt": "…",
      "duration": 8,
      "image_url": "…",
      "resolution": "720p",
      "aspect_ratio": "auto",
      "generate_audio": true
    }
  }),
});
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": "veo-3.1-fast/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 8,
          "image_url": "…",
          "resolution": "720p",
          "aspect_ratio": "auto",
          "generate_audio": True
        }
    },
)
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"
    }
  }
}