Skip to main content
Documentación de API

Uso y facturación

Consulta los precios de la API OCR, las reservas de saldo, los límites de solicitudes y la conservación del contenido.

Estas reglas se aplican a Imagen a texto e Imagen a tabla. Consulta las entradas, formatos y errores específicos en la referencia de cada API.

Precios

Cada imagen correcta cuesta $0.002 e incluye 2,000 tokens de entrada y 2,000 de salida independientes. Exceso de entrada: $0.30 por millón; de salida: $1.20 por millón. Solo se cobra el exceso de cada cuota. Los importes son cadenas USD con 9 decimales; no redondees a céntimos al registrar cargos.

Ejemplos de facturación

Tokens de entradaTokens de salidaCargo (USD)
100100$0.002000000
2,0004,000$0.004400000
2,001100$0.002000300

Saldo y reserva

Cada nueva ejecución requiere y reserva $0.011288000 de saldo disponible. Tras el éxito se cobra el uso real y se libera el resto. Los fallos confirmados no se cobran, aunque la recuperación puede mantener fondos reservados temporalmente. Una respuesta perdida puede estar cobrada: compruébalo reintentando con el mismo ID.

Un saldo de $0.002 no cubre la reserva requerida.

Límites de solicitudes

Imágenes y carga

LímiteValor
Formatos admitidosPNG / JPEG / WebP (un fotograma estático; MIME debe coincidir con los bytes)
Tamaño máximo de imagen10,000,000 bytes (10 MB)
Cuerpo multipart máximo10,065,536 bytes
Longitud máxima por lado16,384 píxeles
Área máxima25,000,000 píxeles
Relación de aspecto máxima20

Tokens, tiempo y frecuencia

LímiteValor
Tokens de entrada máximos8,192 tokens
Tokens de salida máximos8,192 tokens
Tiempo de procesamiento120 segundos
Intentos válidos por clave / minuto UTC30
Intentos válidos por cuenta / minuto UTC60
Ejecuciones simultáneas por cuenta2

La entrada incluye la imagen y las instrucciones del servicio. El minuto UTC fijo cuenta los reintentos y las reproducciones entre los intentos válidos. Todas las claves comparten los límites de la cuenta.

Conservación del contenido

No se guardan imágenes originales ni se añade contenido API al historial web. El texto se conserva para reintentos durante 24 horas desde la aceptación; después es inaccesible y se elimina mediante limpieza, o al borrar la cuenta. Los metadatos contables y de uso se conservan aparte para conciliación. Guarda el texto en tu sistema si lo necesitas después.