Modelos de vídeoUsuários avançadosAtualizado em
POST/v1/videos/generations

Console da API

POST/v1/videos/generations
Ver chaves

As requisições usam a chave informada e seguem a cobrança padrão da API.

Kling V3 Omni

ID da solicitação kling-v3-omni

Protocolos

Autenticação

Obtenha uma chave em Gerenciar chaves de API. Para requisições JSON, defina Content-Type: application/json.

  • Authorization: Bearer YOUR_API_KEY

Parâmetros da requisição

POST /v1/videos/generations

CampoTipoObrigatórioDescrição
modelstringObrigatóriokling-v3-omni. Use o ID do modelo indicado nesta página.
promptstringCondicionalDescreva a cena, a ação e o movimento de câmera. Quando precisar de um prompt, use este campo ou um item de content do tipo text.
contentarray<object>CondicionalLista de mídias de referência e texto opcional. Omita ao gerar apenas com prompt. Até 2 imagens.
content[].typestringObrigatórioValores aceitos: text, image_url, input_image.
content[].textstringCondicionalInforme o prompt quando o item tiver type: "text".
content[].rolestringCondicionalUse first_frame e last_frame. O último quadro exige o primeiro. Você pode usar até duas imagens de referência comuns sem role. Não misture quadros e referências comuns.
content[].asset_idstringCondicionalEnvie a mídia para POST /v1/videos/assets e use o id retornado. No formulário multipart, envie kind (image) antes de file. A mídia deve pertencer à sua conta. Use o ID ou a URL HTTPS pública correspondente.
content[].image_urlstringCondicionalURL HTTPS pública da imagem como texto simples.
resolutionstringOpcionalValores aceitos: 720p, 1080p, 4K. Padrão: 720p.
ratiostringOpcionalProporção de saída. Também aceita o alias aspect_ratio. Valores aceitos: 16:9, 9:16, 1:1. Padrão: 9:16.
durationintegerOpcionalDuração de saída em segundos. Aceita segundos inteiros de 3 a 15. Padrão: 5.
generate_audiobooleanOpcionalIndica se uma faixa de áudio deve ser gerada. Padrão: true.

Exemplos de requisição

Defina a chave de API na variável de ambiente local ICODEEASY_API_KEY e escolha um endpoint que aceite chamadas HTTP diretas. Caso o endpoint exija um cliente específico, siga o guia de configuração desse cliente.

Substitua as URLs e os IDs de mídia dos exemplos por ativos válidos.

Video Generations

bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "kling-v3-omni",
  "prompt": "Slow camera push toward a paper lantern swaying gently by a lake.",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5
}'

Consultar tarefa de vídeo

bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

Baixar vídeo

bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID/content' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -L \
  -o result.mp4

Excluir tarefa de vídeo encerrada

bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -i \
  -X DELETE

Respostas e tarefas

HTTP 202 · Tarefa aceita

json
{
  "id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "model": "kling-v3-omni",
  "created_at": "2026-07-30T08:00:00Z",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "queued",
  "updated_at": "2026-07-30T08:00:00Z",
  "task_id": "vid_1785398400000000000"
}

HTTP 200 · Consulta de tarefa concluída

json
{
  "id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "model": "kling-v3-omni",
  "created_at": "2026-07-30T08:00:00Z",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "succeeded",
  "updated_at": "2026-07-30T08:01:00Z",
  "url": "/v1/videos/tasks/vid_1785398400000000000/content"
}

Guarde id. Com a mesma chave de API, envie requisições GET a status_url até status indicar succeeded ou failed. Em caso de sucesso, baixe o vídeo por content_url e siga os redirecionamentos HTTP. Os dois caminhos são relativos à URL base da API.

CampoTipoDescrição
id / task_idstringID da tarefa. Na resposta de criação, task_id é igual a id.
statusstringEstado da tarefa: queued, running, succeeded ou failed.
progressintegerProgresso da geração. O campo é omitido quando o valor está indisponível.
error.codestringClassificação do erro para tarefas com falha.

Erros comuns

HTTPTipo de erroDescrição
400invalid_requestConfira o modelo, a combinação de parâmetros e a mídia de referência.
401unauthorizedConfira se a chave de API está ausente, inválida ou desativada.
402insufficient_balanceO saldo é insuficiente para enviar a tarefa.
404not_foundSe a consulta retornar 404, guarde o ID da tarefa e confira o URL de consulta e a chave da conta que criou a tarefa. Ela pode já ter sido concluída. Não reenvie com base apenas nessa resposta.
409video_not_readyO vídeo ainda está em geração. Continue consultando o status.
503submission_unknownO resultado do envio é desconhecido. Confirme com o suporte se a tarefa foi criada antes de enviar outra requisição.

Guia completo de integração · Consulte o guia completo da API para ver os campos, estados de tarefas e formatos de resposta.

Recursos e limites

  • text_to_video · Compatível
  • image_to_video · Compatível
  • first_frame · Compatível
  • last_frame · Compatível
  • audio · Compatível
  • reference_images · Compatível
  • Limites Resoluções: 720p, 1080p, 4K · Proporções: 16:9, 9:16, 1:1 · Durações: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 · Imagens de referência: até 2 · Entrada: Use first and last frames or up to two role-free reference images.

Catálogo de recursos dos modelos · Ver preços

Guias relacionados

API de geração de vídeo

Crie tarefas de vídeo com texto, quadros inicial e final ou referências; acompanhe o status, baixe o resultado e exclua tarefas concluídas.

Catálogo de recursos dos modelos

Compare modelos públicos de texto, imagem e vídeo por ID normalizado, protocolos, clientes, ferramentas, recursos de mídia, limites e data de revisão.

Criar conta e obter uma API Key