API Grok Imagine Video 1.5

Référence API complète pour les modèles de génération Grok Imagine Video 1.5 par xAI.

Variantes du modèle

Cette API prend en charge une variante de modèle:

Formats d'image pris en charge

Options de résolution

Grok Imagine 1.5 Image to Video

Endpoint

POST /api/v1/video/task

Paramètres de requête

Obligatoires

Facultatifs

Exemple de requête

javascriptCopier
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'grok-imagine-v1.5-image-to-video',
    image_url: 'https://example.com/reference.jpg',
    prompt: 'Subtle camera motion, subject holds pose',
    aspect_ratio: '16:9',
    duration: 10,
    resolution: '720p'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Exemple body uniquement:

javascriptCopier
{
  model_name: 'grok-imagine-v1.5-image-to-video',
  image_url: 'https://example.com/reference.jpg',
  prompt: 'Subtle camera motion, subject holds pose',
  aspect_ratio: '16:9',
  duration: 10,
  resolution: '720p'
}

Format de réponse

Réponse initiale

Renvoie un task_id pour l'interrogation:

jsonCopier
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Réponse d'interrogation

Interrogez GET /api/v1/video/{taskId} pour vérifier le statut:

jsonCopier
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valeurs de statut

• submitted: Tâche acceptée et en attente de traitement
• processing: Génération vidéo en cours
• succeed: Génération vidéo terminée
• failed: Échec de la génération vidéo

Temps de traitement

Temps de traitement typique: 2-5 minutes.

Bonnes pratiques

1. Description du mouvement: Incluez le mouvement de caméra et le mouvement du sujet dans les prompts
2. Qualité d'image: Utilisez des images d'entrée de haute qualité pour de meilleurs résultats d'animation
3. Format d'image: Faites correspondre aspect_ratio à votre format de sortie cible avant l'envoi