> ## 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

> Lee una página web pública y devuelve un objeto nuevo construido a partir de ella, siguiendo tus instrucciones y tu JSON Schema.

Lee una página web pública y devuelve un objeto construido a partir de ella: un
resumen, una clasificación, una traducción, un registro reorganizado. A
diferencia de [Extract](/es/guides/global/extract), los campos no tienen que
aparecer en la página.

## Página convertida en objeto

`POST /global/generate/json/v1`

| Campo          | Tipo   | Notas                                                                                                                                |
| -------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| `url`          | string | **Obligatorio.** URL pública http o https. Las direcciones de loopback y privadas se rechazan.                                       |
| `instructions` | string | **Obligatorio.** De 3 a 20.000 caracteres. Qué hacer con la página. Escríbelo como le explicarías la tarea a un analista.            |
| `json_schema`  | object | **Obligatorio.** JSON Schema del objeto a devolver.                                                                                  |
| `effort`       | enum   | `min`, `standard` o `max`. Por defecto `standard`. `min` es el más rápido; `max` resuelve páginas que se construyen en el navegador. |
| `country`      | string | Código ISO 3166-1 alfa-2 (p. ej. `CO`) para páginas que sirven contenido distinto según el país. Omítelo para la ruta por defecto.   |

```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`    | La página que se leyó, después de las redirecciones.  |
| `result` | El objeto descrito por el `json_schema` que enviaste. |

<Note>
  La salida se redacta a partir de la página, así que trátala como un borrador:
  contrasta lo que vayas a usar con la página misma, que
  [Extract](/es/guides/global/extract) devuelve textual.
</Note>

<Warning>
  Generate tiene una cuota más ajustada que la mayoría de endpoints: **60
  solicitudes por hora** por organización, compartidas con Extract. Consulta
  [Límites de tasa](/es/rate-limits).
</Warning>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>