Generate - Croma API

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, 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.

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.

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 devuelve textual.

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.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.