Créer une vidéo

Créez une tâche vidéo Grok via l’interface Video Generations de la plateforme.

La génération à partir de texte, la génération à partir d’une image et le Video-to-Video Remix sont pris en charge.

POST/v1/video/generations

Créez une tâche de génération de vidéo Grok. La génération à partir de texte ou d’images et le Video-to-Video Remix sont pris en charge.

Un exemple d’identifiant de modèle est grok-imagine-video. Les exemples utilisent MODEL_ID ; les modèles réellement disponibles dépendent de la liste renvoyée pour la clé API actuelle.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez Bearer your-api-key dans le Header Authorization.

Emplacement: header

Corps de requête

application/json

Requête de création de vidéo Grok.

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

Identifiant du modèle vidéo Grok, par exemple grok-imagine-video. Les modèles réellement disponibles dépendent de la liste renvoyée pour la clé API actuelle.

Longueur1 <= length

prompt*string

Décrivez le contenu vidéo à générer ou à modifier.

Longueur1 <= length

duration?integer

Durée de la vidéo, en secondes ; s’applique uniquement à la génération à partir de texte ou d’images. Les valeurs vont de 1 à 15, avec 5 par défaut. Le mode Remix ne prend pas en charge ce champ ; la durée de sortie correspond à celle de la vidéo d’entrée, dans la limite de 8.7 secondes.

Plage1 <= value <= 15

Valeur par défaut5

images?array<string>

Liste d’images d’entrée pour la génération de vidéo à partir d’images. Utilisez soit ce champ, soit image.

image?string

Image unique pour la génération de vidéo à partir d’une image ; peut être une URL publique ou une Data URI Base64. Utilisez soit ce champ, soit images.

metadata?

Paramètres supplémentaires transmis au service en amont. Cet objet permet de transmettre directement d’autres paramètres avancés pris en charge par Grok, tels que seed, negative_prompt et fps.

La plateforme calcule dynamiquement la consommation de quota à partir des paramètres de requête. Conservez également metadata dans votre application pour faciliter le rapprochement et la reproduction des résultats.

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Une ville cyberpunk dans les nuages",    "duration": 5,    "image": "https://example.com/init-frame.png",    "metadata": {      "resolution": "720p"    }  }'

{
  "id": "xai-task-12345"
}

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`