Runbase

Command Palette

Search for a command to run...

OpenAI

GPT Image 2.5

ID :openai/gpt-image-2.5

API de génération d'images GPT Image 2.5 d'OpenAI — versions Flare et Sunburst, sortie jusqu'en 4K, 13 formats et édition par image de référence.

GPT Image 2.5ChatGPT Images 2.5OpenAIÉdition d'imageInpainting

Aperçu

API de génération d'images GPT Image 2.5 d'OpenAI — versions Flare et Sunburst, sortie jusqu'en 4K, 13 formats et édition par image de référence.

Authentification

Toutes les requêtes API nécessitent une clé API valide transmise via l'en-tête Authorization avec le schéma Bearer.

Démarrage rapide

Identifiants

Définissez la variable d'environnement RUNBASE_API_KEY.

Shell
export RUNBASE_API_KEY=your-api-key

Créer une exécution

Shell
curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

Exécutions

Les exécutions sont traitées de manière asynchrone. Soumettez une requête, puis interrogez le résultat.

Créer une exécution

Shell
curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

Obtenir le statut d'exécution

Shell
curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Obtenir le résultat

Interrogez l'endpoint de statut jusqu'à ce que status soit "succeeded", puis lisez output.urls dans la réponse.

Schéma d'entrée

ParamètreTypeRequisDescription
promptstringRequisPrompt
variantstringOptionnelVersionOptions : flaresunburst
aspect_ratiostringOptionnelAspect ratioOptions : auto1:13:22:316:99:164:33:421:927:1616:279:88:9
resolutionstringOptionnelResolutionOptions : 1K2K4K
image_urlsstring[]OptionnelReference images

Schéma de sortie

ChampTypeDescription
urlsstring[]URLs des résultats générés

Erreurs

L'API utilise les codes de statut HTTP standard pour indiquer le succès ou l'échec.

Code de statutDescription
400Requête invalide - paramètres manquants ou malformés
401Échec de l'authentification - clé API manquante ou invalide
402Crédits insuffisants
403Interdit - IP non autorisée ou limite de crédits de la clé API dépassée
404Exécution introuvable
429Limite de requêtes dépassée
500Erreur interne du serveur