Documentation API

Référence GrokImagine API

Documentation complète pour intégrer GrokImagine AI dans vos applications. Générez des vidéos de haute qualité à partir de textes et d’images avec plusieurs modes créatifs.

API REST

Réponses JSON

Génération vidéo

Authentification

L’API GrokImagine utilise une authentification par Bearer Token. Ajoutez votre jeton dans l’en-tête Authorization :

Authorization: Bearer your-api-token-here

Note de sécurité: Ne publiez jamais votre jeton API dans du code côté client ou dans des dépôts publics.

URL de base

Toutes les requêtes doivent être envoyées à :

https://grokimagineapi.com

Points de terminaison API

POST

Générer une vidéo

/v1/generate

Générez des vidéos haute qualité à partir de textes ou d’images en utilisant des modèles IA.

Corps de la requête

{
  "mode": "fun",
  "prompt": "a beautiful landscape with mountains",
  "images": ["https://example.com/image.png"],
  "ratio": "1:1"
}

Paramètres

Paramètre	Type	Description
mode	string	Mode de génération (fun, normal, spicy)
prompt	string	Texte pour générer la vidéo
images	string?	Paramètre optionnel, tableau d'URLs d'images pour générer une vidéo à partir d'images. Exemple : ['https://example.com/image.png']
ratio	string	Ratio d’image : 2:3, 3:2, 1:1

💰 Pricing

Each generation consumes 40 credits, approximately 0.4 USD

Response

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_123456789"
  }
}

cURL Example

curl -X POST https://grokimagineapi.com/v1/generate \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "fun",
    "prompt": "a beautiful landscape with mountains",
    "ratio": "1:1"
  }'

GET

Get Task Status

/v1/status?task_id=xxxx

Check the status of an ongoing or completed video generation task.

Query Parameters

Use GET request with query parameter task_id=xxxx

Response

{
  "code": 200,
  "message": "success",
  "data": {
    "consumed_credits": 40,
    "created_at": "2024-01-01T00:00:00Z",
    "status": "completed",
    "task_id": "task_123456789",
    "request": {
      "mode": "fun",
      "prompt": "a beautiful landscape with mountains",
      "ratio": "1:1"
    },
    "response": [
      "https://cdn.example.com/generated/video1.mp4",
      "https://cdn.example.com/generated/video2.mp4"
    ]
  }
}

📋 Response Fields

consumed_credits: Number of credits consumed
created_at: Task creation timestamp
status: Task status
task_id: Task ID
request: Original request data
response: Video URL string array

cURL Example

curl -X GET "https://grokimagineapi.com/v1/status?task_id=task_123456789" \
  -H "Authorization: Bearer your-api-token"

Gestion des erreurs

L’API GrokImagine renvoie des codes HTTP standard et des messages d’erreur :

Codes HTTP

200OK

400Bad Request

401Unauthorized

429Rate Limited

500Server Error

Format des erreurs

{
  "code": 400,
  "message": "Invalid request: The prompt parameter is required",
  "error": "INVALID_REQUEST"
}

Bonne pratique: Gérez toujours les erreurs proprement et vérifiez les codes HTTP avant de traiter la réponse.

Limites

100

requêtes/minute

Forfait gratuit

1000

requests/minute

Forfait Pro

5000

requests/minute

Entreprise

Rate Limit Headers: Each response includes X-RateLimit-Remaining and X-RateLimit-Reset headers to track your current usage.

Prêt à commencer ?

Obtenez votre clé API et créez des vidéos incroyables avec Seedance

Commencer Retour à l’accueil