> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Regiões e boas práticas

> Defina a região, use lotes e monitore sua fila.

Não existe limitador de taxa por chave, mas `429` é uma resposta real: indica contrapressão e sempre traz
`Retry-After`. Veja a tabela de códigos de erro para `QUEUE_BACKPRESSURE`, `PLAN_CONCURRENCY_LIMIT` e `API_KEY_DAILY_LIMIT`.

## Regiões

Defina a região com `payload.country` (ISO 3166-1 alfa-2). O padrão é `US`.

```json theme={null}
{ "taskType": "GEMINI", "payload": { "prompt": "...", "country": "GB" } }
```

Há uma única combinação `taskType` × `country` que não pode ser atendida: `CHATGPT`, `PERPLEXITY` e `GEMINI` para
`CN`. Ela é rejeitada **no envio** com `422 REGION_UNSUPPORTED` em vez de entrar na fila para falhar depois. Todos os
outros países listados são atendidos por todos os mecanismos, e `GOOGLE`/`AIMODE` nem usam nossos pools de saída.

## Boas práticas

<Steps>
  <Step title="Use o envio em lote">
    Um `POST /v1/async/task/batch` com 500 itens custa uma ida e volta. Quinhentos envios individuais custam quinhentas.
  </Step>

  <Step title="Ordene o trabalho dependente">
    A ordem de execução não é garantida. Espere uma tarefa terminar antes de enviar trabalho que dependa do resultado dela.
  </Step>

  <Step title="Monitore sua fila">
    `GET /stats` mostra a profundidade da fila e o estado das tarefas. Use-o para dosar envios grandes.
  </Step>
</Steps>