Modelos de vídeoUsuários avançadosAtualizado em
POST/v1/videos/generations
viduq3
ID da solicitação viduq3
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 | viduq3. 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. Até 5000 caracteres. |
content | array<object> | Obrigatório | Lista obrigatória de mídias de referência. Até 7 imagens. |
content[].type | string | Obrigatório | Valores aceitos: text, image_url, input_image. |
content[].text | string | Condicional | Informe o prompt quando o item tiver type: "text". |
content[].role | string | Condicional | Use reference_image em imagens de referência comuns. O papel é opcional para imagens de referência comuns. |
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) antes de file. |
resolution | string | Opcional | Valores aceitos: 540p, 720p, 1080p. Padrão: 720p. |
ratio | string | Opcional | Proporção de saída. Também aceita o alias aspect_ratio. Valores aceitos: 1:1, 9:16, 16:9, 3:4, 4:3. Padrão: 16:9. |
duration | integer | Opcional | Duração de saída em segundos. Aceita segundos inteiros de 3 a 16. Padrão: 5. |
generation_mode | string | Opcional | Valores aceitos: auto, r2v. O padrão auto escolhe o modo pela mídia. Se indicar o modo, ele deve ser compatível com a entrada. |
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": "viduq3",
"prompt": "Move the camera slowly toward the subject in the reference image.",
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"content": [
{
"type": "image_url",
"role": "reference_image",
"asset_id": "YOUR_IMAGE_ASSET_ID"
}
]
}'
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'
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": "viduq3",
"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": "viduq3",
"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· Não compatívelimage_to_video· Compatívelfirst_frame· Não compatívellast_frame· Não compatívelreference_images· Compatívelvideo_input· Não compatívelaudio· Não publicado- Limites Resoluções: 540p, 720p, 1080p · Proporções: 1:1, 9:16, 16:9, 3:4, 4:3 · Imagens de referência: até 7 · Durações: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16 · Entrada: Site images ≤10 MB. No audio reference upload. No supplier task IDs.
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.