Blog

Tutoriel

Comment appeler fibo-gen-1.5/text-to-image via HiAPI : guide curl et Python

Nov 12, 2026
Illustration de couverture avec des points en demi-teintes vert menthe formant un gradient de densité discret sur un fond presque noir.
Sur cette page

Construire une requête fonctionnelle avec curl

fibo-gen-1.5/text-to-image est un modèle de génération d'image à partir de texte hébergé, accessible via le schéma de requête standard de HiAPI. Ce détail compte plus qu'il n'y paraît : pas besoin de télécharger des poids, de monter un GPU ni d'apprendre un SDK propre au modèle. Vous envoyez une requête HTTP contenant l'identifiant du modèle et un prompt, puis vous recevez une image. Le travail d'intégration se concentre sur trois points : la conception du prompt, les paramètres à définir et le traitement de la réponse.

Avant d'écrire la moindre ligne de code, voici quelques hypothèses que vous pouvez adopter sans risque :

  • Authentification unifiée. Chaque appel HiAPI transporte votre clé API dans l'en-tête de la requête. Il n'existe pas de flux d'authentification propre à chaque modèle.
  • Sélection du modèle par son nom. fibo-gen-1.5/text-to-image est placé dans le corps de la requête comme champ modèle et doit être écrit tel quel, suffixe /text-to-image compris.
  • Du point de vue de l'appelant, la génération est synchrone. Vous envoyez la requête, vous attendez, vous recevez la sortie. Le budget de timeout doit refléter la latence réelle de génération, pas supposer un retour instantané.
  • La réponse est structurée. Vous recevez une enveloppe JSON, et non un bloc de données binaires brutes ; il faut donc l'analyser avant d'utiliser l'image.

Si vous avez déjà intégré un autre modèle HiAPI, cela vous semblera familier. Si c'est votre premier, le schéma appris ici se transpose directement à tout le reste de la plateforme. La véritable connaissance propre au modèle réside dans le choix des paramètres, présenté plus loin dans ce guide.

Exécuter le même appel en Python

Commencez par l'appel minimal qui fonctionne. Exportez la clé pour éviter qu'elle n'apparaisse en clair dans l'historique du shell :

export HIAPI_API_KEY="your_api_key_here"

Envoyez ensuite la requête :

curl -sS -X POST "https://api.hiapi.ai/v1/images/generations" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fibo-gen-1.5/text-to-image",
    "prompt": "a weathered fisherman mending a net on a wooden dock at dawn, overcast light, 35mm photograph",
    "size": "1024x1024",
    "n": 1
  }'

Trois points méritent d'être signalés, car c'est là que les tentatives « copier-coller au hasard » échouent généralement :

  1. La chaîne du modèle doit être exacte. fibo-gen-1.5/text-to-image — pas fibo-gen-1.5, ni aucune variante de casse. Le moindre écart renvoie une erreur de type modèle introuvable, sans repli silencieux.
  2. La clé va dans l'en-tête Authorization sous forme de bearer token. Ne la placez pas dans le corps de la requête ni dans la chaîne de requête.
  3. Content-Type: application/json est obligatoire. Sans lui, certains proxys et passerelles altèrent la charge utile avant qu'elle n'atteigne l'API.

Si vous voulez voir exactement ce qui est renvoyé — en-têtes de réponse compris — ajoutez -i à l'appel curl. C'est l'habitude de débogage la plus utile lorsque la réponse semble vide : elle vous indique si vous avez reçu un 200 avec un corps de forme inattendue, ou un statut non 2xx à traiter. Pour explorer, pipez vers jq . afin de formater le JSON.

Une fois l'appel réussi, changez le prompt et relancez. En laissant le reste de l'appel inchangé, vous isolez les modifications de prompt des modifications de structure.

Passer en production

Le passage d'un script fonctionnel à une intégration fiable tient surtout aux aspects ingrats. Liste de contrôle :

  • Les clés ne doivent pas figurer dans le code. Chargez-les depuis des variables d'environnement ou un gestionnaire de secrets, ne les commitez jamais et renouvelez-les selon une périodicité réellement tenable. Utilisez des clés distinctes en développement et en production, afin qu'une fuite de clé de développement ne compromette pas le trafic en ligne.
  • Les timeouts sont explicites et justifiés. Fixez les limites d'après la latence de génération observée dans votre propre charge de travail, sans deviner. Enregistrez la durée réelle de chaque appel pour étayer ce chiffre.
  • Les tentatives sont bornées et sélectives. Réessayez les défaillances transitoires — timeouts, situations de limitation de débit — avec un backoff exponentiel et un plafond d'essais strict. Ne réessayez jamais une charge utile mal formée ou un échec d'authentification ; ils échoueront de la même façon à chaque fois et consommeront votre quota.
  • La sortie est validée avant d'être approuvée. Vérifiez que le nombre d'octets décodés atteint un volume raisonnable et que le fichier s'ouvre comme une image valide. Un fichier de zéro octet ou tronqué arrivé au CDN est pire qu'une erreur explicite à l'étape de génération.
  • Chaque génération est consignée. Stockez ensemble le prompt, les paramètres, la réponse et l'horodatage. Cela rend possibles, plus tard, la reproductibilité et l'imputation des coûts.
  • L'appel est encapsulé dans une fonction, au lieu d'être dispersé. Un unique generate() signifie que vous ne corrigez la logique de retry, les timeouts et le journalisation qu'à un seul endroit.

Lancez d'abord une requête fibo-gen-1.5/text-to-image propre avec curl, portez-la ensuite en Python, puis ajoutez la couche opérationnelle autour. La forme de la requête ne change jamais — seules les garanties que vous l'encadrez changent.

Articles similaires

Voir tous les articles →

Commencez avec des artefacts IA persistants

Obtenez votre clé API et appelez des modèles d'image, de vidéo et d'audio via une API unique basée sur les tasks.

Lire la documentation de l'API