RéférenceGPT Image 2.5 Stable

Guide API du studio TopviewAI Pro

Gérez les clés API et comprenez les requêtes du studio après connexion. L’exemple d’image utilise GPT Image 2.5 ; les autres modèles ont leurs propres formats de requête.

https://topviewai.pro

Démarrage rapide

Réalisez votre premier appel API en deux étapes : soumettre une tâche, puis interroger son statut.

Soumettre une tâche

Envoyez une requête POST au point de génération pour obtenir un ID de tâche.

Interroger le statut

Utilisez l’ID de tâche pour vérifier la progression jusqu'à obtenir l’URL de l’image.

Authentification

Ces points d’accès du studio exigent une session connectée et une clé API. Une clé Bearer seule ne suffit pas. Gardez votre clé privée.

En-tête HTTP

Authorization: Bearer {YOUR_API_KEY}

POST

https://topviewai.pro/api/image/gpt-image-2-5/generate

Envoyez une requête d’image GPT Image 2.5. La réponse contient un task_id ; consultez le résultat via le point d’accès de statut correspondant.

La requête est asynchrone : conservez task_id et interrogez le statut jusqu’à SUCCESS ou une erreur définitive.

Paramètres du corps

Nom du paramètre	Type	Requis	Description
`prompt`	string	Oui	Décrivez l’image en 1 à 20 000 caractères.
`aspect_ratio`	string	Non	Format d’image facultatif, auto par défaut. Exemples : 1:1, 4:3, 3:4, 16:9, 9:16.

Réponse (JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://topviewai.pro/api/image/gpt-image-2-5/status

Interroger l'état et le résultat d’une tâche.

Paramètres de requête

Nom du paramètre	Requis	Description
`task_id`	Oui	L’ID renvoyé lors de la soumission.

Exemple de réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "Un coucher de soleil sur les montagnes",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 4,
    "created_at": "2026-11-05 13:05:09",
    "error_message": null
  }
}

Facturation

Exemple de coût GPT Image 2.5

4 crédits / image 1K

Le coût dépend du modèle, de la résolution et des réglages. Vérifiez l’estimation du studio et la consommation indiquée par la tâche.

Gestion des erreurs

401 Non autoriséClé API invalide
402 Paiement requisSolde insuffisant
429 Trop de requêtesLimite de requêtes atteinte

À propos de TopviewAI Pro

Un studio commun à la vidéo, aux images, à la retouche, à la voix et à l’audio.

Choisir le modèle pour chaque tâche

Utilisez Seedance 2.5 pour la vidéo, GPT Image 2.5 pour les images et les autres modèles du studio. Chacun conserve son vrai nom.

Un solde, des coûts propres à chaque modèle

Choisissez un abonnement ou une recharge ponctuelle à la demande. Les crédits paient les modèles et outils réellement utilisés.

Outils d’image Outils vidéo