Comment appeler plusieurs modèles d'image avec une seule clé API

Pourquoi les équipes recherchent une API de génération d'images unifiée

La génération d'images commence souvent par un seul modèle. Une équipe produit teste un prompt, intègre un SDK et livre un petit prototype. Les problèmes apparaissent plus tard : lorsque le produit a besoin de plusieurs styles de sortie — des brouillons rapides pour les relectures internes, du texte lisible sur une affiche, un rendu de texte chinois pour des campagnes marketing locales, ou des visuels photoréalistes sur une page produit.

Si chaque modèle impose sa propre clé API, sa structure de requête, son compte de facturation et son mode de callback, tester des modèles devient un travail d'infrastructure. Le modèle le plus simple consiste à garder l'authentification stable et à déplacer le choix du modèle dans le corps de la requête.

La page AI Image APIs de HiAPI est la principale page de comparaison pour ce workflow. Utilisez-la pour décider quel modèle d'image intégrer au produit, puis consultez la page de chaque modèle pour obtenir les paramètres et exemples exacts.

Utiliser une seule clé API côté serveur

La clé API doit être conservée côté backend, et non dans le code du navigateur. Le frontend peut collecter les prompts, les images ou les paramètres de génération, mais c'est au backend de créer les tâches HiAPI.

Créez ou renouvelez votre clé sur la page API Keys. En production, stockez-la dans une variable d'environnement du serveur et ajoutez-la comme en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Vous disposez ainsi d'un seul endroit pour renouveler les identifiants, d'un seul endroit pour ajouter des limites de débit, et d'une seule surface de facturation à surveiller lorsque le trafic des workflows de génération augmente.

Router par id de modèle, et non par client fournisseur

Le détail d'implémentation essentiel est de garder l'endpoint stable et de traiter l'id de modèle comme un paramètre de routage. Votre application peut exposer des préréglages tels que « draft », « poster », « product image » ou « photorealistic », puis le backend fait correspondre ces préréglages aux ids de modèle.

Par exemple, un produit peut d'abord utiliser Nano Banana pour une exploration créative rapide, recourir à GPT Image 2 lorsque l'image nécessite du texte lisible ou des prompts de remise en page, router les visuels pour réseaux sociaux chinois vers Qwen Image 2.0, et utiliser FLUX 1.1 Pro pour générer des visuels produit à l'aspect commercial.

Le code de l'application n'a pas besoin de quatre flux d'authentification pour cela. Il lui suffit d'un seul chemin de création de tâche et d'une petite couche de routage.

Modèle de requête minimal

Voici une requête compacte pour appeler GPT Image 2 via l'endpoint de tâche unifié :

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2/text-to-image",
    "input": {
      "prompt": "A premium ecommerce hero image for a smart lamp, clean studio lighting",
      "aspect_ratio": "16:9",
      "resolution": "1K"
    }
  }'

Pour les champs exacts de GPT Image 2, consultez la documentation de l'API GPT Image 2. Pour choisir un modèle, commencez par la comparaison des API d'images IA.

Un flux de production avec callbacks

Le polling est pratique pour les tests en local, mais le trafic de production profite généralement des callbacks. Lorsque le backend crée une tâche, transmettez une URL de callback et considérez ce callback comme la source de l'état final. Vous pouvez toujours conserver le polling des tâches comme solution de repli pour la réconciliation.

Le flux concret est le suivant :

1. Le frontend envoie le prompt et les paramètres de génération au backend.
2. Le backend valide la requête, choisit l'id de modèle et crée la tâche HiAPI.
3. HiAPI renvoie immédiatement l'id de tâche.
4. Le backend stocke l'id de tâche et attend le callback final.
5. Une fois la tâche dans son état final, l'application affiche l'URL de sortie.

Cela permet de garder les pages destinées aux utilisateurs réactives et d'éviter les boucles de polling agressives qui deviennent bruyantes à mesure que le volume de génération augmente.

Un workflow de coûts sans prix codés en dur

Ne copiez pas de grille tarifaire statique dans le code de l'application ni dans d'anciens documents internes. Le workflow le plus sûr consiste à orienter les utilisateurs et les équipes opérationnelles vers la page des tarifs en temps réel, puis à suivre l'usage au sein de votre propre produit.

Pour la génération d'icônes sensibles au coût, utilisez un modèle moins coûteux tant que les prompts évoluent encore. N'augmentez la résolution qu'une fois les prompts stabilisés. Lorsque la sortie nécessite un texte plus net, une mise en page plus stricte ou davantage de finition commerciale, migrez les visuels finaux de marque ou de produit vers un modèle plus puissant.

Ce modèle maintient l'expérimentation à faible coût tout en offrant au produit une voie finale de haute qualité.

Des liens internes pour garder le parcours SEO clair

Cet article vise à soutenir la page hub des API d'images, et non à la remplacer. La page de comparaison canonique est meilleures API de génération d'images IA. La page d'implémentation spécifique au modèle est API GPT Image 2. Les pages de conversion sont GPT Image 2 sur HiAPI, Tarifs et API Keys.

Pour les workflows adjacents, lisez Workflow API texte-vers-vidéo vs image-vers-vidéo et Facteurs de prix de GPT Image 2 et exemples de production.

Questions fréquentes

Une seule clé API peut-elle appeler plusieurs modèles d'image ?

Oui. Sur HiAPI, la même clé API permet de créer des tâches pour plusieurs modèles d'image. Il suffit de changer l'id de modèle dans le corps de la requête pour router vers un autre modèle d'image.

Dois-je exposer la clé API dans une application navigateur ?

Non. Gardez la clé côté serveur. Le code du navigateur doit appeler votre backend, qui crée ensuite les tâches HiAPI.

Par quel modèle d'image commencer ?

Commencez par le modèle qui correspond à la tâche. Nano Banana convient à l'idéation rapide, GPT Image 2 est un excellent choix par défaut pour les prompts longs et le texte lisible, Qwen Image 2.0 est adapté au rendu de texte chinois, et FLUX 1.1 Pro est plus adapté aux visuels produit photoréalistes.

Où consulter les tarifs ?

Utilisez la page HiAPI Pricing pour consulter les tarifs actuels en temps réel. Évitez de copier des prix fixes dans des articles ou du code produit, sauf si vous disposez d'un processus de maintenance pour les mettre à jour.