# ApisDom

> Plataforma de APIs de inteligencia artificial listas para producción, creada por Juanlu (ApisDom). Cuatro APIs REST en español, cada una respaldada por un modelo de IA de código abierto o de un proveedor establecido, con validación estricta de la entrada, autenticación por API Key y planes con créditos.

Todas las APIs se llaman por HTTPS con el método POST sobre `https://apisdom.com/api/v1/{servicio}`, enviando la cabecera `X-API-Key` (formato `sk_user_` seguido de 32 caracteres) y un cuerpo JSON. Servicios disponibles: `sentiment`, `moderacion`, `recomendaciones`, `predictions`. Cada llamada correcta consume 1 crédito de la bolsa del servicio (texto, recomendación o predicción); las bolsas son independientes y no se transfieren entre sí. La respuesta correcta envuelve el resultado del modelo con metadatos del proveedor y un `request_id`.

Las peticiones inválidas se rechazan sin consumir crédito. Códigos de error: 400 (JSON mal formado), 401 (API Key ausente o inválida), 402 (créditos agotados), 422 (datos inválidos o fuera de rango), 429 (límite por minuto o límite diario excedido), 500 (error interno). Límite de velocidad: 10 peticiones por minuto en el plan gratuito (máximo 25 llamadas al día), 60 por minuto en Starter y Tienda, y 300 por minuto en Pro y Marketplace.

## Documentación

- [Documentación oficial de las APIs](https://apisdom.com/documentacion): Guía completa con autenticación por API Key, endpoints, límites de velocidad, códigos de error HTTP y ejemplos de código para las cuatro APIs.
- [Planes y precios](https://apisdom.com/pricing): Créditos por plan, velocidad en peticiones por minuto, límite diario del plan gratuito y retención del historial de uso.

## APIs

- [Análisis de sentimiento](https://apisdom.com/documentacion#api-texto): Clasifica un texto como positivo, negativo o neutro y devuelve una puntuación de confianza de 0 a 1, con el modelo DistilBERT (SST-2). Entrada: campo `text` de 1 a 5.000 caracteres. Servicio `sentiment`, bolsa de créditos de texto.
- [Moderación de contenido](https://apisdom.com/documentacion#api-texto): Detecta contenido tóxico en un texto y devuelve una puntuación de toxicidad desglosada en 6 categorías, con el modelo Toxic-BERT. Entrada: campo `text` de 1 a 5.000 caracteres. Servicio `moderacion`, bolsa de créditos de texto.
- [Recomendaciones](https://apisdom.com/documentacion#api-ventas): Ordena una lista de contenidos por similitud semántica respecto a una consulta y devuelve los elementos con su puntuación de relevancia, con el modelo all-MiniLM-L6-v2. Servicio `recomendaciones`, bolsa de créditos de recomendación.
- [Predicción de series temporales](https://apisdom.com/documentacion#api-ventas): Predice valores futuros a partir de un histórico y devuelve el pronóstico con intervalos de confianza del 90%, con el modelo Chronos-2 (Amazon Science). Entrada: arrays `dates` (fechas YYYY-MM-DD) y `values` (valores numéricos), mínimo 10 puntos cada uno; horizonte configurable de 1 a 365 días. Servicio `predictions`, bolsa de créditos de predicción.

## Referencia interactiva (Swagger / OpenAPI)

- [Referencia de la API de Sentimiento](https://sentiment.apisdom.com/docs): Especificación OpenAPI interactiva del servicio de análisis de sentimiento.
- [Referencia de la API de Moderación](https://moderation.apisdom.com/docs): Especificación OpenAPI interactiva del servicio de moderación de contenido.
- [Referencia de la API de Predicción](https://prediction.apisdom.com/docs): Especificación OpenAPI interactiva del servicio de predicción de series temporales.
- [Referencia de la API de Recomendaciones](https://api.apisdom.com/docs): Especificación OpenAPI interactiva del servicio de recomendaciones.

## Otras APIs de ApisDom

ApisDom ofrece además 2 APIs de generación de contenido y voz en studio.apisdom.com, una plataforma independiente con su propia suscripción y su propia autenticación.

- [APIs de Studio](https://apisdom.com/documentacion#studio-api): Documentación de las APIs de generación de contenido y voz de studio.apisdom.com dentro de ApisDom.

## Plataforma

- [Inicio](https://apisdom.com/): Plataforma de APIs de IA y servicios de arquitectura de software de Juanlu (ApisDom).
- [Servicios de desarrollo](https://apisdom.com/servicios): Desarrollo backend, arquitectura cloud, consultoría técnica e integración de APIs de IA.
- [Proyectos](https://apisdom.com/proyectos): Portafolio de proyectos del ecosistema ApisDom.
- [Blog](https://apisdom.com/blog): Artículos técnicos sobre inteligencia artificial, APIs, desarrollo web y buenas prácticas.

## Optional

- [Aviso legal, privacidad y términos](https://apisdom.com/legal): Términos de uso, política de privacidad y condiciones del servicio.