Referência da APIUsuá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.

API de geração de vídeo

A API de geração de vídeo cria trabalhos de vídeo assíncronos. Uma solicitação de criação retorna HTTP 202 com um ID de trabalho; use esse ID para consultar o trabalho até ele chegar a succeeded ou failed e, em seguida, baixe o MP4 concluído.

Os exemplos usam https://api.icodeeasy.cc como URL base. Todas as chamadas de endpoint documentadas abaixo exigem sua chave de API; a única exceção é uma URL assinada do arquivo de resultado retornada após o sucesso:

http
Authorization: Bearer <your API key>

Endpoints

FinalidadeMétodo e rota
Criar um trabalho de vídeoPOST /v1/videos/generations
Consultar um trabalhoGET /v1/videos/tasks/{id}
Baixar o conteúdo concluídoGET /v1/videos/tasks/{id}/content
Excluir um trabalho concluído ou com falhaDELETE /v1/videos/tasks/{id}
Enviar mídia de referênciaPOST /v1/videos/assets
Excluir mídia de referênciaDELETE /v1/videos/assets/{id}

Os campos status_url e content_url nas respostas de criação e consulta são os caminhos oficiais relativos à URL base; use-os diretamente. As rotas de compatibilidade somente para leitura GET /v1/videos/generations/{id} e GET /v1/videos/generations/{id}/content também consultam o mesmo trabalho. Esses caminhos não aceitam criação nem exclusão.

Início rápido em cinco minutos

1. Crie um trabalho

bash
curl -X POST https://api.icodeeasy.cc/v1/videos/generations \
  -H 'Authorization: Bearer <your API key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao-seedance-2.5",
    "prompt": "uma rua de cidade futurista sob a chuva, câmera avançando lentamente, reflexos de neon no asfalto molhado",
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 4,
    "generate_audio": true
  }'

A criação retorna HTTP 202:

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

Use task_id como o identificador recomendado para consulta, download e exclusão; id permanece com o mesmo valor durante o período de compatibilidade. Uma resposta 202 significa que o trabalho foi aceito, não que o vídeo já está concluído.

2. Consulte o trabalho

Copie o task_id da resposta de criação para TASK_ID:

bash
TASK_ID='vid_1785398400000000000'
curl "https://api.icodeeasy.cc/v1/videos/tasks/${TASK_ID}" \
  -H 'Authorization: Bearer <your API key>'

Consulte aproximadamente uma vez a cada 5 segundos. Não crie outro trabalho enquanto o atual estiver em queued ou running.

json
{
  "id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "running",
  "model": "doubao-seedance-2.5",
  "created_at": "2026-07-30T08:00:00Z",
  "updated_at": "2026-07-30T08:00:20Z",
  "progress": 42
}

progress é uma estimativa e pode não estar presente. Considere status, e não o progresso, como a informação oficial.

3. Baixe o vídeo

Depois que status se tornar succeeded, a resposta incluirá url e o cost_rmb final:

json
{
  "id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "succeeded",
  "model": "doubao-seedance-2.5",
  "created_at": "2026-07-30T08:00:00Z",
  "updated_at": "2026-07-30T08:01:18Z",
  "progress": 100,
  "url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "cost_rmb": 0.528
}

Use content_url para baixar o vídeo.

bash
TASK_ID='vid_1785398400000000000'
curl -L "https://api.icodeeasy.cc/v1/videos/tasks/${TASK_ID}/content" \
  -H 'Authorization: Bearer <your API key>' \
  -o result.mp4

Veja Comportamento da resposta e do download para os códigos de status e redirecionamentos.


Ciclo de vida do trabalho e novas tentativas seguras

StatusSignificadoAção do cliente
queuedAceito e aguardando o inícioContinue consultando o mesmo trabalho
runningO vídeo está sendo geradoContinue consultando o mesmo trabalho
succeededSucesso terminal; o conteúdo está prontoBaixe e armazene o resultado
failedFalha terminalLeia error.code; crie um novo trabalho somente se decidir tentar novamente

Regras para novas tentativas:

  • Depois de receber HTTP 202, continue consultando o task_id retornado. Repetir a solicitação de criação pode criar outro trabalho.
  • Solicitações GET de consulta e download podem ser repetidas com segurança.
  • Um HTTP 404 durante a consulta não significa que a geração falhou e não deve causar um novo envio. Guarde o ID original, confira o status_url retornado ou use GET /v1/videos/tasks/{id} e uma API Key válida da conta proprietária do trabalho. O vídeo pode já ter sido concluído e cobrado; confira os detalhes de uso. Se ainda não conseguir consultar, informe ao suporte o ID e o horário do envio.
  • Se a criação retornar submission_unknown, não envie outra solicitação. O trabalho pode já ter sido aceito; entre em contato com o suporte informando o horário, o modelo e um resumo do prompt.
  • Depois de uma falha terminal confirmada em failed, crie um novo trabalho somente quando quiser gerar outro vídeo.

Webhooks e callback_url não são compatíveis. Em vez disso, consulte o endpoint do trabalho.


Referência da solicitação de criação

CampoTipoObrigatórioDescrição
modelstringSimID canônico do modelo. Não há modelo padrão; valores ausentes ou vazios retornam 400 invalid_request.
promptstringTexto obrigatório nos modelos padrãoColoque todas as instruções de texto aqui. Para Motion Control, é opcional quando os dois ativos de referência são fornecidos.
contentarrayAo usar referênciasLista de imagens e vídeos de referência. Os campos dependem de como o modelo recebe a mídia.
resolutionstringNãoNível de resolução da saída. O padrão e os valores permitidos dependem do modelo. Não é aceito por Motion Control.
ratiostringNãoProporção da saída. aspect_ratio é aceito como alias. Não é aceito por Motion Control.
durationintegerNãoSegundos solicitados. O padrão e os valores permitidos dependem do modelo. Não é aceito por Motion Control.
generate_audiobooleanNãoGera áudio quando houver suporte. Os valores padrão estão na tabela de modelos. Não é aceito por Motion Control.
motion_modestringSomente Motion Controlstd ou pro; o padrão é std.
character_orientationstringSomente Motion Controlimage ou video; o padrão é image. Controla o limite de duração do vídeo de referência.
keep_original_soundbooleanSomente Motion ControlMantém o som do vídeo de referência; o padrão é true.

Lista de mídias de referência (content)

  • Modelos que aceitam URLs. Por exemplo, Seedance 2.5 e Motion Control. Informe em image_url ou video_url uma URL HTTPS pública que permaneça acessível durante a leitura da mídia.
  • Modelos que exigem o envio do arquivo. Kling 4, Kling 4.0 Flash, FLUX3 Video, os modelos Vidu Q3/Q4 e Gemini Omni listados aqui usam mídia enviada pela mesma conta. Envie a mídia de referência e informe o id retornado no campo asset_id de cada item.

O exemplo abaixo usa URLs para o primeiro e o último quadro.

json
[
  { "type": "image_url", "image_url": "https://cdn.example.com/first.png", "role": "first_frame" },
  { "type": "image_url", "image_url": "https://cdn.example.com/last.png", "role": "last_frame" }
]
  • Tipos de imagem: image_url ou input_image.
  • Tipos de vídeo: video_url ou input_video.
  • Papéis de quadro: first_frame e last_frame. Na geração orientada por quadros, o último quadro exige o primeiro quadro.
  • Papel de vídeo de referência do Seedance 2.5: reference_video; imagens de referência comuns fornecidas junto usam reference_image.
  • Papéis de movimento: um reference_image e um reference_video.
  • As imagens de referência do Grok não têm papel; reference_image também é aceito.
  • No momento, áudio de referência não é compatível.

Envie mídia de referência para vídeo

Envie kind antes de file no multipart. Use image ou video, conforme o tipo do arquivo.

bash
curl -sS https://api.icodeeasy.cc/v1/videos/assets \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -F 'kind=video' \
  -F '[email protected];type=video/mp4'

O HTTP 201 retorna o objeto de mídia. Na criação, passe o id em content[].asset_id.

Exclua mídia de referência para vídeo

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

Exclua a mídia com a chave da conta proprietária. O sucesso retorna HTTP 204.


Comportamento da resposta e do download

Todas as respostas de trabalho usam este formato:

CampoSignificado
idID de trabalho restrito ao proprietário, usado para consulta, conteúdo, exclusão e suporte
objectSempre video.generation.job
statusqueued, running, succeeded ou failed
modelID canônico do modelo após a normalização de aliases
created_at, updated_atTimestamps UTC no formato RFC 3339
progressProgresso aproximado da geração, omitido quando não estiver disponível
status_url, content_urlCaminhos oficiais de consulta e download relativos à URL base; o conteúdo retorna 409 video_not_ready antes do sucesso
urlPresente somente após o sucesso; pode ser um caminho de conteúdo do relay ou um caminho assinado para um arquivo do relay
cost_rmbCobrança final do trabalho, presente após a liquidação bem-sucedida
error.codeCategoria estável da falha em um trabalho com falha

Use content_url para baixar. O endpoint autenticado aceita HTTP Range e cabeçalhos condicionais comuns e pode retornar 200, 206 Partial Content ou redirecionar para o armazenamento gerenciado pelo relay. Configure o cliente para seguir redirecionamentos. Antes da conclusão do trabalho, a rota retorna 409 video_not_ready.

Uma URL assinada de arquivo do relay pode ser aberta sem uma chave de API; quem possuir a URL completa terá acesso ao vídeo. Não a exponha em logs públicos, páginas ou ferramentas de análise no cliente.

Exclua uma tarefa concluída ou com falha

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

Excluir um trabalho terminal seguro retorna HTTP 204 e também pode remover seu arquivo de vídeo gerenciado pelo relay. Baixe e armazene qualquer resultado necessário antes de excluir o trabalho. A exclusão é rejeitada com 409 video_delete_unsafe enquanto um trabalho estiver em execução ou a cobrança não estiver liquidada. Excluir o registro local do trabalho não cancela uma geração que já começou.


Tratamento de erros

Os erros HTTP usam este formato:

json
{
  "error": {
    "type": "invalid_request",
    "message": "model is not supported"
  }
}
HTTPTipo de erroSignificado / ação
400invalid_requestModelo, campos, URL de mídia, papéis, duração, proporção ou combinação de modelo inválidos; corrija a solicitação
401unauthorizedA chave de API está ausente, é inválida ou está desativada
402insufficient_balanceO saldo não cobre o trabalho solicitado; a geração não é iniciada
404not_foundO trabalho não existe ou pertence a outra conta
409video_not_readyO conteúdo foi solicitado antes do sucesso terminal
409video_delete_unsafeAinda não é seguro excluir o trabalho
413request_too_largeO corpo JSON da solicitação de criação excede o limite
502upstream_errorFalha na geração do vídeo ou no download do resultado
503video_service_unavailable, upstream_quota_exceeded, video_price_unavailableA capacidade do serviço de vídeo ou o preço público atual está temporariamente indisponível
503submission_unknownA aceitação do trabalho é incerta; não envie uma duplicata

Uma resposta de trabalho com falha pode ter este formato:

json
{
  "id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "failed",
  "model": "doubao-seedance-2.5",
  "error": { "code": "generation_failed" }
}

Cobrança

A geração de vídeo usa o saldo da conta, e não a cota mensal.

text
preço de um trabalho de vídeo comum = preço exibido em RMB por segundo para o modelo/especificação selecionado × segundos faturáveis

Consulte os preços atuais por segundo na página de preços. A resolução, o áudio gerado ou o modo Motion Control podem selecionar uma linha diferente de preço por segundo. Para modelos padrão sem vídeos de referência, os segundos faturáveis correspondem à duration solicitada; para Motion Control, correspondem à duração detectada do vídeo de referência, arredondada para cima até um segundo inteiro. Vídeos de referência do Seedance 2.5 seguem as regras de reserva e liquidação do valor real abaixo, em vez de considerar apenas a duração da saída.

A criação reserva o valor estimado e o deduz do saldo disponível; por isso, o saldo diminui enquanto a geração ainda está em andamento. Saldo insuficiente retorna 402 antes do início da geração. No sucesso, o valor final e a diferença em relação à reserva são liquidados, e os detalhes de uso são registrados; cost_rmb é a cobrança final. Uma falha confirmada devolve toda a reserva. A diferença de saldo entre solicitações consecutivas pode incluir reservas ou devoluções de vídeos e não é necessariamente o custo daquela solicitação.

Cobrança de vídeos de referência do Seedance 2.5

O modo com vídeos de referência reserva uma estimativa usando “duração total dos vídeos de referência arredondada para cima até um segundo inteiro + segundos de saída” e a tarifa estimada para vídeos de referência na página de preços. Por exemplo, um vídeo de referência de 2 segundos com saída de 4 segundos reserva uma estimativa para 6 segundos; isso não garante o preço final.

A cobrança final segue o uso real: a diferença abaixo do valor reservado é devolvida, e a diferença acima dele é debitada adicionalmente. cost_rmb e os detalhes de uso mostram a cobrança final. Uma falha confirmada devolve toda a reserva. Se o progresso permanecer em 99%, o trabalho pode estar aguardando a liquidação da cobrança; continue consultando o trabalho original e não envie novamente.


Solicitação completa com primeiro e último quadro

Hospede as duas imagens em URLs HTTPS públicas e coloque essas URLs diretamente em content:

bash
curl -X POST https://api.icodeeasy.cc/v1/videos/generations \
  -H 'Authorization: Bearer <sua chave de API>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao-seedance-2.0",
    "prompt": "a câmera se move suavemente do primeiro para o último quadro",
    "content": [
      {"type":"image_url","image_url":"https://cdn.example.com/first.png","role":"first_frame"},
      {"type":"image_url","image_url":"https://cdn.example.com/last.png","role":"last_frame"}
    ],
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 4,
    "generate_audio": true
  }'

Na geração orientada por quadros, é permitido enviar apenas o primeiro quadro. O último quadro exige o primeiro quadro na mesma solicitação.


Receitas por modelo

Seedance: texto, primeiro quadro e último quadro

Seedance 2.5, Seedance 2.0 Standard, Fast, Mini e Seedance 1.5 Pro aceitam geração a partir de texto e dos quadros inicial/final. Ao usar somente imagens para orientar a geração, indique os papéis de quadro explicitamente. Seedance 2.5 também aceita o modo com vídeos de referência descrito abaixo.

json
{
  "model": "doubao-seedance-2.5",
  "prompt": "the camera circles a glass sculpture as morning light changes",
  "content": [
    { "type": "image_url", "image_url": "https://cdn.example.com/seedance-first.png", "role": "first_frame" },
    { "type": "image_url", "image_url": "https://cdn.example.com/seedance-last.png", "role": "last_frame" }
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": 6,
  "generate_audio": true
}

Os valores padrão do Seedance 2.5 para geração a partir de texto são 480p, 9:16, 4 segundos e áudio gerado ativado. O modo de quadro inicial ou inicial/final sem vídeos de referência segue a proporção da primeira imagem: defina ratio como adaptive ou omita o campo; o alias aspect_ratio segue a mesma regra. Uma proporção fixa explícita, como 16:9, retorna 400 invalid_request em vez de ser alterada silenciosamente. Um quadro inicial vertical produz um vídeo vertical. Para obter saída em 16:9, recorte ou expanda primeiro a imagem inicial para 16:9 e use adaptive. A geração a partir de texto e o modo com vídeos de referência continuam aceitando proporções fixas como 16:9.

Seedance 2.5: vídeos de referência

Envie o JSON abaixo para POST https://api.icodeeasy.cc/v1/videos/generations, com Authorization: Bearer <sua API Key> e Content-Type: application/json:

json
{
  "model": "doubao-seedance-2.5",
  "prompt": "Siga o movimento de @Video1 para gerar um vídeo fluido",
  "content": [
    { "type": "video_url", "video_url": "https://cdn.example.com/reference.mp4", "role": "reference_video" }
  ],
  "resolution": "480p",
  "ratio": "9:16",
  "duration": 4,
  "generate_audio": true
}

Substitua o URL de exemplo por um URL HTTPS de vídeo acessível publicamente. Passe uma string de URL diretamente em video_url; duration é a duração da saída. O serviço lê a duração do vídeo de referência, portanto não é necessário enviar um campo de duração da entrada. Adicione vários vídeos a content, cada um com reference_video; @Video1, @Video2 e assim por diante no prompt seguem a ordem dos vídeos na lista.

  • Entrada: até 10 vídeos MP4/MOV, de 2–30 segundos cada, no máximo 30 segundos no total e 100 MiB por arquivo.
  • Saída: 4–30 segundos em 480p ou 720p. É possível definir ratio e generate_audio; não use parâmetros exclusivos do Motion Control.
  • É possível fornecer também até 2 imagens com type: "image_url", uma string em image_url e role: "reference_image". Neste modo, as imagens são referências comuns, sem garantia de quadro inicial ou final; os papéis de quadro também são tratados como referências comuns.
  • Os vídeos devem usar H.264/H.265 a 24–60 fps, com largura e altura de 300–6000 pixels cada, 409.600–8.295.044 pixels no total (largura × altura) e proporção largura/altura de 0,4–2,5. 720×720 atende a esses limites de dimensão.

Após a criação ser aceita, consulte o mesmo trabalho pelo status_url retornado ou por GET /v1/videos/tasks/{id}. O download funciona como nos outros modelos. A cobrança de vídeos de referência inclui a entrada de referência e a saída; veja a seção de cobrança abaixo.

MiniMax H3: texto, primeiro quadro e último quadro

MiniMax-H3 aceita geração de texto para vídeo e com primeiro/último quadro pela mesma solicitação pública. Aceita 768P ou 2K, durações de 4 a 15 segundos e as proporções 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16. Os valores padrão são 768P, 9:16 e 5 segundos. Não envie generate_audio: o contrato público do H3 não tem uma alternância de solicitação para áudio gerado.

Kling: geração orientada por quadros

json
{
  "model": "kling-v3",
  "prompt": "a train enters the station through light fog",
  "content": [
    { "type": "image_url", "image_url": "https://cdn.example.com/kling-first.png", "role": "first_frame" },
    { "type": "image_url", "image_url": "https://cdn.example.com/kling-last.png", "role": "last_frame" }
  ],
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true
}

Diferenças importantes entre os modelos Kling:

  • kling-v2-6: o último quadro exige 1080p; o áudio gerado só está disponível em 1080p e não pode ser combinado com um último quadro.
  • kling-3.0-turbo: somente o primeiro quadro; sem áudio gerado.
  • kling-v3 e kling-v3-omni: aceitam primeiro/último quadro e áudio gerado.
  • kling-v3-omni também aceita até duas imagens de referência sem papel, mas não misture imagens sem papel com imagens que tenham papéis de quadro na mesma solicitação.
  • kling-video-o1: primeiro/último quadro; sem áudio gerado.

Grok: imagens de referência sem ordem

O Grok aceita até sete URLs de imagens de referência. Não atribua os papéis first_frame ou last_frame.

json
{
  "model": "grok-imagine-1.5-video",
  "prompt": "clouds roll over a canyon while the camera rises",
  "content": [
    { "type": "image_url", "image_url": "https://cdn.example.com/grok-reference.png" }
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 6
}

Os valores padrão do Grok são 480p, 9:16 e 6 segundos. Áudio gerado não é compatível.

Kling Motion Control

Forneça uma imagem HTTPS pública e um vídeo MP4 HTTPS público de 3 a 30 segundos:

json
{
  "model": "kling-v3-motion-control",
  "prompt": "preserve the character identity and follow the reference motion",
  "content": [
    { "type": "image_url", "image_url": "https://cdn.example.com/character.png", "role": "reference_image" },
    { "type": "video_url", "video_url": "https://cdn.example.com/motion.mp4", "role": "reference_video" }
  ],
  "motion_mode": "std",
  "character_orientation": "image",
  "keep_original_sound": true
}
  • character_orientation: "image": o vídeo de referência deve ter de 3 a 10 segundos.
  • character_orientation: "video": o vídeo de referência deve ter de 3 a 30 segundos.
  • Não envie resolution, ratio, duration ou generate_audio com um modelo Motion Control.

Tabela de recursos dos modelos

ID canônico do modeloResolução / modoDuraçãoProporçãoReferênciasÁudio padrão
doubao-seedance-2.5480p, 720p4–30 s16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveQuadro inicial + final (sem vídeos de referência, segue a primeira imagem; ratio: adaptive ou omitido), ou até 10 vídeos de referência + 2 imagens de referência comunsAtivado
doubao-seedance-2.0480p, 720p, 1080p, 4K4–15 s16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptivePrimeiro + último quadroAtivado
doubao-seedance-2.0-fast480p, 720p4–15 sIgual ao Seedance 2.0Primeiro + último quadroAtivado
doubao-seedance-2.0-mini480p, 720p4–15 sIgual ao Seedance 2.0Primeiro + último quadroAtivado
doubao-seedance-1-5-pro480p, 720p, 1080p4–12 s16:9, 9:16, 1:1, 4:3, 3:4, 21:9Primeiro + último quadroAtivado
MiniMax-H3768P, 2K4–15 s21:9, 16:9, 4:3, 1:1, 3:4, 9:16Primeiro + último quadroSem alternância pública de áudio gerado
kling-v2-6720p, 1080p5 ou 10 s16:9, 9:16, 1:1Primeiro + último quadro condicionalDesativado
kling-3.0-turbo720p, 1080p3–15 s16:9, 9:16, 1:1Somente primeiro quadroNão compatível
kling-v3720p, 1080p, 4K3–15 s16:9, 9:16, 1:1Primeiro + último quadroAtivado
kling-v4720p, 1080p3–30 s16:9, 9:16, 1:1, 21:98 images / 5 videos, edit / extendOn
kling-v4-flash720p3–20 s16:9, 9:16, 1:1, 21:910 images / 5 videos, edit / extendOn
gemini-omni-1.2-flash360p, 720p, 1080p, 4k3–15 s16:9, 9:1610 images / 1 video, edit / extendOn
kling-v3-omni720p, 1080p, 4K3–15 s16:9, 9:16, 1:1Primeiro + último ou até 2 imagens sem papelAtivado
kling-video-o1720p, 1080p5 ou 10 s16:9, 9:16, 1:1Primeiro + último quadroNão compatível
kling-v2-6-motion-controlstd, proVídeo de referência—1 imagem + 1 vídeoSom original ativado
kling-v3-motion-controlstd, proVídeo de referência—1 imagem + 1 vídeoSom original ativado
grok-imagine-1.5-video480p, 720p6–30 s16:9, 9:16, 1:1, 3:2, 2:3Até 7 imagens sem papelNão compatível

Para modelos padrão, os valores opcionais omitidos usam os padrões de cada modelo exibidos acima. O próprio model é sempre obrigatório. O serviço valida as combinações antes de iniciar o trabalho.


Kling 4

kling-v4: 720p / 1080p, duração inteira de 3–30 segundos (padrão 5). Áudio sempre ligado; generate_audio: false é rejeitado localmente. Os modelos Kling 4 aceitam omni_reference_task_type: auto / reference / edit / extend. Proporções: 16:9 / 9:16 / 1:1 / 21:9; auto apenas em referência. Omita ratio na extensão. Suporta primeiro/último quadro, até 8 imagens e 5 vídeos; cada vídeo de 3–30 segundos, total até 30. Edição/extensão aceitam um vídeo. Sem duration na edição, usa-se a duração de entrada arredondada para cima; os outros modos usam 5 segundos por padrão. Toda mídia, incluindo primeiro/último quadro, usa asset_id: envie multipart com kind=image ou kind=video e file para POST /v1/videos/assets, depois use o id retornado na geração. URLs diretas de imagem/vídeo, áudio de referência e quadros intermediários não são aceitos. Extensão aceita último quadro de destino sem primeiro quadro.

Referências: comum 720p ¥1.0486/s, 1080p ¥1.5729/s; entrada de vídeo 720p ¥0.62916/segundo faturável, 1080p ¥0.94374/segundo faturável. Referência/edição com vídeo cobra segundos de saída + max(segundos de saída, total de entrada arredondado para cima); extensão cobra apenas os segundos adicionados.

json
{
  "model": "kling-v4",
  "prompt": "Preserve the subject and change the setting",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "omni_reference_task_type": "edit",
  "content": [
    {
      "type": "video_url",
      "role": "reference_video",
      "asset_id": "vasset_uploaded_video"
    }
  ]
}

Kling 4.0 Flash

Kling 4.0 Flash gera vídeo com áudio em 720p, de 3 a 20 segundos (padrão de 5), usando omni_reference_task_type. Para gerar a partir do primeiro quadro, envie apenas um first_frame e omita ratio para seguir a proporção da imagem. A geração por referência aceita até 10 imagens e 5 vídeos de 3 a 20 segundos cada, com até 20 segundos no total. A edição aceita um vídeo de 3 a 20 segundos e imagens de referência opcionais. A extensão aceita um vídeo, omite imagens e ratio e devolve apenas o novo trecho. Use o asset_id dos seus arquivos.

A geração 720p sem vídeo de entrada e o trecho acrescentado pela extensão custam ¥0.66 por segundo. A edição e a geração com vídeos de referência custam ¥0.440003 por segundo cobrado. Some a duração da saída ao maior valor entre a duração da saída e a duração de entrada arredondada para cima.

Novos modelos de vídeo

Envie a mídia dos novos modelos com seu próprio asset_id. Limites do site: imagens até 10 MB e vídeos de pelo menos 3 segundos com até 100 MiB. O Vidu Q4 não aceita referências de áudio.

FLUX3 Video

FLUX3: texto, imagem e edição de um vídeo, 5–20 segundos (padrão5), hd/fhd. Proporções auto/21:9/2:1/16:9/4:3/1:1/3:4/9:16. Até10 imagens na ordem primeiro→referências intermediárias→último, preservando repetições. Um vídeo de3–30s. draft:true somente HD. Modos auto/t2v/i2v/v2v/draft_enhance. Áudio de saída ligado por padrão; desligado tem o mesmo preço de referência.

Escolha Gerar versão final/Aprimorar no histórico de um rascunho FLUX3 concluído. Envie apenas model, generation_mode:draft_enhance, source_task_id do site e resolution; sem novo prompt, mídia, duração ou áudio. Exige rascunho próprio do mesmo modelo, concluído e liquidado. O custo do rascunho não é creditado.

Vidu

Vidu Q4: primeiro quadro único(prompt opcional) ou1–15 referências(prompt obrigatório, até20000 caracteres), sem texto puro ou último quadro. Uma reference_image já seleciona referências; não misture com primeiro quadro.3–16s,540p/720p/1080p/2K/4K. Q3 exige1–7 referências,prompt até5000 caracteres,3–16s; Mix1–16s,só720p/1080p. Pro/Turbo: texto,primeiro quadro ou primeiro+último,1–16s,540p/720p/1080p. Texto exige prompt até2000 caracteres; imagem é opcional. Todos padrão720p/5s. Referência/texto:1:1/9:16/16:9/3:4/4:3; primeiro quadro segue imagem e omite proporção. Q3/Mix sem controle de áudio; Q4/Pro/Turbo áudio ligado por padrão, desligado no mesmo preço de referência.

Gemini Omni 1.1 Flash

gemini-omni-1.1-flash

360p/720p/1080p/4k, proporção 16:9 ou 9:16 e duração de 4/6/8/10 segundos (padrão de 6). O prompt é obrigatório. Use só texto, um primeiro quadro, ou exatamente uma ou três imagens de referência. Selecione auto, t2v, frame ou reference em generation_mode e omita as opções de áudio. Último quadro, entrada de vídeo e continuação de tarefas estão indisponíveis. A cobrança é por clipe.

Gemini Omni Flash Preview

gemini-omni-flash-preview aceita 720p, até 16 imagens de referência ou um vídeo de 3 a 24 segundos. Omita ratio ao enviar um vídeo. O prompt determina a duração da saída de 3 a 10 segundos. Omita duration, generate_audio, semente, prompt negativo e contagem.

Para continuar uma tarefa Preview sua, concluída e liquidada, selecione Continuar geração no histórico e envie um novo prompt. Use o source_task_id do site ou um vídeo. Modos: auto/t2v/i2v/reference/edit/extend.

FLUX3 e Gemini Omni Flash Preview exibem preços de referência da saída. Mídia e contexto podem adicionar uso e a liquidação segue o custo real da tarefa. Se o progresso estiver em 99% aguardando a liquidação, continue consultando a tarefa original.

Gemini Omni 1.2 Flash

Gemini Omni 1.2 Flash aceita 360p/720p/1080p/4k, proporção 16:9 ou 9:16 e exige prompt em todos os modos. Use generation_mode: auto para texto ou quadros, ou reference para até 10 imagens de referência. Não misture referências com primeiro e último quadro. A duração vai de 3 a 15 segundos (padrão de 10), ou de 3 a 10 segundos com primeiro e último quadro.

Edite ou estenda com generation_mode: edit ou extend, passando o asset_id de um MP4/MOV de até 15 segundos e 64 MB. Omita duration na edição, que cobra pela duração original. Na extensão, duration adiciona de 3 a 10 segundos e a cobrança cobre apenas esse trecho. Para estender uma tarefa sua já concluída no mesmo modelo, use o source_task_id do site. Omita generate_audio.

Preço final de referência em RMB (por segundo)

ModelResoluçãoRMB
flux-3-videodraft¥0.35952
flux-3-videohd¥1.01864
flux-3-videofhd¥1.73768
flux-3-videov2v-draft¥0.71904
flux-3-videov2v-hd¥2.45672
flux-3-videov2v-fhd¥3.17576
viduq4-preview540p¥0.335552
viduq4-preview720p¥0.683088
viduq4-preview1080p¥0.766976
viduq4-preview2K¥1.216376
viduq4-preview4K¥2.492672
viduq3540p¥0.2996
viduq3720p¥0.5992
viduq31080p¥0.749
viduq3-mix720p¥0.749
viduq3-mix1080p¥0.8988
viduq3-pro540p¥0.41944
viduq3-pro720p¥0.8988
viduq3-pro1080p¥0.95872
viduq3-turbo540p¥0.23968
viduq3-turbo720p¥0.35952
viduq3-turbo1080p¥0.41944
gemini-omni-flash-preview720p¥0.65912
gemini-omni-1.2-flash360p¥0.1232
gemini-omni-1.2-flash720p¥0.1848
gemini-omni-1.2-flash1080p¥0.1848
gemini-omni-1.2-flash4k¥0.4312

Preços finais de referência do Gemini Omni 1.1 Flash em RMB (por clipe)

Resolução4 segundos6 segundos8 segundos10 segundos
360p¥1.155¥1.3475¥1.54¥1.7325
720p¥1.925¥2.31¥2.695¥3.08
1080p¥1.925¥2.31¥2.695¥3.08
4k¥5.775¥6.16¥6.545¥6.93