Skip to main content

Intégrer le modèle de génération vidéo

Appeler un modèle de génération vidéo Token Plan depuis un outil Agent, soumettre une tâche asynchrone et télécharger la vidéo une fois la génération terminée.

Modèles pris en charge

ModèleEntréeDescription
happyhorse-1.1-t2vTexteTexte vers vidéo
happyhorse-1.1-i2vImage de première trame, texteImage vers vidéo
happyhorse-1.1-r2vImages de référence, texteRéférence vers vidéo
wan3.0-videoTexte, images ou supports de référenceGénération vidéo tout-en-un
Pour plus de modèles, consultez modèles pris en charge par Token Plan.

Prérequis

  • Un abonnement Token Plan et une clé API commençant par sk-sp-. Pour plus de détails, voir Vue d'ensemble de l'intégration.
  • Python 3.9 ou version ultérieure.
  • Votre outil de codage IA prend en charge les Slash Commands. Pour les chemins de configuration des autres outils, voir Autres outils.

Interface

Soumettre une tâche : POST https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis Interroger une tâche : GET https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} Utilisez Authorization: Bearer $ANTHROPIC_AUTH_TOKEN dans l’en-tête de requête. Ajoutez X-DashScope-Async: enable lors de la soumission d’une tâche.

Étape 1 : Créer une Slash Command

Configurez la clé API Token Plan en tant que variable d'environnement $ANTHROPIC_AUTH_TOKEN. Créez .claude/commands/text-to-video.md à la racine du projet et ajoutez le contenu suivant :
Appelez l'API de génération vidéo Token Plan, soumettez une tâche de texte en vidéo, attendez la fin de l'exécution, puis téléchargez la vidéo.

Description de la vidéo : $ARGUMENTS

## Étapes

1. Extrayez de la description le prompt (description de la vidéo), le modèle (par défaut : happyhorse-1.1-t2v), la résolution (par défaut : 720P), le ratio (par défaut : 16:9) et la durée (par défaut : 5). Si la description spécifie un modèle, utilisez ce modèle.
2. Installez les dépendances : pip install requests
3. Utilisez l'outil Bash pour exécuter le script Python suivant. Le script lit d'abord TOKEN_PLAN_API_KEY, puis ANTHROPIC_AUTH_TOKEN. N'affichez pas la clé et ne l'écrivez pas dans des fichiers ou des journaux.

```python
import json
import os
import sys
import time
from pathlib import Path

import requests

prompt = " ".join(sys.argv[1:])
key = os.environ.get("TOKEN_PLAN_API_KEY") or os.environ.get("ANTHROPIC_AUTH_TOKEN")
if not key:
    raise SystemExit("Token Plan API Key not found.")

base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com"
headers = {"Authorization": f"Bearer {key}", "Content-Type": "application/json"}

response = requests.post(
    f"{base_url}/api/v1/services/aigc/video-generation/video-synthesis",
    headers={**headers, "X-DashScope-Async": "enable"},
    json={
        "model": "happyhorse-1.1-t2v",
        "input": {"prompt": prompt},
        "parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5},
    },
    timeout=60,
)
if not response.ok:
    raise SystemExit(f"{response.status_code}: {response.text}")
task_id = response.json()["output"]["task_id"]
print(f"Task submitted: {task_id}")

while True:
    time.sleep(10)
    result = requests.get(f"{base_url}/api/v1/tasks/{task_id}", headers=headers, timeout=60)
    if not result.ok:
        raise SystemExit(f"{result.status_code}: {result.text}")
    data = result.json()
    status = data["output"]["task_status"]
    if status == "SUCCEEDED":
        video_url = data["output"]["video_url"]
        output = f"generated_{time.strftime('%Y%m%d_%H%M%S')}.mp4"
        video = requests.get(video_url, timeout=120)
        video.raise_for_status()
        Path(output).write_bytes(video.content)
        print(output)
        break
    if status in {"FAILED", "CANCELED", "UNKNOWN"}:
        raise SystemExit(json.dumps(data, ensure_ascii=False, indent=2))
    print(f"Task status: {status}")
```

4. Affichez le chemin du fichier vidéo téléchargé.

Étape 2 : générer une vidéo

Dans Claude Code, saisissez /text-to-video a white cat sitting on a balcony in the sun. Pour ajuster la durée, la résolution ou le format d’image, spécifiez-le dans la commande, par exemple /text-to-video generate a 10-second, 1080P, 9:16 city night scene.

Paramètres de requête

ParamètreObligatoireDescription
modelOuiID du modèle de génération de vidéo.
input.promptOuiDescription de la vidéo.
parameters.resolutionNonRésolution. Prise en charge : 480P, 720P et 1080P. Valeur par défaut : 1080P.
parameters.ratioNonRapport d’aspect. Prise en charge : 16:9, 9:16, 1:1 et d’autres valeurs. Valeur par défaut : 16:9.
parameters.durationNonDurée en secondes, de 3 à 15. Valeur par défaut : 5.
Pour plus de paramètres, consultez API HappyHorse de texte vers vidéo.

Réponse

  • La soumission d'une tâche renvoie output.task_id et output.task_status.
  • Interrogez GET /api/v1/tasks/{task_id}. Lorsque le statut est SUCCEEDED, la réponse contient output.video_url.
  • Les statuts de tâche incluent PENDING, RUNNING, SUCCEEDED, FAILED, CANCELED et UNKNOWN.
  • Les URL des vidéos expirent. Téléchargez la vidéo rapidement.

Limites

  • La génération de vidéos est asynchrone. Soumettez la tâche puis interrogez régulièrement le résultat. Un task_id est valide pendant 24 heures.
  • Les types d’entrée, résolutions, durées et rapports d’aspect pris en charge varient selon le modèle. Consultez la documentation de chaque modèle.
  • La génération de vidéos consomme plus que la génération d’images et la synthèse vocale. La consommation réelle de Credits est affichée dans Usage dans la console.

Autres outils

Pour les mécanismes d’extension et les chemins de configuration des autres outils, consultez Vue d’ensemble de l’intégration. Enregistrez la Slash Command ci-dessus dans le chemin correspondant.