Génération Grok 5 Imagine

Documentation API

Utilisez ces points de terminaison pour soumettre des tâches Grok 5 Imagine et vérifier leur statut. Chaque appel consomme des crédits en fonction du modèle utilisé.

Authentification

Toutes les requêtes doivent inclure votre clé API dans l'en-tête Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Les clés manquantes ou invalides retournent 401 Unauthorized.

POST

https://grok5imagine.com/api/generate

Créer une tâche de génération

Soumet une nouvelle tâche Grok 5 Imagine. L'appel retourne immédiatement un task_id tandis que le rendu s'achève de manière asynchrone.

Paramètre	Type	Requis	Description
model	string	Non	Modèle à utiliser : grok-imagine/text-to-image (par défaut), text-to-video, image-to-video ou upscale.
input	object	Oui	Objet de paramètres d'entrée contenant prompt, image_urls ou task_id selon le modèle.
input.prompt	string (max 5000 chars)	Non	Prompt texte décrivant ce qu'il faut générer (requis pour text-to-image et text-to-video).
input.image_urls	string[]	Non	Tableau d'URLs d'images (requis pour image-to-video).
input.task_id	string	Non	ID de tâche précédent pour upscale ou génération image-to-video.
callback_url	string	Non	URL webhook pour recevoir les notifications de fin de tâche.
public	boolean	Non	Exposer la tâche aux galeries publiques.

Consommation de crédits

Les crédits sont déduits lors de la création de la tâche. Les tâches échouées sont automatiquement remboursées.

Modèle	Crédits déduits
grok-imagine/text-to-image	5
grok-imagine/text-to-video	24
grok-imagine/image-to-video	24
grok-imagine/upscale	12

Exemple de requête

{
  "model": "grok-imagine/text-to-image",
  "input": {
    "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
  }
}

Exemple de réponse

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

GET / POST

https://grok5imagine.com/api/status

Vérifier le statut de la tâche

Utilisez ce point de terminaison pour interroger l'enregistrement le plus récent. Lorsque la tâche est toujours en statut IN_PROGRESS, nous interrogeons le fournisseur une fois de plus avant de répondre.

Paramètre	Type	Requis	Description
task_id	string	Oui	ID retourné par /generate. Envoyez-le via paramètre de requête (?task_id=) ou corps JSON.

Champ	Description
task_id	ID retourné par /generate.
status	SUCCESS (SUCCÈS)
request	Copie nettoyée de la charge utile soumise.
response	Objet contenant le tableau resultUrls lorsque le statut est SUCCESS.
consumed_credits	Crédits facturés pour la tâche (0 en cas de remboursement).
error_message	Erreur du fournisseur lorsque le statut est FAILED.
created_at	Horodatage UTC auquel la tâche a été enregistrée.

Exemple de requête

GET https://grok5imagine.com/api/status?task_id=n31b6d54c8f4b4c4e8kie
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://grok5imagine.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "n31b6d54c8f4b4c4e8kie"
}

Exemple de réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "SUCCESS",
    "request": {
      "model": "grok-imagine/text-to-image",
      "input": {
        "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
      }
    },
    "response": {
      "resultUrls": [
        "https://static.gogloai.com/grok-imagine/image_001.png"
      ]
    },
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Gestion des erreurs

401 Unauthorized - Clé API manquante ou invalide.
402 Payment Required - Le solde de crédits n'a pas pu couvrir la déduction.
429 Too Many Requests - Réduisez la cadence de vérification ou le taux de requêtes.
500 - Problème transitoire ; réessayez avec un backoff exponentiel.