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

# Generate

> Lê uma página web pública e retorna um objeto novo construído a partir dela, seguindo suas instruções e seu JSON Schema.

Lê uma página web pública e retorna um objeto construído a partir dela: um
resumo, uma classificação, uma tradução, um registro reorganizado. Diferente
de [Extract](/pt/guides/global/extract), os campos não precisam
aparecer na página.

## Página convertida em objeto

`POST /global/generate/json/v1`

| Campo          | Tipo   | Notas                                                                                                                          |
| -------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| `url`          | string | **Obrigatório.** URL pública http ou https. Endereços de loopback e privados são rejeitados.                                   |
| `instructions` | string | **Obrigatório.** De 3 a 20.000 caracteres. O que fazer com a página. Escreva como você explicaria a tarefa a um analista.      |
| `json_schema`  | object | **Obrigatório.** JSON Schema do objeto a retornar.                                                                             |
| `effort`       | enum   | `min`, `standard` ou `max`. Padrão `standard`. `min` é o mais rápido; `max` resolve páginas que são construídas no navegador.  |
| `country`      | string | Código ISO 3166-1 alfa-2 (p. ex. `CO`) para páginas que servem conteúdo diferente conforme o país. Omita-o para a rota padrão. |

```bash theme={"dark"}
curl https://api.croma.run/global/generate/json/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.funcionpublica.gov.co/eva/gestornormativo/norma.php?i=304", "instructions": "Resume la norma en dos frases y clasifica su materia principal.", "json_schema": { "type": "object", "required": ["summary", "subject"], "properties": { "summary": { "type": "string" }, "subject": { "type": "string" } } } }'
```

| Campo    | Notas                                                 |
| -------- | ----------------------------------------------------- |
| `url`    | A página que foi lida, depois dos redirecionamentos.  |
| `result` | O objeto descrito pelo `json_schema` que você enviou. |

<Note>
  A saída é redigida a partir da página, então trate-a como um rascunho:
  confira o que você for usar com a própria página, que
  [Extract](/pt/guides/global/extract) retorna textual.
</Note>

<Warning>
  Generate tem uma cota mais apertada que a maioria dos endpoints: **60
  solicitações por hora** por organização, compartilhadas com Extract. Consulte
  [Limites de taxa](/pt/rate-limits).
</Warning>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>