Pular para o conteúdo
HubRoque
Voltar para a documentação

Rota antiga do Veo

Só para apps que já usam o formato antigo, com corpo plano. Para código novo, use criar tarefa e consultar tarefa.

Código novo? Use POST /api/v1/jobs/createTask com model: "veo-3-1". Veja Criar tarefa.

Gerar vídeo

POST/api/v1/veo/generate
CampoO que é
modelveo3_lite, veo3_fast ou veo3 (qualidade).
promptDescrição do vídeo.
imageUrlsLista de links de imagem (para vídeo a partir de imagem).
generationTypeTipo de geração (texto, quadros ou referência).
aspect_ratio16:9 ou 9:16.
resolution720p, 1080p ou 4k, conforme a tabela de preços.
durationDuração em segundos.
enableTranslationTraduz o pedido para inglês antes de gerar.
watermarkTexto de marca d'água (opcional).
callBackUrlRecebe o aviso quando terminar (HTTPS público).
cURL
curl -X POST "https://api.hubroque.com.br/api/v1/veo/generate" \
  -H "Authorization: Bearer hr_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3_lite",
    "prompt": "Café sendo servido numa xícara branca, câmera lenta",
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "duration": 8,
    "callBackUrl": "https://seusite.com.br/webhooks/veo"
  }'
Resposta
{ "code": 200, "msg": "success", "data": { "taskId": "3f9c2a7be1d84c0f9a6b5e21c7d04a18" } }

O preço é o mesmo do Veo 3.1 na tabela, pela versão e resolução escolhidas. Vídeo em 1080p tem de ser pedido já em 1080p.

Consultar

GET/api/v1/veo/record-info?taskId=...
cURL
curl "https://api.hubroque.com.br/api/v1/veo/record-info?taskId=3f9c2a7be1d84c0f9a6b5e21c7d04a18" \
  -H "Authorization: Bearer hr_SUA_CHAVE"
Resposta
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "3f9c2a7be1d84c0f9a6b5e21c7d04a18",
    "paramJson": "{...}",
    "createTime": 1793660000000,
    "completeTime": 1793660095000,
    "response": {
      "taskId": "3f9c2a7be1d84c0f9a6b5e21c7d04a18",
      "resultUrls": ["https://.../resultados/3f9c.../0.mp4"],
      "originUrls": [],
      "fullResultUrls": [],
      "resolution": "720p"
    },
    "successFlag": 1,
    "errorCode": null,
    "errorMessage": "",
    "fallbackFlag": false,
    "creditsConsumed": 30.86
  }
}
successFlagQuer dizer
0Gerando.
1Pronto: links em response.resultUrls.
2Falhou antes de gerar (valor devolvido).
3Falhou durante a geração (valor devolvido).

successFlag é número. creditsConsumed vem em créditos equivalentes (veja Visão geral).

Callback

No formato antigo, o callback de sucesso vem com code: 200 e os links em data.info.resultUrls. Na falha, vem com o código do erro (400, 501 ou 500) e data.taskId. Confirme sempre com record-info antes de liberar algo importante.

Callback de sucesso
{
  "code": 200,
  "msg": "Video generated successfully.",
  "data": {
    "taskId": "3f9c2a7be1d84c0f9a6b5e21c7d04a18",
    "promptJson": "{...}",
    "info": { "resultUrls": ["https://.../0.mp4"], "originUrls": [], "resolution": "720p" },
    "creditsConsumed": 30.86
  }
}