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:
Authorization: Bearer <your API key>
Endpoints
| Finalidade | Método e rota |
|---|---|
| Criar um trabalho de vídeo | POST /v1/videos/generations |
| Consultar um trabalho | GET /v1/videos/tasks/{id} |
| Baixar o conteúdo concluído | GET /v1/videos/tasks/{id}/content |
| Excluir um trabalho concluído ou com falha | DELETE /v1/videos/tasks/{id} |
| Enviar mídia de referência | POST /v1/videos/assets |
| Excluir mídia de referência | DELETE /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
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:
{
"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:
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.
{
"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:
{
"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.
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
| Status | Significado | Ação do cliente |
|---|---|---|
queued | Aceito e aguardando o início | Continue consultando o mesmo trabalho |
running | O vídeo está sendo gerado | Continue consultando o mesmo trabalho |
succeeded | Sucesso terminal; o conteúdo está pronto | Baixe e armazene o resultado |
failed | Falha terminal | Leia error.code; crie um novo trabalho somente se decidir tentar novamente |
Regras para novas tentativas:
- Depois de receber HTTP
202, continue consultando otask_idretornado. Repetir a solicitação de criação pode criar outro trabalho. - Solicitações
GETde consulta e download podem ser repetidas com segurança. - Um HTTP
404durante a consulta não significa que a geração falhou e não deve causar um novo envio. Guarde o ID original, confira ostatus_urlretornado ou useGET /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
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
model | string | Sim | ID canônico do modelo. Não há modelo padrão; valores ausentes ou vazios retornam 400 invalid_request. |
prompt | string | Texto obrigatório nos modelos padrão | Coloque todas as instruções de texto aqui. Para Motion Control, é opcional quando os dois ativos de referência são fornecidos. |
content | array | Ao usar referências | Lista de imagens e vídeos de referência. Os campos dependem de como o modelo recebe a mídia. |
resolution | string | Não | Nível de resolução da saída. O padrão e os valores permitidos dependem do modelo. Não é aceito por Motion Control. |
ratio | string | Não | Proporção da saída. aspect_ratio é aceito como alias. Não é aceito por Motion Control. |
duration | integer | Não | Segundos solicitados. O padrão e os valores permitidos dependem do modelo. Não é aceito por Motion Control. |
generate_audio | boolean | Não | Gera áudio quando houver suporte. Os valores padrão estão na tabela de modelos. Não é aceito por Motion Control. |
motion_mode | string | Somente Motion Control | std ou pro; o padrão é std. |
character_orientation | string | Somente Motion Control | image ou video; o padrão é image. Controla o limite de duração do vídeo de referência. |
keep_original_sound | boolean | Somente Motion Control | Manté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_urlouvideo_urluma 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
idretornado no campoasset_idde cada item.
O exemplo abaixo usa URLs para o primeiro e o último quadro.
[
{ "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_urlouinput_image. - Tipos de vídeo:
video_urlouinput_video. - Papéis de quadro:
first_frameelast_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 usamreference_image. - Papéis de movimento: um
reference_imagee umreference_video. - As imagens de referência do Grok não têm papel;
reference_imagetambé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.
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
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:
| Campo | Significado |
|---|---|
id | ID de trabalho restrito ao proprietário, usado para consulta, conteúdo, exclusão e suporte |
object | Sempre video.generation.job |
status | queued, running, succeeded ou failed |
model | ID canônico do modelo após a normalização de aliases |
created_at, updated_at | Timestamps UTC no formato RFC 3339 |
progress | Progresso aproximado da geração, omitido quando não estiver disponível |
status_url, content_url | Caminhos oficiais de consulta e download relativos à URL base; o conteúdo retorna 409 video_not_ready antes do sucesso |
url | Presente somente após o sucesso; pode ser um caminho de conteúdo do relay ou um caminho assinado para um arquivo do relay |
cost_rmb | Cobrança final do trabalho, presente após a liquidação bem-sucedida |
error.code | Categoria 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
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:
{
"error": {
"type": "invalid_request",
"message": "model is not supported"
}
}
| HTTP | Tipo de erro | Significado / ação |
|---|---|---|
400 | invalid_request | Modelo, campos, URL de mídia, papéis, duração, proporção ou combinação de modelo inválidos; corrija a solicitação |
401 | unauthorized | A chave de API está ausente, é inválida ou está desativada |
402 | insufficient_balance | O saldo não cobre o trabalho solicitado; a geração não é iniciada |
404 | not_found | O trabalho não existe ou pertence a outra conta |
409 | video_not_ready | O conteúdo foi solicitado antes do sucesso terminal |
409 | video_delete_unsafe | Ainda não é seguro excluir o trabalho |
413 | request_too_large | O corpo JSON da solicitação de criação excede o limite |
502 | upstream_error | Falha na geração do vídeo ou no download do resultado |
503 | video_service_unavailable, upstream_quota_exceeded, video_price_unavailable | A capacidade do serviço de vídeo ou o preço público atual está temporariamente indisponível |
503 | submission_unknown | A aceitação do trabalho é incerta; não envie uma duplicata |
Uma resposta de trabalho com falha pode ter este formato:
{
"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.
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:
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.
{
"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:
{
"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
480pou720p. É possível definirratioegenerate_audio; não use parâmetros exclusivos do Motion Control. - É possível fornecer também até 2 imagens com
type: "image_url", uma string emimage_urlerole: "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
{
"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 exige1080p; o áudio gerado só está disponível em1080pe não pode ser combinado com um último quadro.kling-3.0-turbo: somente o primeiro quadro; sem áudio gerado.kling-v3ekling-v3-omni: aceitam primeiro/último quadro e áudio gerado.kling-v3-omnitambé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.
{
"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:
{
"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,durationougenerate_audiocom um modelo Motion Control.
Tabela de recursos dos modelos
| ID canônico do modelo | Resolução / modo | Duração | Proporção | Referências | Áudio padrão |
|---|---|---|---|---|---|
doubao-seedance-2.5 | 480p, 720p | 4–30 s | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | Quadro 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 comuns | Ativado |
doubao-seedance-2.0 | 480p, 720p, 1080p, 4K | 4–15 s | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive | Primeiro + último quadro | Ativado |
doubao-seedance-2.0-fast | 480p, 720p | 4–15 s | Igual ao Seedance 2.0 | Primeiro + último quadro | Ativado |
doubao-seedance-2.0-mini | 480p, 720p | 4–15 s | Igual ao Seedance 2.0 | Primeiro + último quadro | Ativado |
doubao-seedance-1-5-pro | 480p, 720p, 1080p | 4–12 s | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 | Primeiro + último quadro | Ativado |
MiniMax-H3 | 768P, 2K | 4–15 s | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Primeiro + último quadro | Sem alternância pública de áudio gerado |
kling-v2-6 | 720p, 1080p | 5 ou 10 s | 16:9, 9:16, 1:1 | Primeiro + último quadro condicional | Desativado |
kling-3.0-turbo | 720p, 1080p | 3–15 s | 16:9, 9:16, 1:1 | Somente primeiro quadro | Não compatível |
kling-v3 | 720p, 1080p, 4K | 3–15 s | 16:9, 9:16, 1:1 | Primeiro + último quadro | Ativado |
kling-v4 | 720p, 1080p | 3–30 s | 16:9, 9:16, 1:1, 21:9 | 8 images / 5 videos, edit / extend | On |
kling-v4-flash | 720p | 3–20 s | 16:9, 9:16, 1:1, 21:9 | 10 images / 5 videos, edit / extend | On |
gemini-omni-1.2-flash | 360p, 720p, 1080p, 4k | 3–15 s | 16:9, 9:16 | 10 images / 1 video, edit / extend | On |
kling-v3-omni | 720p, 1080p, 4K | 3–15 s | 16:9, 9:16, 1:1 | Primeiro + último ou até 2 imagens sem papel | Ativado |
kling-video-o1 | 720p, 1080p | 5 ou 10 s | 16:9, 9:16, 1:1 | Primeiro + último quadro | Não compatível |
kling-v2-6-motion-control | std, pro | Vídeo de referência | — | 1 imagem + 1 vídeo | Som original ativado |
kling-v3-motion-control | std, pro | Vídeo de referência | — | 1 imagem + 1 vídeo | Som original ativado |
grok-imagine-1.5-video | 480p, 720p | 6–30 s | 16:9, 9:16, 1:1, 3:2, 2:3 | Até 7 imagens sem papel | Nã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.
{
"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)
| Model | Resolução | RMB |
|---|---|---|
flux-3-video | draft | ¥0.35952 |
flux-3-video | hd | ¥1.01864 |
flux-3-video | fhd | ¥1.73768 |
flux-3-video | v2v-draft | ¥0.71904 |
flux-3-video | v2v-hd | ¥2.45672 |
flux-3-video | v2v-fhd | ¥3.17576 |
viduq4-preview | 540p | ¥0.335552 |
viduq4-preview | 720p | ¥0.683088 |
viduq4-preview | 1080p | ¥0.766976 |
viduq4-preview | 2K | ¥1.216376 |
viduq4-preview | 4K | ¥2.492672 |
viduq3 | 540p | ¥0.2996 |
viduq3 | 720p | ¥0.5992 |
viduq3 | 1080p | ¥0.749 |
viduq3-mix | 720p | ¥0.749 |
viduq3-mix | 1080p | ¥0.8988 |
viduq3-pro | 540p | ¥0.41944 |
viduq3-pro | 720p | ¥0.8988 |
viduq3-pro | 1080p | ¥0.95872 |
viduq3-turbo | 540p | ¥0.23968 |
viduq3-turbo | 720p | ¥0.35952 |
viduq3-turbo | 1080p | ¥0.41944 |
gemini-omni-flash-preview | 720p | ¥0.65912 |
gemini-omni-1.2-flash | 360p | ¥0.1232 |
gemini-omni-1.2-flash | 720p | ¥0.1848 |
gemini-omni-1.2-flash | 1080p | ¥0.1848 |
gemini-omni-1.2-flash | 4k | ¥0.4312 |
Preços finais de referência do Gemini Omni 1.1 Flash em RMB (por clipe)
| Resolução | 4 segundos | 6 segundos | 8 segundos | 10 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 |
Guias relacionados
API de geração de imagens
Gere ou edite imagens com a API compatível com OpenAI. Envie prompts, dimensões e imagens de referência e consulte os resultados ou o status das tarefas assíncronas.
API de Consulta de Saldo
Consulte o saldo com token Bearer para ver saldo em CNY, cota diária do plano, vencimento e o significado dos campos da resposta.