Modelos de vídeoUsuários avançadosAtualizado em
POST/v1/videos/generations
Gemini Omni 1.2 Flash
ID da solicitação gemini-omni-1.2-flash
Protocolos
POST /v1/videos/generations· Gerar vídeo · exemploGET /v1/videos/tasks/{id}· Consultar tarefa de vídeo · exemploGET /v1/videos/tasks/{id}/content· Baixar vídeo · exemploDELETE /v1/videos/tasks/{id}· Excluir tarefa de vídeo encerrada · exemploPOST /v1/videos/assets· Enviar mídia · exemploDELETE /v1/videos/assets/{id}· Excluir mídia · exemplo
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
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
model | string | Obrigatório | gemini-omni-1.2-flash. Use o ID do modelo indicado nesta página. |
prompt | string | Condicional | Descreva 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. |
content | array<object> | Condicional | Lista de mídias de referência e texto opcional. Omita ao gerar apenas com prompt. Use quadros inicial/final, até dez imagens de referência ou um vídeo MP4/MOV de até 15 segundos e 64 MB. Envie esses tipos separadamente. |
content[].type | string | Obrigatório | Valores aceitos: text, image_url, input_image, video_url, input_video. |
content[].text | string | Condicional | Informe o prompt quando o item tiver type: "text". |
content[].role | string | Condicional | Use first_frame e last_frame. O último quadro exige o primeiro. Use reference_image em imagens de referência comuns. Use reference_video nas entradas de vídeo. |
content[].asset_id | string | Condicional | Envie a mídia para POST /v1/videos/assets e use o id retornado. No formulário multipart, envie kind (image, video) antes de file. |
resolution | string | Opcional | Valores aceitos: 360p, 720p, 1080p, 4k. Padrão: 720p. |
ratio | string | Opcional | Proporção de saída. Também aceita o alias aspect_ratio. Valores aceitos: 16:9, 9:16. Padrão: 16:9. |
duration | integer | Opcional | Duração de saída em segundos. Aceita segundos inteiros de 3 a 15. Texto e referências de imagem usam 10 segundos por padrão. Quadros e extensão aceitam 3–10 segundos. Omita na edição. Na extensão, informa o tempo acrescentado. |
generation_mode | string | Opcional | Valores aceitos: auto, t2v, i2v, reference, edit, extend. O padrão auto escolhe o modo pela mídia. Se indicar o modo, ele deve ser compatível com a entrada. |
source_task_id | string | Condicional | ID de uma tarefa sua concluída e liquidada no mesmo modelo. Use este campo ou um vídeo enviado. |
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": "gemini-omni-1.2-flash",
"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
Enviar mídia
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/assets' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-F 'kind=image' \
-F '[email protected];type=image/png'
Enviar mídia · Enviar vídeo
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'
Excluir mídia
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/assets/YOUR_ASSET_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": "gemini-omni-1.2-flash",
"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": "gemini-omni-1.2-flash",
"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.
| Campo | Tipo | Descrição |
|---|---|---|
id / task_id | string | ID da tarefa. Na resposta de criação, task_id é igual a id. |
status | string | Estado da tarefa: queued, running, succeeded ou failed. |
progress | integer | Progresso da geração. O campo é omitido quando o valor está indisponível. |
error.code | string | Classificação do erro para tarefas com falha. |
Erros comuns
| HTTP | Tipo de erro | Descrição |
|---|---|---|
| 400 | invalid_request | Confira o modelo, a combinação de parâmetros e a mídia de referência. |
| 401 | unauthorized | Confira se a chave de API está ausente, inválida ou desativada. |
| 402 | insufficient_balance | O saldo é insuficiente para enviar a tarefa. |
| 404 | not_found | Se 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. |
| 409 | video_not_ready | O vídeo ainda está em geração. Continue consultando o status. |
| 503 | submission_unknown | O 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ívelimage_to_video· Compatívelfirst_frame· Compatívellast_frame· Compatívelreference_images· Compatívelvideo_input· Compatívelaudio· Não publicado- Limites Resoluções: 360p, 720p, 1080p, 4k · Proporções: 16:9, 9:16 · Durações: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 · Imagens de referência: até 10 · Entrada: Use 3–10 seconds with first and last frames or extension. Edit or extend one video up to 15 seconds and 64 MB. Editing follows the source duration.
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.