Operação
Checklist de produção
Preparar uma integração de geração confiável: custos, tarefas, webhooks e recuperação de erros.
A produção começa antes da chamada de API: valide a entrada, estime o preço, guarde o taskId e trate o resultado de forma assíncrona.
Princípios práticos
Escolha o modelo pela prioridade — velocidade, fidelidade, resolução ou controle — e guarde parâmetros e versão usados em cada resultado. the model selected for the task — Production checklist.
Mude uma coisa por tentativa. Boas saídas viram referências e o ponto de partida mais confiável para a próxima iteração.
Trate finished e failed como estados finais. Use polling ou webhooks, preserve erros brutos no servidor e mostre mensagens seguras ao usuário.
Prompts e exemplos de API
{"model": "veo3.1-fast","input": { "prompt": "…", "aspectRatio": "16:9" },"webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"}
{"code": 402,"error": {"message": "Insufficient balance. Please top up your account","type": "PaymentRequired","code": "insufficient_balance"}}
curl https://api.api-stock.com/api/v1/user/me \-H "Authorization: Bearer sk-your-key"
{"code": 200,"data": {"id": "019c1f70-2b44-70d3-9c22-6b7ad0f41e18","balance": 48250,"createdAt": "2026-01-14T09:03:11.000Z"}}
curl https://api.api-stock.com/api/v1/catalog
curl https://api.api-stock.com/api/v1/catalog/veo3.1-fast
Rode isto com a sua própria chave
Todos os modelos deste guia estão no catálogo do API Stock — uma chave de API, um saldo pré-pago e nenhum cadastro separado por provedor.