Ressources pour les développeurs

Documentation de l'API Grok 5 Imagine

Intégrez le modèle Grok 5 Imagine de xAI dans vos applications. Prise en charge de la génération texte-vers-image, texte-vers-vidéo et image-vers-vidéo via une API REST simple.

Authentification

L'API Grok 5 Imagine utilise l'authentification par Bearer Token. Passez votre clé API dans l'en-tête de la requête.

Authentification

Authorization: Bearer sk-your-api-key-here

Gardez votre clé API en sécurité. Ne la partagez pas dans le code côté client.

Tarification

Type	Coût	Description
Texte vers image `(text2img)`	5 Crédits	Générez des images à partir de descriptions textuelles avec Grok 5 AI.
Texte vers vidéo `(text2video)`	24 Crédits	Générez des vidéos à partir de descriptions textuelles avec Grok 5 AI.
Image vers vidéo `(img2video)`	24 Crédits	Générez des vidéos à partir d'images avec Grok 5 AI.

Créer une tâche

POSThttps://grok5ai.com/api/generate

Génération asynchrone

Tarification

Les crédits varient selon le modèle : text2img coûte 5 crédits, text2video et img2video coûtent 24 crédits chacun.

Lancez une tâche de génération. L'API renvoie immédiatement un task_id, que vous utilisez pour consulter le résultat.

Paramètres du corps

Paramètre	Type	Requis	Description
model	string	Requis	Modèle à utiliser : text2img, text2video ou img2video.
prompt	string	Conditionnel	La description textuelle pour la génération. Max 5000 caractères. Requis pour text2img et text2video.
image_urls	array	Conditionnel	Tableau d'URLs d'images pour le mode img2video. Requis si task_id n'est pas fourni.
task_id	string	Conditionnel	ID de tâche d'une génération précédente à utiliser comme image d'entrée. Requis si image_urls n'est pas fourni.
callback_url	string	Optionnel	URL Webhook pour la notification de fin de tâche.

Exemples de requêtes

Exemple texte vers image (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2img",
    "prompt": "A serene mountain landscape at sunset"
  }'

Exemple texte vers vidéo (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2video",
    "prompt": "A timelapse of clouds moving over mountains"
  }'

Exemple image vers vidéo (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "img2video",
    "image_urls": ["https://example.com/image.jpg"]
  }'

Réponse de succès

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS"
  }
}

Réponse d'erreur

{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}

Vérifier le statut

GEThttps://grok5ai.com/api/status

Interrogez ce point de terminaison pour vérifier la progression de votre tâche. Nous recommandons une interrogation toutes les 5-10 secondes.

Paramètres de requête

Paramètre	Type	Description
task_id	string	L'ID de tâche reçu du point de terminaison de génération. Requis

Valeurs de statut

PENDINGTâche en file d'attente

IN_PROGRESSTraitement en cours

SUCCESSTerminé

FAILEDUne erreur est survenue

cURL

curl -X GET "https://grok5ai.com/api/status?task_id=grok5abc123def456img" \
  -H "Authorization: Bearer YOUR_API_KEY"

Réponse (En cours)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS",
    "consumed_credits": 10,
    "created_at": "2024-12-19T10:00:00Z"
  }
}

Réponse (Terminée)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "SUCCESS",
    "response": [
      "https://cdn.example.com/image.png"
    ]
  }
}

Réponse (Échec)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Codes d'erreur

Code	Description
200	Succès
400	Mauvaise requête - Paramètres invalides (prompt manquant, modèle invalide, etc.)
401	Non autorisé - Clé API manquante ou invalide
404	Non trouvé - L'ID de tâche n'existe pas
500	Erreur interne du serveur - Veuillez réessayer ou contacter le support

Besoin d'aide ?

Consultez notre canal de support ou contactez-nous par e-mail.

Contacter le support