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
| Modelo | Entrada | Descrição |
|---|---|---|
happyhorse-1.1-t2v | Texto | Texto para vídeo |
happyhorse-1.1-i2v | Imagem do primeiro quadro, texto | Imagem para vídeo |
happyhorse-1.1-r2v | Imagens de referência, texto | Referência para vídeo |
wan3.0-video | Texto, imagens ou materiais de referência | Geração de vídeo tudo-em-um |
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:
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âmetro | Obrigatório | Descrição |
|---|---|---|
model | Sim | ID do modelo de geração de vídeo. |
input.prompt | Sim | Descrição do vídeo. |
parameters.resolution | Não | Resolução. Suporta 480P, 720P e 1080P. Padrão: 1080P. |
parameters.ratio | Não | Proporção. Suporta 16:9, 9:16, 1:1 e outras. Padrão: 16:9. |
parameters.duration | Não | Duração em segundos, de 3 a 15. Padrão: 5. |
Resposta
- O envio de uma tarefa retorna
output.task_ideoutput.task_status. - Consulte
GET /api/v1/tasks/{task_id}. Quando o status forSUCCEEDED, a resposta contémoutput.video_url. - Os status da tarefa incluem
PENDING,RUNNING,SUCCEEDED,FAILED,CANCELEDeUNKNOWN. - 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.