Documentación de API
Integre FreeOCR.AI en sus aplicaciones con nuestra API.
Autenticación
Todas las solicitudes de API requieren una clave de API pasada en el encabezado Authorization como token Bearer.
Cree y gestione sus claves de API en la página de Claves de API.
Límites de velocidad
Límite de velocidad predeterminado: 200 solicitudes por minuto por clave de API.
Los límites de velocidad se pueden ajustar por clave. Contacte con soporte para límites personalizados.
POST /ocr
Demo en vivoExtraer texto de imágenes conservando el diseño.
Parámetros
image(requerido) - Archivo de imagenformat(opcional) - Formato de respuesta: json (predeterminado), text, docxversion(opcional) - Versión del modelo: 260428 (predeterminado)Respuesta
{
"text": "# Document Title\n\nExtracted markdown content..."
}Devuelve GitHub Flavored Markdown con conservación del diseño, incluyendo tablas HTML y fórmulas LaTeX.
{
"text": "Document Title\n\nExtracted plain text content..."
}El Markdown se convierte a texto plano mediante conversión interna.
Descarga de archivo binario. Content-Disposition: attachment; filename="result.docx"
Ejemplo
curl -X POST "https://freeocr.ai/api/v1/platform/ocr" \
-H "Authorization: Bearer focr_your_key" \
-F "image=@document.png"POST /table
Demo en vivoExtraer tablas de imágenes en datos estructurados.
Parámetros
image(requerido) - Archivo de imagenformat(opcional) - Formato de respuesta: json (predeterminado), csv, xlsxversion(opcional) - Versión del modelo: 260428 (predeterminado)Respuesta
{
"tables": [
{
"title": "Sales Report",
"html": "<table><tr><th>Item</th><th>Qty</th></tr><tr><td>Apple</td><td>10</td></tr></table>"
}
]
}Cada tabla incluye un title y su contenido como cadena de tabla HTML.
Descarga de archivo CSV de texto plano. Múltiples tablas se separan con delimitadores --- SheetName ---. Content-Disposition: attachment; filename="tables.csv"
Descarga de archivo XLSX binario. Cada tabla se convierte en una hoja separada con su título como nombre. Content-Disposition: attachment; filename="tables.xlsx"
Ejemplo
curl -X POST "https://freeocr.ai/api/v1/platform/table" \
-H "Authorization: Bearer focr_your_key" \
-F "image=@spreadsheet.png"POST /extract
Demo en vivoExtraer campos específicos de imágenes usando IA.
Parámetros
image(requerido) - Archivo de imagenfields(requerido) - Campos a extraer (parámetro repetido o array JSON)format(opcional) - Formato de respuesta: json (predeterminado), csv, xlsxversion(opcional) - Versión del modelo: 260428 (predeterminado), 260215Respuesta
{
"result": [
{ "key": "name", "values": ["John Doe"] },
{ "key": "date", "values": ["2024-03-15"] },
{ "key": "amount", "values": ["$1,234.56"] }
]
}Cada campo solicitado se devuelve como key con un array de values extraídas.
Archivo CSV con las claves de campo como encabezados de columna y los valores extraídos como filas. Content-Disposition: attachment; filename="extraction.csv"
Archivo XLSX con una única hoja "Results", mismo diseño que CSV. Content-Disposition: attachment; filename="extraction.xlsx"
Ejemplo
curl -X POST "https://freeocr.ai/api/v1/platform/extract?fields=name&fields=date&fields=amount" \
-H "Authorization: Bearer focr_your_key" \
-F "image=@invoice.png"Respuestas de error
No autorizado
{ "error": { "code": "unauthorized", "message": "Clave de API inválida" } }Saldo insuficiente
{ "error": { "code": "insufficient_credits", "message": "Saldo insuficiente. Por favor, recargue." } }Límite de velocidad excedido
{ "error": { "code": "rate_limit_exceeded", "message": "Límite de velocidad excedido. Inténtelo más tarde." } }Error interno
{ "error": { "code": "internal_error", "message": "Error al procesar la imagen" } }