Operação

Checklist de produção

Preparar uma integração de geração confiável: custos, tarefas, webhooks e recuperação de erros.

1 min de leitura2 seções

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

json

{
  "model": "veo3.1-fast",
  "input": { "prompt": "…", "aspectRatio": "16:9" },
  "webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"
}

json

{
  "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"

json

  {
    "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

Escolha um modelo no catálogo API Stock, confira o preço e teste no navegador ou por API.

Ver o catálogo Referência da API

Checklist de produção

Princípios práticos

Prompts e exemplos de API

Rode isto com a sua própria chave

Continue lendo