Logo de la API de APISDOM Studio

STUDIO API para Developers

Motor de generación multicapa de APISDOM: búsqueda web adaptativa, citaciones verificadas y SEO estructurado. Intégralo en tu CMS, blog o app. No es un wrapper — es tecnología propietaria.

Tecnología multicapa APISDOM

La API de Studio no es un simple proxy a Claude. Es un motor propietario con más de 15 capas internas entre frontend y backend. Estas son las más destacadas:

1Búsqueda web adaptativa — árbol de decisión de 5 niveles que determina cuándo, cuánto y si buscar según topic, tipo de contenido y referencias temporales
2Structured Outputs con constrained decoding — el esquema JSON se construye dinámicamente por petición; es físicamente imposible que el modelo omita campos requeridos
3Prompts SKILL versionados — cadena jerárquica: SKILL.md → perfil de marca → instrucciones custom, con caché LRU por rendimiento
4Citaciones verificadas con deduplicación — citaciones nativas de Anthropic fusionadas con fuentes JSON, deduplicadas y puntuadas por relevancia
5Validación post-generación — verifica que TODOS los campos solicitados existan con contenido real; marca resultados parciales automáticamente
6Streaming progresivo en 8 fases — SSE con entrega incremental por sección, estado en tiempo real durante todo el proceso de generación
7Perfiles de marca persistentes — tono, estilo e instrucciones custom por proyecto, inyectados automáticamente en cada contexto de generación
8Fallback inteligente multinivel — detección de rate limit → retry automático con Haiku + override de modelo de emergencia vía admin

…y más de 7 capas adicionales entre autenticación SHA-256, rate limiting configurable, logging de auditoría y SEO estructurado automático.


Inicio rápido

1
Registra tu cuenta de developer
2
Obtén tu API Key
3
Compra créditos
4
Llama al endpoint

Ejemplos de código

curl -X POST https://studio.apisdom.com/api/v1/generate \
  -H "Authorization: Bearer sk_studio_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic": "SEO trends 2026", "language": "es"}'

Autenticación

Todas las peticiones requieren tu API Key en el header Authorization.

Authorization: Bearer sk_studio_tu_api_key

Documentación API

POST /api/v1/generate

Genera contenido SEO optimizado

POST /api/v1/adapt

Adapta contenido a redes sociales

GET /api/v1/platforms

Lista plataformas disponibles con límites

GET /api/v1/credits

Consulta el saldo de créditos del usuario

GET /api/v1/usage

Resumen de uso por periodo (day, week, month)

Parámetros

topicTema del contenido (obligatorio)
languageIdioma: es o en
contentTypeTipo: article, blog_post, tutorial, newsletter, social_post, product_description, documentation, landing_page, case_study, comparison, listicle, faq, how_to, opinion
lengthLongitud: short, medium, long, extra_long
toneTono: professional, casual, academic, conversational, persuasive, technical, journalistic, educational, inspirational, authoritative
outputFormatFormato: html, markdown, plain_text

Estructura de respuesta

Cada generación devuelve un objeto JSON completo con contenido, metadatos SEO, fuentes verificadas y métricas de uso.

{
  "id": "cnt_a1b2c3d4e5f6",
  "created_at": "2026-01-15T10:30:00Z",
  "status": "completed",
  "language": "es",
  "content_type": "blog_post",
  "content": {
    "format": "html",
    "body": "<h1>SEO Trends 2026</h1><p>..."
  },
  "length_words": 1200,
  "meta_seo": {
    "title": "SEO Trends 2026",
    "description": "Discover the top...",
    "slug": "seo-trends-2026",
    "og_title": "SEO Trends 2026",
    "og_description": "..."
  },
  "sections": [
    { "title": "Introduction", "body": "..." }
  ],
  "sources": [
    {
      "title": "Google Blog",
      "url": "https://...",
      "snippet": "...",
      "relevance": 0.95
    }
  ],
  "usage": {
    "input_tokens": 1250,
    "output_tokens": 3400,
    "web_searches": 8,
    "model": "claude-sonnet-4-5-20250929"
  }
}
idIdentificador único de la generación
created_atFecha ISO 8601 de creación
statusEstado: completed, failed o partial
content.formatFormato solicitado (html, markdown, plain_text)
content.bodyContenido generado completo (HTML, Markdown o texto plano)
length_wordsNúmero de palabras del contenido
meta_seoMetadatos SEO: title, description, slug, og_title, og_description (si include_meta_seo=true)
summaryResumen del contenido (si include_summary=true)
table_of_contentsTabla de contenidos con id y title por sección (si include_table_of_contents=true)
sectionsSecciones estructuradas del contenido con title y body
qaPreguntas y respuestas relacionadas (si include_qa=true)
sourcesFuentes citadas con title, url, snippet y relevance (si include_sources=true)
code_blocksBloques de código con language, code y description (si include_code=true)
usageMétricas: input_tokens, output_tokens, web_searches, model

Rate Limiting

La API incluye headers de rate limiting en TODAS las respuestas para que puedas monitorizar tu consumo.

X-RateLimit-LimitMáximo de peticiones por ventana de tiempo
X-RateLimit-RemainingPeticiones restantes en la ventana actual
Retry-AfterSegundos a esperar antes de reintentar (solo en 429)

Límite por defecto: 30 peticiones/minuto por API Key. El sistema aplica el menor entre el límite de la key y el máximo global (30 req/min).

Sistema de créditos

Cada generación consume créditos según el tipo y longitud del contenido. Las adaptaciones cuestan 1-2 créditos según el número de plataformas.

Coste por tipo de contenido

social_post, product_description → 1 crédito

blog_post (short/medium) → 2 créditos

article (medium), newsletter, documentation, landing_page → 3 créditos

tutorial → 4 créditos

article (long/extra_long), comparison, case_study → 5 créditos

Adaptación (1-3 plataformas) → 1 crédito

Adaptación (4-7 plataformas) → 2 créditos

X-Credits-Used

Créditos consumidos en esta petición (header X-Credits-Used)

Si no tienes créditos suficientes, recibirás un 402.

Códigos de error

400 — Parámetros inválidos o topic vacío

401 — API Key inválida o ausente

402 — Créditos insuficientes

422 — Parámetros incompatibles (ej: include_code sin code_language)

429 — Rate limit excedido (ver header Retry-After)

500 — Error interno del servidor

502 — Fallo en la generación de contenido

Idempotencia y duplicados

Cada generación produce un ID único (cnt_xxxx). Si tu petición falla por timeout de red, verifica el campo id en la respuesta antes de reintentar para evitar cobros duplicados.

Las compras de créditos utilizan tokens de idempotencia de Stripe para garantizar que no se procese el mismo pago dos veces.


Preguntas frecuentes de integración


APIs complementarias

Si generas contenido con Studio, estas APIs pueden complementar tu pipeline: moderar comentarios de lectores, analizar el sentimiento de las respuestas, predecir tendencias de tráfico o recomendar artículos relacionados automáticamente.

Ejemplo real: viral.apisdom.com usa la Prediction API para ofrecer forecasting de series temporales en producción. viral.apisdom.com

Documentación técnica completa con ejemplos en 5 lenguajes: apisdom.com/documentacion


Pricing API

Mismos packs que el panel web. 1 generación = 1-5 créditos según tipo y longitud.

Ver packs de créditos