Aller au contenu principal

Images de reference et guide de style

Guider le style visuel de vos videos

En plus de l’animation d’image directe, l’API video xAI propose un mecanisme d’images de reference qui vous permet de guider le style visuel de la video generee sans l’animer directement. C’est la difference fondamentale entre le parametre image et le parametre reference_images.

image vs reference_images

Ces deux parametres ont des roles distincts :

Le parametre image

  • Fournit l’image a animer directement
  • Le contenu de l’image est preserve et mis en mouvement
  • Utilise quand vous voulez transformer une image precise en video

Le parametre reference_images

  • Fournit des images de reference stylistique
  • Le modele s’inspire du style, des couleurs et de l’ambiance
  • Le contenu genere suit le prompt, pas les images de reference
  • Accepte un tableau d’objets avec des URLs
{
  "model": "grok-imagine-video",
  "prompt": "Scene de montagne enneigee au lever du soleil",
  "reference_images": [
    {"url": "https://exemple.com/style-cinema-1.jpg"},
    {"url": "https://exemple.com/style-cinema-2.jpg"}
  ],
  "duration": 5
}

Restriction fondamentale

Les parametres image et reference_images sont mutuellement exclusifs. Si vous envoyez les deux dans la meme requete, l’API retourne une erreur 400. Vous devez choisir l’un ou l’autre.

Cas d’usage des images de reference

Coherence de marque

Vous produisez une serie de videos pour une campagne et souhaitez maintenir un style visuel uniforme. Fournissez des captures de vos precedentes productions comme references :

{
  "model": "grok-imagine-video",
  "prompt": "Un smartphone pose sur un bureau minimaliste, l'ecran s'allume progressivement",
  "reference_images": [
    {"url": "https://exemple.com/campagne-visuel-1.jpg"},
    {"url": "https://exemple.com/campagne-visuel-2.jpg"}
  ],
  "duration": 5,
  "aspect_ratio": "16:9"
}

Style artistique

Vous souhaitez generer une video dans le style d’une illustration ou d’une peinture specifique :

{
  "model": "grok-imagine-video",
  "prompt": "Un voilier naviguant sur une mer calme au crepuscule",
  "reference_images": [
    {"url": "https://exemple.com/style-impressionniste.jpg"}
  ],
  "duration": 7
}

Palette de couleurs

Fournissez des images dont vous souhaitez reproduire la palette :

{
  "model": "grok-imagine-video",
  "prompt": "Foule marchant dans une rue urbaine animee, neons et lumieres",
  "reference_images": [
    {"url": "https://exemple.com/palette-neon-cyberpunk.jpg"}
  ],
  "duration": 5
}

Bonnes pratiques

Choix des images de reference

  • Selectionnez des images dont le style est coherent entre elles
  • Privilegiez des images de haute qualite et bien eclairees
  • 1 a 2 images de reference suffisent generalement
  • Plus vous ajoutez de references, plus le modele doit concilier des styles potentiellement differents

Redaction du prompt

  • Le prompt decrit le contenu de la video, les references definissent le style
  • Ne repetez pas dans le prompt ce que les images montrent deja en termes de style
  • Soyez explicite sur l’action et le mouvement

Combinaison text-to-video + references

C’est l’usage principal des images de reference : generer du nouveau contenu video (text-to-video) avec un style visuel controle par les references. Vous obtenez ainsi le meilleur des deux mondes.

Arbre de decision

Pour choisir entre les trois modes de generation :

  1. Vous voulez animer une image precise -> utilisez image
  2. Vous voulez generer du contenu nouveau avec un style particulier -> utilisez reference_images
  3. Vous voulez generer du contenu nouveau sans contrainte de style -> n’utilisez ni l’un ni l’autre

Points cles a retenir

  • reference_images guide le style visuel sans animer les images fournies
  • image et reference_images sont mutuellement exclusifs (erreur 400)
  • Les images de reference servent a la coherence de marque, au style artistique et a la palette de couleurs
  • 1 a 2 images de reference bien choisies suffisent pour un bon resultat
  • Le prompt decrit le contenu, les references definissent le style