Skip to main content

Integrar o modelo de geração de vídeo

Chamar um modelo de geração de vídeo do Token Plan a partir de uma ferramenta de Agent, enviar uma tarefa assíncrona e baixar o vídeo quando a geração for concluída.

Modelos compatíveis

ModeloEntradaDescrição
happyhorse-1.1-t2vTextoTexto para vídeo
happyhorse-1.1-i2vImagem do primeiro quadro, textoImagem para vídeo
happyhorse-1.1-r2vImagens de referência, textoReferência para vídeo
wan3.0-videoTexto, imagens ou materiais de referênciaGeração de vídeo tudo-em-um
Para mais modelos, consulte modelos compatíveis com o Token Plan.

Pré-requisitos

  • Uma assinatura do Token Plan e uma chave de API que comece com sk-sp-. Para obter detalhes, consulte Visão geral da integração.
  • Python 3.9 ou superior.
  • Sua ferramenta de codificação de IA é compatível com Slash Commands. Para ver os caminhos de configuração de outras ferramentas, consulte Outras ferramentas.

Interface

Envie uma tarefa: POST https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis Consulte uma tarefa: GET https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} Use Authorization: Bearer $ANTHROPIC_AUTH_TOKEN no cabeçalho da requisição. Adicione X-DashScope-Async: enable ao enviar uma tarefa.

Etapa 1: Criar um Slash Command

Configure a chave da API do Token Plan como a variável de ambiente $ANTHROPIC_AUTH_TOKEN. Crie .claude/commands/text-to-video.md na raiz do projeto e adicione o seguinte conteúdo:
Chame a API de geração de vídeo do Token Plan, envie uma tarefa de texto para vídeo, aguarde a conclusão e baixe o vídeo.

Descrição do vídeo: $ARGUMENTS

## Etapas

1. Extraia da descrição o prompt (descrição do vídeo), o modelo (padrão: happyhorse-1.1-t2v), a resolução (padrão: 720P), a proporção (padrão: 16:9) e a duração (padrão: 5). Se a descrição especificar um modelo, use esse modelo.
2. Instale as dependências: pip install requests
3. Use a ferramenta Bash para executar o script Python a seguir. O script lê primeiro TOKEN_PLAN_API_KEY e depois ANTHROPIC_AUTH_TOKEN. Não exiba a chave nem a grave em arquivos ou logs.

```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. Exiba o caminho do arquivo de vídeo baixado.

Etapa 2: Gerar um vídeo

No Claude Code, insira /text-to-video a white cat sitting on a balcony in the sun. Para ajustar a duração, a resolução ou a proporção, especifique no comando, por exemplo /text-to-video generate a 10-second, 1080P, 9:16 city night scene.

Parâmetros da requisição

ParâmetroObrigatórioDescrição
modelSimID do modelo de geração de vídeo.
input.promptSimDescrição do vídeo.
parameters.resolutionNãoResolução. Suporta 480P, 720P e 1080P. Padrão: 1080P.
parameters.ratioNãoProporção. Suporta 16:9, 9:16, 1:1 e outras. Padrão: 16:9.
parameters.durationNãoDuração em segundos, de 3 a 15. Padrão: 5.
Para mais parâmetros, consulte API de texto para vídeo HappyHorse.

Resposta

  • O envio de uma tarefa retorna output.task_id e output.task_status.
  • Consulte GET /api/v1/tasks/{task_id}. Quando o status for SUCCEEDED, a resposta contém output.video_url.
  • Os status da tarefa incluem PENDING, RUNNING, SUCCEEDED, FAILED, CANCELED e UNKNOWN.
  • As URLs de vídeo expiram. Baixe o vídeo prontamente.

Limites

  • A geração de vídeo é assíncrona. Envie a tarefa e consulte periodicamente o resultado. Um task_id é válido por 24 horas.
  • Os tipos de entrada, resoluções, durações e proporções de aspecto suportados variam conforme o modelo. Consulte a documentação de cada modelo.
  • A geração de vídeo consome mais do que a geração de imagens e a síntese de fala. O consumo real de Credits é exibido em Usage no console.

Outras ferramentas

Para mecanismos de extensão e caminhos de configuração de outras ferramentas, consulte Visão geral da integração. Salve o Slash Command acima no caminho correspondente.