Ce guide présente l’API de génération d’images, le choix du modèle, les paramètres et les méthodes d’appel.

La génération d’images avec les grands modèles Guishu est maintenant disponible. Qu’il s’agisse d’une couverture pour un compte officiel, d’une illustration de produit, d’une icône d’application, d’une image de produit ou de la création automatique d’illustrations par un agent, vous pouvez tout générer directement au moyen d’une interface unifiée. API de génération d’images : POST https://api.llm-token.cn/v1/images/generations

I. L’essentiel : ces 3 éléments suffisent pour commencer ✨

Élément requis	Valeur à renseigner
Clé Guishu Token	Dans l’en-tête de la requête, saisissez `Authorization: Bearer 你的new-api-token`
API de génération d’images	`https://api.llm-token.cn/v1/images/generations`
Modèle de génération d’images	`image-01` ou `image-01-live`

Les grands modèles Guishu unifient déjà l’intégration des modèles, l’adaptation de l’API, la gestion des quotas et les règles de facturation. Avec votre propre clé Guishu Token, une seule interface vous permet d’accéder à la génération d’images.

II. Tester en 1 minute : exemple avec curl 🚀

Remplacez YOUR_NEW_API_TOKEN ci-dessous par votre propre clé Guishu Token pour effectuer directement un test.

curl https://api.llm-token.cn/v1/images/generations \
  -H "Authorization: Bearer YOUR_NEW_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "一张可爱的蓝色 AI 小机器人图标，白色背景，极简 3D 风格，居中构图，不要文字",
    "response_format": "url",
    "n": 1,
    "aspect_ratio": "1:1",
    "prompt_optimizer": false
  }'

Pour votre premier test, générez d’abord 1 image, c’est-à-dire avec n: 1. Après avoir confirmé que la génération fonctionne normalement, adaptez le format, le style et la quantité à vos besoins.

III. Comment renseigner les paramètres de la requête ? 🧩

Paramètre	Obligatoire	Valeur courante	Explication
`model`	Oui	`image-01`	Nom du modèle de génération d’images. Pour disposer d’une génération plus réactive, vous pouvez également saisir `image-01-live`.
`prompt`	Oui	Selon l’image souhaitée	Décrivez l’image que vous souhaitez générer. Précisez de préférence le sujet, le style, les couleurs, la composition et l’usage.
`response_format`	Non	`url`	Il est recommandé d’utiliser `url` pour recevoir directement un lien vers l’image ; vous pouvez aussi employer `base64` selon les besoins de votre application.
`n`	Non	`1`	Nombre d’images à générer en une fois. Pour un test classique, commencez par `1`.
`aspect_ratio`	Non	`1:1`	Format de l’image. Valeurs courantes : `1:1`, `16:9`, `9:16`, `4:3`, `3:4` et `21:9`.
`prompt_optimizer`	Non	`false`	Active ou non l’optimisation du prompt. Si vous souhaitez respecter plus strictement le texte d’origine, choisissez `false`.
`seed`	Non	Entier	Améliore la reproductibilité. Pour générer plusieurs fois des résultats proches, conservez la même seed.
`width` / `height`	Non	Généralement inutiles	Dans la plupart des cas, `aspect_ratio` suffit ; ne transmettez ces paramètres que si vous avez besoin d’une largeur et d’une hauteur précises.

Si la réponse contient l’URL de l’image, enregistrez-la rapidement après la génération. Le lien convient à un aperçu ou un téléchargement temporaire, mais ne doit pas servir d’adresse permanente pour votre ressource.

IV. Pourquoi les grands modèles Guishu simplifient-ils l’intégration ? 🍬

Une intégration classique impose souvent de passer d’une plateforme de modèles à l’autre, avec des clés, des interfaces et des modes de facturation différents. Le développement et la maintenance deviennent alors plus complexes.

Les grands modèles Guishu unifient tous ces éléments. Avec une seule clé Guishu Token, vous pouvez appeler la génération d’images depuis une interface unifiée. La consommation, le coefficient et le solde correspondent aux informations du tableau de bord Guishu Token, ce qui facilite leur suivi.

Fonctionnalité	Explication
Interface unifiée	Toutes les générations passent par `https://api.llm-token.cn/v1/images/generations`, pour une intégration plus simple.
Clé unifiée	Utilisez le `new-api-token` généré dans le tableau de bord Guishu Token, sans changer de plateforme.
Facturation unifiée	La consommation, le coefficient et le solde sont ceux du tableau de bord Guishu Token, ce qui facilite la gestion des coûts en équipe.
Adaptée à l’intégration métier	Convient notamment aux illustrations de comptes officiels, aux images de produits, aux couvertures, aux illustrations automatiques d’agents et à la production de ressources en série.

En une phrase : une clé Guishu Token et une seule interface suffisent pour intégrer la génération d’images à votre produit et à vos flux de travail.

V. Comment utiliser image-01-live ? ⚡

image-01-live utilise la même API de génération d’images. Conservez tous les autres paramètres et remplacez simplement model par image-01-live.

{
  "model": "image-01-live",
  "prompt": "一张赛博风格的蓝色产品宣传图，干净背景，科技感，适合公众号封面",
  "response_format": "url",
  "n": 1,
  "aspect_ratio": "16:9",
  "prompt_optimizer": false
}

Si ce modèle est activé pour votre compte, vous pouvez l’appeler directement de cette manière.

VI. Exemple Python pour l’intégrer à votre projet 🐍

import requests

url = "https://api.llm-token.cn/v1/images/generations"
headers = {
    "Authorization": "Bearer YOUR_NEW_API_TOKEN",
    "Content-Type": "application/json",
}
payload = {
    "model": "image-01",
    "prompt": "一张科技感很强的蓝色应用图标，白色背景，极简 3D 风格，居中构图，不要文字",
    "response_format": "url",
    "n": 1,
    "aspect_ratio": "1:1",
    "prompt_optimizer": False,
}

resp = requests.post(url, headers=headers, json=payload, timeout=120)
resp.raise_for_status()
print(resp.json())

La génération d’images prend plus de temps qu’une conversation textuelle classique. Réglez le délai d’expiration du client sur environ 120 secondes afin d’éviter qu’il n’interrompe la requête avant la fin de la génération.

VII. Comment décrire une image pour obtenir un meilleur résultat ? 🪄

Pour plus de régularité, décrivez l’image dans l’ordre suivant :

Sujet : ce que vous souhaitez représenter, par exemple « robot IA bleu » ou « affiche d’analyse de la Coupe du monde ».
Scène : le lieu ou l’environnement, par exemple « fond blanc », « sous les projecteurs d’un stade » ou « bureau ».
Style : minimaliste, réaliste, 3D, illustration, affiche commerciale, rendu photographique, etc.
Composition : centrée, vue du dessus, en buste, avec espace vide, couverture horizontale, etc.
Couleurs : couleurs principales et secondaires, par exemple bleu et blanc, noir et or, ou contraste rouge et bleu.
Contraintes : par exemple « sans texte », « sans filigrane » ou « fond épuré ».

Vous pouvez reprendre directement ce petit modèle :

一张【比例】的【用途】图片，主体是【主体】，场景是【场景】，整体风格为【风格】，主色为【颜色】，构图【构图要求】，细节要求【限制或补充】。

Exemple :

一张 1:1 的应用图标，主体是蓝色发光的 AI 芯片，白色背景，极简 3D 风格，居中构图，边缘清晰，不要文字。

VIII. En cas de problème, consultez d’abord cette section 🛟

Symptôme	Solution
Échec de l’authentification	Vérifiez que l’en-tête est bien `Authorization: Bearer YOUR_NEW_API_TOKEN` et que le token ne contient aucun espace copié par erreur.
Le modèle est introuvable	Vérifiez que le nom du modèle est exactement `image-01` ou `image-01-live`, sans modifier les majuscules ou minuscules.
Le format de l’image ne correspond pas au résultat attendu	Modifiez d’abord `aspect_ratio`. Pour la couverture d’un compte officiel, vous pouvez utiliser `16:9` ; pour un avatar ou une icône, utilisez `1:1`.
Le lien de l’image ne s’ouvre pas	L’URL de l’image a peut-être expiré. Téléchargez-la rapidement après sa génération ou transférez-la dans votre propre bibliothèque de ressources.
La requête prend beaucoup de temps	La génération d’images demande du temps ; réglez le délai d’expiration de la requête sur au moins 120 secondes.
Le résultat manque de régularité	Décrivez vos besoins plus précisément et évitez les instructions contradictoires ; pour obtenir des résultats proches, vous pouvez conserver la même `seed`.

IX. Version à transmettre directement à votre équipe de développement 📮

Nous utilisons les grands modèles Guishu pour générer des images via l’API POST https://api.llm-token.cn/v1/images/generations. L’en-tête de la requête contient Authorization: Bearer YOUR_NEW_API_TOKEN. Dans le corps, indiquez model: image-01 ou model: image-01-live, puis transmettez notamment prompt, response_format: url, n et aspect_ratio.

X. À quels usages cette API convient-elle ? 📚

Usage	Possibilités
Illustrations pour un compte officiel / Xiaohongshu	Générez rapidement des couvertures, des visuels d’en-tête, des affiches d’événements et des illustrations d’articles.
Pages de produits et de SaaS	Générez des icônes d’application, des illustrations fonctionnelles, des bannières et des visuels d’état vide.
Commerce en ligne et ressources produit	Générez des arrière-plans de produit, des visuels promotionnels et des images d’ambiance pour les pages détaillées.
Flux de travail automatisés par des agents	Permettez à un agent de créer automatiquement des illustrations à partir du contenu afin d’améliorer la productivité.

Your privacy choices

Tutoriel de génération d’images avec les grands modèles Guishu