Geração por tarefa
Use request ids e estados de tarefa para gerenciar saídas demoradas na interface do seu app.
Conecte modelos de geração de vídeo como Seedance, Kling, Wan, Grok Video e HappyHorse pelo Pixapi com chaves de API, rastreamento de créditos, estados de tarefa e documentação para equipes de produto.
Requisição de geração de vídeo
Envie tarefas assíncronas e consulte GET /v1/tasks/{id} pelo backend.
curl https://api.pixapi.ai/v1/async/videos/generations \
-H "Authorization: Bearer $PIXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "veo3.1-fast",
"prompt": "A cinematic reveal of a smart speaker",
"seconds": 8,
"resolution": "720p"
}'A geração de vídeo deve ser enviada com POST /v1/async/videos/generations; novas integrações não devem usar /v1/videos/generations.
Requisições usam Bearer auth, um modelo de vídeo como veo3.1-fast, seedance-2, kling-3.0-turbo, wan2.6, grok-video-3 ou happyhorse-1.1, além de prompt, seconds, resolution e image opcional para imagem para vídeo.
O Pixapi retorna um task id imediatamente; seu backend consulta GET /v1/tasks/{id} até completed ou failed e lê a URL final em result.data[0].url.
Modelos de vídeo são mais lentos e caros que imagem; a camada de API precisa de tarefas, créditos e erros claros.
Use request ids e estados de tarefa para gerenciar saídas demoradas na interface do seu app.
Crie fluxos de texto para vídeo e imagem para vídeo mantendo autenticação e cobrança consistentes.
Compare capacidades, custos e casos de uso antes de escolher uma rota.
Estime e monitore gasto de vídeo por usuários, planos e recursos internos.
Trate rate limits, falhas transitórias e status para usuários com padrões consistentes.
Use a mesma conta Pixapi para imagens, edição e vídeo em vez de unir fornecedores separados.
| Necessidade | Rota recomendada no Pixapi | Por que funciona |
|---|---|---|
| Clipes de produto por prompt | Seedance, Kling, Wan, Grok Video ou HappyHorse | Escolha por realismo, estilo e custo em créditos. |
| Animação imagem para vídeo | Rota de vídeo com imagem de referência | Transforme imagens geradas ou enviadas em clipes curtos. |
| Fluxos assíncronos de usuário | Task id com acompanhamento de status | Mantém a UI responsiva durante a geração. |
| Lançamentos com custo controlado | Planos de créditos e página de preços | Projete demanda antes de liberar vídeo para todos. |
Consulte endpoints, autenticação, campos de solicitação e respostas.
Crie e proteja uma chave bearer antes das chamadas de produção.
Compare modelos de imagem e vídeo por capacidade e custo.
Consulte pacotes de créditos, regras de cobrança e preços atuais.
Geração de vídeo normalmente roda como tarefa porque demora mais e custa mais. O app deve salvar task id e mostrar progresso.
O Pixapi lista rotas selecionadas como Seedance, Kling, Wan, Grok Video e HappyHorse no catálogo de modelos. A disponibilidade pode mudar conforme provedores atualizam modelos.
Rotas suportadas podem usar uma imagem de referência em fluxos imagem para vídeo. Confira os parâmetros de cada modelo.
Sim. Um fluxo comum é gerar uma imagem e usá-la como referência para um vídeo curto.
Use o Pixapi para testar rotas de vídeo, monitorar créditos e levar o protótipo à produção com uma chave de API.
Criar chave de API