v1REST API

Documentacion de la API

Integra el humanizador de IA de Antomica en tu aplicacion. Una sola llamada POST, respuesta en menos de 2 segundos, disponible desde el plan Basico.

Estado: OperativoPOST /api/v1/humanize6 idiomas

Autenticacion

Todas las solicitudes requieren un header Authorization con tu API key. Las claves empiezan siempre por ant_.

¿Donde encontrar tu API key?

Ve a tu dashboard, abre la seccion de API Keys y genera una nueva clave. Solo se muestra una vez al crearla, guardala en un lugar seguro.

bash
Authorization: Bearer ant_xxxxxxxxxxxxxxxxxxxx

Endpoint

Un unico endpoint para humanizar texto.

POSThttps://antomica.com/api/v1/humanize

Parametros del body (JSON)

CampoTipoRequeridoDescripcion
textstringSiTexto a humanizar. Minimo 10 caracteres. Limite segun plan.
tonestringNoTono del resultado. Valores: "casual" (defecto), "academic", "professional".
languagestringNoIdioma del texto. Valores: "es" (defecto), "en", "pt", "fr", "it", "de".

Ejemplos de uso

Llamada de ejemplo con cURL, Python y JavaScript.

cURL

bash
curl -X POST https://antomica.com/api/v1/humanize \
  -H "Authorization: Bearer ant_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "La inteligencia artificial ha experimentado un crecimiento exponencial en los ultimos años, transformando multiples sectores de la sociedad.",
    "tone": "academic",
    "language": "es"
  }'

Python

python
import requests

api_key = "ant_xxxxxxxxxxxxxxxxxxxx"
url = "https://antomica.com/api/v1/humanize"

response = requests.post(url,
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={
        "text": "Tu texto generado por IA aqui...",
        "tone": "casual",
        "language": "es"
    }
)

data = response.json()
print(data["result"])
print(f"Procesado en {data['meta']['processing_ms']}ms")

JavaScript / TypeScript

javascript
const response = await fetch("https://antomica.com/api/v1/humanize", {
  method: "POST",
  headers: {
    "Authorization": "Bearer ant_xxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    text: "Tu texto generado por IA aqui...",
    tone: "professional",
    language: "es"
  })
})

const data = await response.json()
console.log(data.result)

Respuesta exitosa (200)

La respuesta devuelve el texto humanizado y metadatos del procesamiento.

json
{
  "result": "La IA ha crecido mucho en los ultimos años. Es algo que ya no sorprende a nadie, pero si te paras a pensarlo, el alcance real de ese cambio es enorme. Educacion, sanidad, empresa: ningun sector se ha quedado fuera.",
  "meta": {
    "tone": "academic",
    "language": "es",
    "input_words": 24,
    "output_words": 42,
    "input_tokens": 87,
    "output_tokens": 112,
    "total_tokens": 199,
    "processing_ms": 1243
  }
}

Campos de la respuesta

CampoTipoDescripcion
resultstringTexto humanizado listo para usar.
meta.tonestringTono aplicado al texto.
meta.languagestringIdioma del texto procesado.
meta.input_wordsnumberPalabras del texto original.
meta.output_wordsnumberPalabras del texto humanizado.
meta.processing_msnumberTiempo de procesamiento en milisegundos.

Errores

La API devuelve errores en formato JSON con un campo error.

CodigoCausaSolucion
400JSON invalido o campo text muy cortoRevisa el body. El campo text necesita al menos 10 caracteres.
401API key ausente o invalidaIncluye el header Authorization: Bearer ant_... con tu clave.
402Texto supera el limite de caracteres del planDivide el texto en fragmentos mas pequeños o actualiza tu plan.
403Plan gratuito - API no incluidaActualiza al plan Basico o superior en antomica.com/precios.
429Mas de 6 solicitudes en 30 segundosReduce la frecuencia de llamadas. El rate limit se restablece automaticamente.

Limites por plan

El uso de la API descuenta del mismo cupo mensual de palabras que el uso desde la web.

Basico

6,99 €/mes

  • 7.500 palabras/mes
  • Rate limit: 6 req / 30 s
  • 6 idiomas disponibles

Premium

23,99 €/mes

  • 25.000 palabras/mes
  • Rate limit: 6 req / 30 s
  • 6 idiomas disponibles

Pro

38,99 €/mes

  • 50.000 palabras/mes
  • Rate limit: 6 req / 30 s
  • 6 idiomas disponibles

Preguntas frecuentes

¿Como consigo mi API key?

Ve a tu dashboard, abre el menu de API Keys y genera una nueva clave. Las API keys empiezan siempre por ant_ y son permanentes hasta que las revoques tu mismo.

¿En que planes esta disponible la API?

La API REST esta disponible en todos los planes de pago: Basico, Premium y Pro. El plan gratuito no incluye acceso a la API.

¿Cuanto tarda en responder la API?

El tiempo de procesamiento tipico es inferior a 2 segundos para textos de hasta 500 palabras. El campo processing_ms en la respuesta indica el tiempo exacto de cada llamada.

¿La API consume el mismo cupo de palabras que el uso web?

Si. El uso de la API descuenta del mismo cupo mensual de palabras de tu plan. No hay un cupo separado para la API.

Empieza a integrar ahora

Activa tu API key desde el dashboard. Disponible desde el plan Basico.