Vidu Image Q2 · Referência da API
Gere imagens com Vidu Image Q2 a partir de texto ou imagens de referência. Consulte as tarefas e baixe os resultados.
Crie uma tarefa com POST /v1/wand/vidu-image/generation e consulte-a com GET /v1/wand/vidu-image/tasks/{task_id}. Envie uma chave de API APIMaster no cabeçalho Authorization: Bearer com ambos os pedidos. O corpo da solicitação POST usa JSON.
| Campo | Tipo | Descrição |
|---|---|---|
model |
string | Obrigatório. Use vidu-image-q2. |
prompt |
string | Obrigatório. Até 2,000 caracteres. Para gerar imagens só a partir de texto, omita as referências (text-to-image). |
images |
string[] | Opcional. Até sete URLs públicas ou URIs de dados em PNG, JPEG/JPG ou WebP. Cada imagem deve ter pelo menos 128 × 128 pixels, proporção entre 1:4 e 4:1 e tamanho máximo de 50 MB. O corpo da solicitação pode ter até 20 MB. |
aspect_ratio |
string | 16:9 por padrão. As opções são 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2 e auto. A configuração auto segue a primeira imagem de referência. |
resolution |
string | 1080p por padrão. Também suporta 2K e 4K. Os valores diferenciam maiúsculas de minúsculas. |
seed |
integer | Omita o campo ou use 0 para escolher uma semente aleatória. |
curl -X POST "https://apimaster.ai/v1/wand/vidu-image/generation" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"vidu-image-q2","prompt":"A blue circle on a white background","resolution":"1080p"}'
Consulte o status a cada 3–5 segundos com o task_id retornado e a mesma conta. Os estados possíveis são created, queueing, processing, success e failed. No sucesso, baixe os arquivos em creations[].url dentro de horas 12. Use request_id para rastrear falhas, como imagens inválidas, revisão de conteúdo, crédito insuficiente, limites de taxa ou tarefas em falta.
Consultar o status não inicia uma nova geração nem cobra outra vez. callback_url não é suportado. Para recuperar uma submissão perdida, envie um Idempotency-Key estável de caracteres 8–128 visíveis ASCII e siga o guia de recuperação Guia de recuperação de solicitações. A mesma chave com os mesmos parâmetros retorna um recibo de recuperação com HTTP 202. Parâmetros diferentes com a mesma chave retornam HTTP 409.
tokenhub_usage.total_tokens relata o uso faturável, que depende da resolução e quantas referências foram usadas. Veja o modelo ZVidu Image Q2 cartão para o preço atual APIMaster.
