Clé API Flux : ce que c'est et où s'insère une API texte
Une clé API Flux est un identifiant pour un service de génération d'images, et ce site n'en vend pas. Ce qu'il vend est une clé différente, pour une API LLM texte hébergée capable de rédiger et d'enrichir les prompts que vous envoyez à un modèle d'image.
Mis à jour

Points clés
- Une clé pour un service d'image Flux et une clé pour une API LLM texte sont deux choses distinctes, émises par deux fournisseurs distincts.
- Ce site est uniquement texte : pas de génération d'images, d'audio ou de vidéo, et il n'est pas géré par un fournisseur de modèles d'image.
- Une clé texte est utile à côté d'une clé image car la rédaction de prompts est une tâche textuelle, facturée par token.
- Vous modifiez une seule URL de base et une clé dans n'importe quel client OpenAI pour commencer, et un crédit d'essai couvre les premiers tests.
Commencez avec le crédit d'essai
E-mail et mot de passe, la clé s'affiche tout de suite à l'écran.
Obtenir une clé APICe que les gens entendent généralement par clé Flux
Flux est le nom d'une famille de modèles text-to-image. Lorsque quelqu'un tape flux api key dans une zone de recherche, il veut presque toujours un identifiant qui permette à son code d'envoyer un prompt à un service hébergeant l'un de ces modèles d'image et de recevoir une image en retour. Cet identifiant provient de l'entreprise qui gère l'endpoint d'image que vous avez sélectionné. Il est lié à leur compte, à leur facturation et à leurs conditions.
Vous verrez l'expression utilisée de quelques manières légèrement différentes, et il est utile de les distinguer avant de coller une clé n'importe où :
- Une clé d'un fournisseur d'images qui sert des modèles Flux, utilisée dans une requête qui retourne une image.
- Une clé pour une configuration locale ou auto-hébergée, où vous créez vous-même le token et rien ne quitte votre machine.
- Une clé pour un autre outil de votre pipeline, comme un modèle texte qui rédige les prompts, qui n'est appelé Flux que parce que le projet porte ce nom.
Seules les deux premières produisent des images. La troisième est l'endroit où se situe ce site. Nous exécutons une API LLM hébergée compatible OpenAI, et la clé que vous obtenez ici s'adresse à cette API et à rien d'autre.
Pourquoi une clé image n'appelle pas de modèle de chat
Les deux types de clés se ressemblent, car ce sont de longues chaînes que vous envoyez dans un en-tête Authorization, mais elles ouvrent des portes différentes. La clé d'un fournisseur d'images est vérifiée par ce fournisseur. Si vous l'envoyez à un endpoint de chat, vous obtenez une erreur d'authentification, et l'inverse est tout aussi vrai : une clé de ce site retourne une erreur si vous l'envoyez à un fournisseur d'images.
Les corps de requête diffèrent également. Un appel image transporte généralement un prompt, des dimensions, une graine et un nombre d'images. Un appel chat transporte une liste de messages avec des rôles et retourne du texte. Il n'y a pas de schéma partagé, donc rien à traduire entre eux. Si vous avez un script qui fonctionne contre un fournisseur d'images, gardez ce script et sa clé exactement tels quels. Ajoutez l'appel texte comme une étape distincte devant.
Ce que ce service ne fait pas
Pour garder les attentes claires : l'API ici est uniquement du texte. Elle ne génère pas d'images, d'audio ou de vidéo, ne crée pas d'embeddings, et n'offre pas de fine-tuning. Ce n'est l'API officielle d'aucun fournisseur de modèle et ce n'est pas un routeur entre fournisseurs. Elle sert un seul modèle à poids ouverts, ajusté pour répondre sans refus de contenu pour une utilisation adulte légale, et géré par un fournisseur indépendant. L'ID de modèle que vous passez est uncensored.
Où une API texte s'insère à côté d'une clé image
La rédaction de prompts est le point de rencontre évident. Les modèles d'image répondent bien aux descriptions spécifiques et structurées : sujet, décor, objectif, éclairage, couleur, humeur. La plupart des gens les écrivent à la main, puis les réécrivent après un mauvais résultat. Un modèle texte peut faire la première ébauche, développer une idée de trois mots en une description complète, ou produire vingt variations sur un thème pendant que vous allez prendre un café.
Quelques tâches qui s'adaptent bien :
- Expansion. Transformez une idée courte en un prompt détaillé dans un style que vous définissez une fois dans le message système.
- Variation. Demandez dix prises différentes sur un même sujet, retournées sous forme de liste JSON que votre script peut parcourir.
- Nettoyage. Réécrivez un prompt désordonné écrit par un client pour quelque chose qu'un modèle d'image gère mieux.
- Scripts et légendes. Rédigez la narration, la liste des plans ou la légende qui accompagne l'image.
Comme le modèle ici ne refuse pas par défaut, il convient à la fiction, à la conception de personnages et aux thèmes matures que d'autres modèles hébergés refusent souvent, tant que l'utilisation est légale et concerne des adultes. Une limite stricte s'applique partout : pas de contenu sexuel impliquant des mineurs. Nous n'acceptons les requêtes de ce type sous aucune forme.
Une première requête en moins d'une minute
Tout SDK OpenAI ou client HTTP fonctionne une fois que vous avez échangé l'URL de base et la clé. L'endpoint pour le chat est POST /v1/chat/completions, et GET /v1/models liste le modèle. Voici la même requête en curl et en Python.
curl https://api.fluxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
{"role": "user", "content": "a lighthouse in a storm, painterly"}
]
}'
from openai import OpenAI
client = OpenAI(
base_url="https://api.fluxapikey.com/v1",
api_key="YOUR_KEY",
)
reply = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
{"role": "user", "content": "a lighthouse in a storm, painterly"},
],
)
print(reply.choices[0].message.content)
Quelle que soit la chaîne qui revient, c'est ce que vous remettez à votre service d'image, en utilisant la clé propre à ce service. Les deux ne se touchent jamais. Pour la liste complète des paramètres, y compris le streaming, l'appel de fonctions et le mode JSON, consultez la documentation API.
Avez-vous besoin des deux clés ?
Cela dépend de ce que vous construisez. Le tableau ci-dessous est un moyen rapide de décider.
| Votre objectif | Clé image | Clé texte |
|---|---|---|
| Générer des images à partir de prompts que vous écrivez vous-même | Oui | Non |
| Générer des images à partir de prompts qu'un modèle rédige ou développe | Oui | Oui |
| Rédiger uniquement des histoires, des dialogues ou des scripts | Non | Oui |
| Construire une application de chat ou de jeu de rôle pour adultes | Non | Oui |
| Produire en lot des centaines de variations de prompts | Optionnel | Oui |
Si vous tapez toujours vos propres prompts et qu'ils vous conviennent, une clé texte ajoute peu. Si vous vous retrouvez à réécrire des prompts tout l'après-midi, ou si vous avez besoin de volume, elle rentabilise rapidement son coût. Nous avons également un guide court sur l'utilisation d'un LLM texte dans les workflows vidéo, qui suit la même idée d'une étape texte devant une étape média.
Les erreurs liées à la confusion des clés
La plupart des problèmes dans une configuration à deux services sont mineurs et faciles à repérer une fois que vous savez quoi chercher.
- URL de base incorrecte. Si votre client pointe toujours vers l'hébergeur précédent, la nouvelle clé est rejetée. Vérifiez que l'URL de base se termine par
/v1et correspond à celle de l'exemple ci-dessus. - Nom de modèle incorrect. Le seul ID de modèle ici est
uncensored. Passer le nom d'un modèle d'image renvoie une erreur, car il n'y a pas de tel modèle sur cette API. - Clés dans une seule variable d'environnement. Donnez à chaque service sa propre variable, par exemple
TEXT_API_KEYetIMAGE_API_KEY. Partager un seul nom est la façon dont une clé finit envoyée au mauvais hôte. - S'attendre à des images dans la réponse. La réponse est du texte brut dans
choices[0].message.content. Si vous avez besoin d'une image, ce texte doit être envoyé à votre service d'image comme un deuxième appel. - Ignorer le 429. Un pic supérieur à 8 requêtes simultanées renvoie un 429 avec le code d'erreur
concurrency, et au-dessus de 300 requêtes par minute avecrate_limited. Attendez brièvement et réessayez. Une requête en streaming occupe son slot jusqu'à la fin du flux, donc fermez les streams que vous ne lisez plus.
La clé d'essai a des plafonds plus bas : 2 requêtes simultanées et 60 par minute. C'est largement suffisant pour tester une étape de rédaction de prompts à la main, mais un lot important devrait attendre une clé rechargée.
Coût de l'écriture de prompts
La facturation est par token et prépayée : 0,15 $ par 1 M de tokens d'entrée et 0,50 $ par 1 M de tokens de sortie, sans abonnement. Les tâches de prompt sont petites, donc les montants sont faibles. Prenons une requête avec un message système de 600 tokens plus une idée (entrée) et un prompt développé de 250 tokens (sortie). L'entrée coûte 600 / 1 000 000 x 0,15 $ = 0,00009 $. La sortie coûte 250 / 1 000 000 x 0,50 $ = 0,000125 $. Une requête coûte 0,000215 $.
Un lot de 1 000 de ces requêtes coûte donc environ 0,215 $. Le crédit d'essai gratuit de 0,50 $, que vous pouvez réclamer en un clic sur la page de la clé après votre inscription, en couvre environ 2 300 (0,50 / 0,000215). Aucune carte n'est nécessaire et il dure 7 jours. Les requêtes échouées ou refusées ne sont pas facturées, et le crédit que vous ajoutez par la suite n'expire jamais. Les détails sont sur la page tarifs.
Obtention de votre clé texte
Inscrivez-vous avec Google, ou avec un e-mail et un mot de passe, puis ouvrez la page des clés API. Réclamez le crédit d'essai là-bas si vous voulez tester d'abord. Les recharges payantes vont de 20 $ à 500 $ en tout montant entier, avec +5 % de bonus à partir de 50 $, +10 % à partir de 100 $ et +15 % à partir de 200 $. Vous pouvez payer avec de la crypto (USDT sur TRC20, USDC sur Base).
Conservez la clé hors du code côté client et hors des dépôts publics. Les prompts que vous envoyez ne sont pas utilisés pour l'entraînement, mais une clé divulguée dépense votre crédit. La clé complète permet 8 requêtes simultanées et 300 requêtes par minute, donc un lot de prompts peut s'exécuter en parallèle sans travail supplémentaire.
Plus de guides
Questions et réponses
Puis-je utiliser cette clé pour générer des images avec Flux ?
Non. La clé fonctionne uniquement contre l'API texte de ce site. La génération d'images nécessite une clé d'un fournisseur qui héberge un modèle d'image.
S'agit-il de l'API officielle de Flux ?
Non. Il s'agit d'une API textuelle indépendante, hébergée et compatible OpenAI, avec un seul modèle, nommé uncensored. Elle n'est pas gérée par un fournisseur de modèles d'image et ne revend pas leurs services.
Le modèle texte peut-il écrire des prompts pour mon outil d'image ?
Oui. Demandez un prompt dans le message système, récupérez le texte de la réponse et collez-le ou envoyez-le à votre service d'image. Les deux services restent indépendants.
Ai-je besoin d'une carte pour l'essayer ?
Non. Les nouveaux utilisateurs peuvent réclamer 0,50 $ de crédit d'essai en un clic sur la page des clés, valable 7 jours, sans carte nécessaire.
Votre clé n'est qu'à un formulaire de distance
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.