Gemini 3.1 Flash Image Preview

• Modèle : gemini-3.1-flash-image-preview (fixe)
• Fonctionnalités : Texte-à-image, image-à-image (jusqu'à 14 références), jusqu'en 4K, ratios d'aspect extrêmes, ancrage optionnel par recherche Google

N'appelez pas ce modèle via /v1/chat/completions — vous obtiendrez une erreur 400 avec une indication pour utiliser l'API Images.

Points d'accès

Mode	Point d'accès	Quand l'utiliser
Synchrone (recommandé)	POST https://apimaster.ai/v1/images/generations	Un seul aller-retour HTTP ; la plateforme interroge l'amont et renvoie { "data": [{ "url" }] }
Asynchrone	POST https://apimaster.ai/v1/images/generations/async → GET https://apimaster.ai/v1/tasks/{task_id}?model=gemini-3.1-flash-image-preview	Tâches longues, files d'attente personnalisées

Démarrage rapide (synchrone)

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "Ville cyberpunk la nuit, lumières néon",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

Succès

{
  "created": 1782633696,
  "data": [{ "url": "https://apimaster.ai/imgs/1782633695067198543.jpg" }]
}

Définissez le délai d'attente de lecture HTTP sur ≥ 180s pour le 2K/4K. Téléchargez ou mettez en miroir les URL rapidement — elles expirent.

Flux asynchrone

Soumettre

curl -s "https://apimaster.ai/v1/images/generations/async" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "un corgi astronaute sur la lune",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Réponse de soumission

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K" }]
}

Interroger

curl -s "https://apimaster.ai/v1/tasks/TASK_ID?model=gemini-3.1-flash-image-preview" \
  -H "Authorization: Bearer YOUR_API_KEY"

En cas de succès, lisez data.result.images[0].url. Statuts d'interrogation typiques : in_progress → succeeded / completed.

Attendez 10–20s avant la première interrogation, puis toutes les 3–5s.

Authentification

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Paramètres du corps

Champ	Type	Requis	Notes
model	chaîne	oui	gemini-3.1-flash-image-preview
prompt	chaîne	oui	Description de la scène
size	chaîne	non	Ratio d'aspect ; voir ci-dessous
resolution	chaîne	non	0.5K / 1K / 2K / 4K, défaut 1K ; insensible à la casse
n	entier	non	Seulement 1 pris en charge (numérique, pas chaîne)
image_urls	tableau	non	Images de référence (URL ou URI de données)
google_search	booléen	non	Ancrage par recherche textuelle Google
google_image_search	booléen	non	Nécessite google_search: true

Résolution et paliers de facturation

Valeur	~pixels	Prix par rapport à la base 1K
0.5K	~512	identique à 1K
1K	~1024	base
2K	~2048	× 4/3
4K	~4096	× 2

Frais réels = prix du canal × multiplicateur de résolution × ratio de groupe. Voir le marketplace ou les journaux de la console.

Erreurs

HTTP	Signification
400	Mauvais paramètres, ou mauvais point d'accès (chat)
401	Clé API invalide
402	Solde insuffisant
408	Délai d'attente de l'interrogation synchrone — réessayez en asynchrone ou réduisez la résolution
500 / 502	Erreur amont ou de la plateforme

Les ratios d'aspect invalides peuvent apparaître comme une erreur 500 lorsqu'un seul canal est configuré.

Remarques

• Les journaux d'utilisation incluent result_url pour l'aperçu de l'image et request_data.effective_resolution.
• Les prix varient selon le canal et la résolution — voir le marketplace.