Génération d’images (OpenAI Images API)

POST /v1/images/generations génère des images au format OpenAI Images API : vous envoyez une requête et recevez l’image dans la même réponse. Il s’agit d’un adaptateur utilisant la même file d’attente que POST /api/media/generate : les modèles, le prix, la vérification du solde, le basculement vers un autre fournisseur et la facturation sont partagés ; une même génération coûte donc le même prix sur les deux adresses.

curl https://getvibeapi.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"nano-banana","prompt":"a red bicycle on a bridge","n":1,"size":"1024x1024"}'

Réponse (HTTP 200) :

{
  "created": 1792706400,
  "data": [{ "url": "https://getvibeapi.com/media/r/…/0.png" }]
}

Transmettez la clé sous la forme Authorization: Bearer sk-pv-… ou x-api-key. Le SDK officiel OpenAI fonctionne tel quel :

from openai import OpenAI

client = OpenAI(base_url="https://getvibeapi.com/v1", api_key="sk-pv-...", timeout=600)
image = client.images.generate(model="nano-banana", prompt="a red bicycle on a bridge", size="1024x1024")
print(image.data[0].url)

Les champs inconnus ainsi que background, style, output_format, output_compression, moderation, stream et partial_images sont refusés avec le code 400, champ par champ, plutôt que d’être ignorés silencieusement — sinon vous paieriez pour une image que vous n’avez pas demandée. Les modèles qui nécessitent une image source (édition, mise à l’échelle, inpainting) ne fonctionnent pas à cette adresse, car il n’est pas possible d’y transmettre une image ; utilisez POST /api/media/generate.

La requête reste ouverte jusqu’à la fin de la tâche, pendant 300 secondes au maximum. Le temps médian est de 15 à 85 secondes selon le modèle ; les générations individuelles sur les modèles les plus lents prennent 3–4 minutes. Définissez le délai d’expiration de votre client à au moins 300 secondes (la valeur par défaut du SDK OpenAI est de 600).

• Chaque réponse, y compris les erreurs survenant après la création de la tâche, contient l’en-tête x-pv-media-job-id avec l’id de la tâche.
• Si la tâche n’est pas terminée dans les 300 secondes, la réponse est 504 avec cause: image_generation_timeout et l’id de la tâche dans le message. La génération continue de s’exécuter : récupérez-la depuis GET /api/media/jobs/{id}.
• Si la connexion est interrompue (délai d’expiration de l’application, réseau), la tâche est tout de même menée à son terme. GET /v1/images/generations?limit=20 (jusqu’à 100) répertorie les images récentes de cette clé avec leur statut, leurs liens et le montant facturé cost_rub.

Rien n’est facturé lors de la soumission. Seule une génération terminée avec succès est facturée, au même prix que dans /api/media-catalog et dans le devis POST /api/media/price. Une génération échouée renvoie 502 en indiquant « Rien n’a été facturé » et ne coûte rien. Le montant facturé est renvoyé dans l’en-tête x-pv-cost-rub. Si le solde ne permet pas de couvrir la génération, la réponse est 402 avant le démarrage de toute tâche.

Toute application capable de générer des images via un fournisseur compatible avec OpenAI fonctionne. Exemple avec Cherry Studio :

1. Ajoutez un fournisseur de type OpenAI avec l’adresse d’API https://getvibeapi.com (l’application ajoute elle-même /v1) et votre clé sk-pv-….
2. Ajoutez le modèle manuellement, en utilisant un id de https://getvibeapi.com/api/media-catalog (uniquement les entrées avec kind: "image"), par exemple nano-banana ou gpt-image-2. La liste des modèles de l’application affiche les modèles de texte ; les modèles multimédias n’y figurent pas.
3. Générez l’image depuis la fonctionnalité de dessin / de génération d’images de l’application, et non depuis le chat ordinaire. Le chat envoie la requête à /v1/chat/completions, où les modèles d’image ne fonctionnent pas.
4. Si l’application vous permet de définir un délai d’expiration de la requête, définissez-le à au moins 300 secondes. Une image abandonnée par l’application est répertoriée à GET /v1/images/generations. Relancer depuis l’application crée une nouvelle génération, facturée séparément.

Le mode qui modifie une image téléversée dans de telles applications s’appelle /v1/images/edits ; il est également pris en charge (voir ci-dessous).

POST /v1/images/edits prend en charge la requête du SDK OpenAI (multipart/form-data : le fichier dans image, ou plusieurs fichiers dans image[], avec prompt, model, size, quality et response_format) ou le JSON avec images: [{"image_url": "…"}]. Il fonctionne comme la génération ci-dessus : la même réponse, le même délai d’attente, les mêmes x-pv-media-job-id et le même prix que POST /api/media/generate avec une image source ; une modification échouée n’est pas facturée. Le mode de modification du modèle est sélectionné dans le catalogue. Un mask est refusé avec 400 unsupported_parameter, et un modèle qui n’accepte aucune image source avec model_cannot_edit. Pour une modification masquée, utilisez POST /api/media/generate et interrogez GET /api/media/jobs/{id} — consultez le guide de génération asynchrone. Les vidéos ne sont pas générées de manière synchrone : /v1/video/generations et /v1/videos renvoient également 410 (détails).

Dans le catalogue et dans tout nouveau code, utilisez nano-banana-pro. Pour migrer des clients asynchrones existants, la valeur gemini-3-pro-image est encore acceptée uniquement dans le champ model de la requête /api/media/generate et correspond au même modèle public. Elle n’est pas publiée dans la découverte ni dans les tarifs.