Generate - Croma API

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

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.

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

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.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.