Tâches de génération de vidéos

Aperçu de l’API

La génération de vidéos est une opération asynchrone :

1. Appel POST /v1/videos/tasks soumettre la tâche
2. Enregistrer l’identifiant de tâche public de la réponse
3. Appel GET /v1/tasks/{task_id} interroger l’état et les résultats

Le Base URL est https://api.rokoapi.com/v1. Toutes les requêtes doivent inclure Authorization: Bearer $API_KEY.

Modèles pris en charge

La disponibilité réelle dépend de /v1/models, de la configuration des canaux de la console et du groupe auquel appartient la clé. Les utilisateurs ne sélectionnent que le modèle produit ; RokoAPI choisit automatiquement le routage texte-vers-vidéo, image-vers-vidéo, référence-vers-vidéo ou édition d’EvoLink en fonction de generation_type et des champs de ressources pour sélectionner automatiquement les routes EvoLink de génération texte-vers-vidéo, image-vers-vidéo, vidéo de référence ou d’édition.

Génération de vidéos à partir de texte

curl https://api.rokoapi.com/v1/videos/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "generation_type": "text",
    "prompt": "A cinematic sunrise over snow mountains",
    "duration": 8,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

Génération de vidéos à partir d’images et de références

Généralement, les ressources téléchargeables publiquement sont transmises via image_urls, video_urls et audio_urls :

{
  "model": "seedance-2.0",
  "generation_type": "reference",
  "prompt": "Keep the character identity and create a slow camera orbit",
  "image_urls": ["https://example.com/character.png"],
  "video_urls": ["https://example.com/motion.mp4"],
  "duration": 6,
  "quality": "720p",
  "aspect_ratio": "16:9"
}

Exception : la génération de vidéos à partir d’images de Wan 2.7 utilise image_start et l’option image_end ; Grok 1.5 sélectionne automatiquement le mode en fonction du nombre de image_urls (0 pour texte-vers-vidéo, 1 pour image-vers-vidéo, 2 à 7 pour référence-vers-vidéo) et n’accepte pas aspect_ratio.

Édition de vidéos

{
  "model": "wan-2.7",
  "generation_type": "edit",
  "prompt": "Change the background to a rainy neon street",
  "video_urls": ["https://example.com/input.mp4"],
  "image_urls": ["https://example.com/style.png"],
  "duration": 0,
  "quality": "720p"
}

Dans l’édition de Wan 2.7, duration: 0 indique de suivre la vidéo d’entrée. L’édition de Gemini Omni suit la vidéo d’entrée ; ne transmettez pas duration ou aspect_ratio.

Limites des paramètres

Les paramètres de modèle supplémentaires de la requête sont transmis tels quels à EvoLink dans leur structure JSON d’origine, y compris negative_prompt, generate_audio, content_filter, sound, prompt_extend et model_params. RokoAPI valide d’abord les limites connues telles que la durée, la qualité, le format, le nombre de ressources et l’URL de rappel. L’interface vidéo ne prend pas en charge n.

Rappels et requêtes

Le paramètre callback_url doit être une adresse HTTPS publique, d’une longueur maximale de 2048 caractères, et ne peut pas pointer vers localhost ou une IP interne. Même si un rappel est configuré, il est recommandé de conserver le polling comme mécanisme de secours :

curl https://api.rokoapi.com/v1/tasks/task_public_id \
  -H "Authorization: Bearer $API_KEY"

Les états courants incluent queued, in_progress, completed et failed. Les liens de résultat peuvent avoir une durée de validité limitée ; en production, téléchargez-les et sauvegardez-les rapidement.

Tarification

Les modèles utilisent une tarification unifiée en dollars v2, permettant de combiner dans une seule formule la durée de sortie, la durée de la vidéo de référence en entrée, le nombre d’images en entrée, l’activation de l’audio, la résolution, la qualité, le mode de génération et la consommation de jetons. Un prépaiement est effectué à la soumission selon les paramètres validés ; le règlement final est basé sur les jetons réels ou la durée de sortie une fois la tâche terminée.

Voici un instantané des prix fixes au 20 août 2026, incluant déjà les 10 % de frais de service sur le coût public d’EvoLink, exprimés en dollars. Les prix ne varient pas en temps réel avec les crédits amont ; les administrateurs mettent à jour ce tableau et les expressions en arrière-plan après avoir validé les ajustements de prix amont.

Série Seedance 2.0

Les prix promotionnels de Fast et Mini proviennent de l’ajustement de prix d’EvoLink du 7 août 2026. À la fin de la promotion, les prix de RokoAPI ne changent pas automatiquement ; l’instantané validé en arrière-plan s’appliquera alors.

Autres modèles vidéo par seconde

Kling O3 est facturé selon la résolution et l’activation du son :

Série Sora 2

Prix des jetons Gemini Omni

La durée de la vidéo de référence n’est prise en compte dans la facturation finale qu’après la validation des métadonnées multimédias par le système ou l’obtention d’une quantité de données fiable. Les prix complets sont indiqués sur la page de tarification et dans la configuration actuelle de l’interface d’administration. Pour les sources de prix en amont, consultez le catalogue de modèles EvoLink et les pages de développement de chaque modèle.