API

Construye con las herramientas de NOXUS.

Usa una API key, saldo API USD prepago, endpoints predecibles y las mismas herramientas reales del catalogo web.

Panel de desarrolladores Ver endpoints
api.noxus.lat
v1
curl -X POST https://noxus.lat/api/v1/tools/qr \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"https://noxus.lat","output_format":"png"}'

Autenticacion

Bearer token

Crea una app y una API key desde tu panel de desarrolladores. Envia la key en cada solicitud.

Authorization: Bearer TU_API_KEY

Billing

USD API separado

Los endpoints validan saldo antes de procesar y cobran solo despues de generar el resultado correctamente.

{
  "billing": {
    "currency": "USD",
    "estimated_usd": "0.002",
    "charged_usd": "0.002",
    "balance_after_usd": "9.998"
  }
}

Errores

Respuestas consistentes

Sin API key devuelve 401, saldo API insuficiente devuelve 402 y limites excedidos devuelve 413.

{
  "success": false,
  "error": "Saldo API insuficiente.",
  "error_code": "insufficient_api_balance",
  "request_id": "req_...",
  "billing": {"charged_usd": "0"}
}

Inicio rapido

Primeras llamadas API

Usa estos endpoints antes de procesar archivos: uno confirma que la key funciona y el otro muestra el saldo API USD prepago.

POST

/api/v1/ping

Valida la API key y devuelve 200 cuando la conexion esta lista.

curl -X POST https://noxus.lat/api/v1/ping \
  -H "Authorization: Bearer TU_API_KEY"
{
  "success": true,
  "status": "ok",
  "request_id": "req_...",
  "api_key": {"key_hint": "noxus_test_...", "environment": "test"},
  "account": {"tier": "free", "status": "active"}
}

GET

/api/v1/balance

Consulta el saldo API USD. No mueve creditos ni crea jobs.

curl https://noxus.lat/api/v1/balance \
  -H "Authorization: Bearer TU_API_KEY"
{
  "success": true,
  "balance": {
    "currency": "USD",
    "balance_usd": "10",
    "available_usd": "10",
    "lifetime_spent_usd": "0"
  }
}

v1

Contrato de produccion

La API usa scopes, rate limits por key, logs de uso e Idempotency-Key para que tus integraciones puedan reintentar sin cobros duplicados.

Scopes

tools:run

Las keys pueden limitarse a herramientas especificas. Las keys nuevas ejecutan el catalogo activo por defecto.

{
  "scopes": ["tools:run"],
  "tools": ["crear-qr", "convertir-formato-imagen"]
}

Rate limit

Por key y tier

Las keys free inician con 60 jobs API correctos por hora. Tiers superiores pueden configurarse desde la cuenta developer.

{
  "error_code": "rate_limit_exceeded",
  "limit": {"limit": 60, "window_seconds": 3600}
}

Idempotency-Key

Reintentos seguros

Envia la misma key al reintentar una solicitud. NOXUS devuelve la respuesta del job original en vez de cobrar otra vez.

Idempotency-Key: qr-2026-05-25-001

Flujos

Las herramientas pesadas son one-shot en API v1

La web puede mostrar un editor con pasos intermedios. La API publica v1 recibe la intencion final y NOXUS ejecuta el pipeline interno en una sola solicitud.

Script to video

Idea o guion

Envia idea cuando quieres que NOXUS escriba el guion. Envia script cuando tu app ya lo tiene. La respuesta incluye guion, escenas, segmentos y el video renderizado.

POST /api/v1/tools/script-to-video
idea=Un video sobre vender mas con automatizacion

POST /api/v1/tools/script-to-video
script=Hook: deja de perder leads...

Subtitles

Sube video

NOXUS transcribe, crea segmentos editables internamente, renderiza el estilo elegido y devuelve transcript mas segmentos para tu registro.

POST /api/v1/tools/auto-subtitles
video=@clip.mp4
language=es
style=yellow_punch

AI video

Prompt y referencias

Envia el prompt directamente, mas referencias opcionales de imagen, video o audio. La respuesta devuelve los estimados de cobro dinamico.

POST /api/v1/tools/ai-video-generate
prompt=Anuncio vertical de cafe
first_frame_image=@inicio.jpg
duration=8

Guia

Como funcionan las solicitudes

Todas las herramientas mantienen el mismo contrato: validar auth, validar limites, validar saldo, procesar archivo y cobrar solo si el resultado fue correcto.

Archivos

multipart/form-data

Recomendado para navegador, apps moviles, backends y cargas por lote.

curl -X POST https://noxus.lat/api/v1/tools/image-convert \
  -H "Authorization: Bearer TU_API_KEY" \
  -F "image=@foto.png" \
  -F "output_format=webp" \
  -F "filename=mi-imagen"

JSON

base64

Util cuando tu integracion ya maneja archivos en base64 o envia trabajos desde colas.

{
  "filename": "foto.png",
  "content_base64": "...",
  "output_format": "webp"
}

Respuesta

Estructura estable

Las llamadas correctas incluyen metadata del resultado, detalles de cobro y job_id para historial.

{
  "success": true,
  "tool": "image-convert",
  "job_id": 42,
  "billing": {
    "estimated_usd": "0.002",
    "charged_usd": "0.002",
    "balance_after_usd": "9.998"
  },
  "output": {
    "filename": "mi-imagen.webp",
    "mime_type": "image/webp",
    "content_base64": "..."
  }
}

Endpoints

Herramientas disponibles por API

Esta lista se genera desde el catalogo activo. Las herramientas dinamicas muestran precio desde porque el cobro final depende de duracion, archivos, escenas, resolucion o trabajo del proveedor.

POST Cargando

Cargando herramientas API...

El catalogo de endpoints se carga en segundo plano para abrir la documentacion mas rapido.

1

Crea una app

Las apps agrupan tus API keys y futuros limites de uso.

2

Recarga USD API

Los creditos API viven separados de los NOX web y de los planes web.

3

Ejecuta herramientas

Las respuestas devuelven job_id, billing y metadata del resultado.