FR ▾

API de texte sans censure pour vos pipelines d'images

Obtenir une clé API

API Gemini pour la génération d'images : de quoi s'agit-il

Ce n'est pas l'API de génération d'images proposée par Gemini, ni le service de Google sous aucune forme. C'est une API LLM textuelle indépendante compatible OpenAI avec un seul modèle.

Mis à jour le

Points clés

  • Le service est proposé par un tiers et n'est pas affilié à Google ou à ses modèles Gemini.
  • Il ne renvoie que du texte : pas de génération d'images, pas d'entrée d'image, pas d'embeddings.
  • Utilisez-le pour rédiger et affiner les prompts que vous enverrez ensuite au modèle de génération d'images de votre choix.
  • Les appels suivent le format de chat OpenAI, avec l'ID de modèle uncensored.
Deux îles reliées par un pont, l'une avec un terminal texte et l'autre avec un cadre vide, montrant des outils texte et image

S'agit-il de l'API image Gemini de Google ?

Non. Si vous êtes arrivé en cherchant un endpoint d'images Gemini, la première chose à régler est de savoir qui fait quoi. Gemini est la famille de modèles de Google, et Google propose la génération d'images via ses propres produits développeur. Quelles que soient les capacités de ces produits, vous y accédez via Google, avec les comptes, les clés et les conditions de Google.

Ce site est autre chose. C'est une API textuelle hébergée où un seul modèle à poids ouverts, exécuté par un fournisseur indépendant, est ajusté pour répondre sans refus de contenu pour un usage adulte légal. Ce n'est pas un revendeur de Gemini, il ne redirige pas les requêtes vers Google et n'a aucune approbation de Google ou d'un autre fournisseur de modèles. Le nom de domaine mentionne la génération d'images car de nombreux visiteurs cherchent de l'aide sur les prompts, et non parce que des images sont produites ici.

Ce que vous obtenez réellement

Le périmètre est délibérément restreint, ce qui le rend facile à évaluer en quelques minutes.

  • Protocole : Compatible OpenAI. Tout SDK ou client OpenAI fonctionne après avoir modifié deux éléments : l'URL de base et la clé.
  • URL de base : https://api.imagegenapi.com/v1
  • ID de modèle : uncensored
  • Méthodes : POST /v1/chat/completions et GET /v1/models
  • Fonctionnalités : streaming via SSE, appel de fonctions, mode JSON et passage des paramètres d'échantillonnage (temperature, top_p, stop, seed, pénalités).
  • Fenêtre de contexte : 100 000 tokens, prompt plus complétion.

Non inclus : génération d'images, entrée d'image, audio, vidéo, embeddings et fine-tuning. Si une fonctionnalité n'est pas dans la liste ci-dessus, supposez qu'elle est absente. La page de documentation contient le format de requête et les codes d'erreur.

Tiers versus officiel : comment faire la différence

La confusion est courante sur tout le marché, donc une liste de vérification rapide aide à chaque fois que vous rencontrez une API dont le nom ressemble à celui d'un grand fournisseur.

  1. Vérifiez le domaine et les conditions. Une API officielle vit sous le domaine et les conditions du fournisseur. Un service tiers le mentionne, ou du moins nomme son propre opérateur.
  2. Vérifiez la liste des modèles. Ici, GET /v1/models renvoie un seul modèle, uncensored. Un routeur listerait de nombreux noms de modèles de fournisseurs.
  3. Lisez ce qui est promis. Des affirmations telles que « le produit authentique, mais moins cher » méritent du scepticisme. Un service fiable vous indique quelles fonctionnalités manquent.
  4. Testez-le. Envoyez quelques requêtes avec le crédit d'essai avant de déplacer toute charge de travail.

Sur ce site, les réponses sont claires : fournisseur indépendant, un seul modèle à poids ouverts, texte uniquement. Traitez toute autre interprétation comme une erreur. Vous pouvez vérifier l'identité du modèle par le comportement, mais ne vous attendez pas à ce qu'il prétende être le produit d'un fournisseur particulier.

Une façon logique de combiner outils texte et image

Les modèles image sont pilotés par des prompts, et rédiger de bons prompts est principalement une tâche textuelle. Un flux de travail courant est donc en deux étapes : demander à un modèle de langage de produire un prompt détaillé, puis coller ou acheminer ce prompt dans le service image que vous avez choisi, celui de Google ou d'un autre. Le modèle texte ici gère l'étape un.

from openai import OpenAI

client = OpenAI(base_url="https://api.imagegenapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    temperature=0.7,
    messages=[
        {"role": "system", "content": "Turn a short idea into a detailed prompt for a text-to-image model. Include subject, setting, lighting, color palette and mood. One paragraph."},
        {"role": "user", "content": "A smuggler's market inside a hollowed-out whale skeleton, neon lanterns."},
    ],
)
print(resp.choices[0].message.content)

Pour un pipeline, demandez du JSON afin que l'étape suivante puisse lire les champs. Voici en Node avec le package officiel openai :

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.imagegenapi.com/v1",
  apiKey: process.env.API_KEY,
});

const res = await client.chat.completions.create({
  model: "uncensored",
  response_format: { type: "json_object" },
  messages: [
    { role: "user", content: "Return JSON with keys prompt and style for: a whale-skeleton night market." },
  ],
});

const out = JSON.parse(res.choices[0].message.content);
console.log(out.prompt);

Quelques remarques sur ces extraits. Le message système fait le gros du travail, donc consacrez-y votre temps. La clé API doit être placée dans une variable d'environnement, jamais dans le contrôle de source. Et si l'appel échoue avec un 429, attendez et réessayez au lieu de boucler à pleine vitesse, car une boucle serrée ne fait que brûler plus vite votre allocation par minute. Le même code s'exécute sans modification sur d'autres hôtes compatibles OpenAI, ce qui est l'intérêt du protocole partagé : vous pouvez changer de fournisseur en modifiant l'URL de base et le nom du modèle.

Rappelez-vous que l'orientation vers un usage adulte légal s'applique au contenu que vous demandez. La fiction, le jeu de rôle et les applications de compagnon sont les usages typiques, et le contenu sexuel impliquant des mineurs est bloqué sans exception.

Rédiger des prompts adaptés à un modèle image

La majeure partie de la valeur de l'étape texte vient des instructions que vous donnez, pas du modèle seul. Quelques habitudes rendent la sortie beaucoup plus utilisable.

Donnez au modèle une recette fixe

Dites-lui l'ordre des parties que vous voulez : sujet d'abord, puis décor, puis lumière, puis palette, puis style. Les modèles image ont tendance à pondérer davantage les premiers mots, donc un ordre stable garde les résultats comparables entre les exécutions. Ajoutez une limite de mots, car les prompts très longs diluent souvent le sujet principal plutôt que de l'améliorer.

Dites ce qu'il faut exclure

Certains outils image prennent un prompt négatif séparé, d'autres l'ignorent. Demandez au modèle texte de retourner les deux parties comme des champs JSON séparés, puis supprimez la seconde si votre outil n'en a pas besoin. C'est plus simple que de modifier un long paragraphe à la main.

Itérez dans la même conversation

Conservez les messages précédents dans la liste messages et demandez des modifications : lumière plus chaude, plan plus large, moins de personnages. La fenêtre de contexte est de 100 000 tokens, donc même une longue session d'édition tient. Baissez temperature lorsque vous voulez des modifications mineures et augmentez-la lorsque vous voulez des idées fraîches.

Testez quelques graines

Si vous passez le même seed avec les mêmes messages et paramètres, la sortie reste proche d'une exécution à l'autre. Ne changez qu'une seule chose à la fois, comme le message système, et vous pouvez dire quel changement a amélioré le résultat. Cette discipline fait économiser plus d'argent que n'importe quel palier de prix, car moins de générations d'images gaspillées sont la véritable économie de coût.

Coût de l'étape texte

Le prix est de 0,15 $ par 1 M de tokens d'entrée et de 0,50 $ par 1 M de tokens de sortie, prélevés sur le crédit prépayé, sans abonnement. Les requêtes refusées ou échouées ne sont pas facturées. Prenez un lot de 1 000 appels d'écriture de prompt, chacun avec 400 tokens d'entrée et 250 tokens de sortie.

  • Entrée par appel : 400 / 1 000 000 x 0,15 $ = 0,00006 $.
  • Sortie par appel : 250 / 1 000 000 x 0,50 $ = 0,000125 $.
  • Par appel : 0,000185 $.
  • Par 1 000 appels : 0,185 $.

Cela représente 18,5 cents pour le lot. Comparez-le avec le prix par image de votre fournisseur d'images, que vous devriez consulter sur leur page de tarification, et vous verrez généralement que l'étape d'écriture du prompt est la moins chère.

Premiers pas avec le crédit

Les nouveaux utilisateurs peuvent obtenir 0,50 $ de crédit d'essai en un clic sur la page des clés API après s'être inscrits avec Google ou avec un e-mail et un mot de passe. Aucun paiement n'est requis et cela dure 7 jours. Ensuite, rechargez avec n'importe quel montant entier de 20 $ à 500 $ en crypto (USDT sur TRC20 ou USDC sur Base). Des bonus de +5 % à partir de 50 $, +10 % à partir de 100 $ et +15 % à partir de 200 $ sont offerts, et le crédit n'expire jamais. Consultez la page tarifaire pour plus de détails.

Des limites à anticiper

Une clé complète permet 8 requêtes simultanées et 300 requêtes par minute. Une clé d'essai permet 2 requêtes simultanées et 60 par minute. Dépasser la première donne un HTTP 429 avec le code rate_limited, dépasser la seconde donne un 429 avec le code concurrency, et une surcharge temporaire donne un 429 avec un en-tête Retry-After: 5. Une requête en streaming occupe sa place jusqu'à la fin du streaming, alors fermez les streams que vous n'utilisez plus.

Les en-têtes de réponse incluent X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests et X-RateLimit-Limit-Concurrency. Journalisez l'ID de requête avec chaque erreur, car c'est le moyen le plus rapide d'obtenir de l'aide du support. La taille maximale du corps est de 8 Mo.

Si vous avez besoin d'un appel natif à l'image Gemini, rendez-vous sur le site de Google et lisez leur documentation actuelle. Si vous avez besoin d'un modèle de texte sans censure qui utilise le protocole OpenAI, pour rédiger des prompts, des histoires ou des dialogues de personnages pour un usage adulte légal, c'est fait pour cela.

Questions et réponses

Ce service utilise-t-il des modèles Gemini ?

Non. Il exécute un seul modèle à poids ouverts fourni par un prestataire indépendant et ne redirige ni vers Google ni vers un autre fournisseur.

Puis-je générer des images avec ?

Non. Il est réservé au texte. Vous pouvez l'utiliser pour rédiger des prompts destinés à un générateur d'images, mais l'image provient du service d'image que vous choisissez.

Quel ID de modèle dois-je utiliser ?

Utilisez uncensored avec l'URL de base https://api.imagegenapi.com/v1. Vous pouvez le vérifier avec une requête GET vers /v1/models.

Existe-t-il un moyen gratuit d'essayer ?

Oui. Après votre inscription, vous pouvez réclamer 0,50 $ de crédit d'essai gratuit en un seul clic sur la page de la clé API. Il est valable 7 jours et ne nécessite aucun paiement.

Votre clé n'est qu'à un formulaire

Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.

Obtenir une clé API