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:
…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
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_keyDocumentación API
POST /api/v1/generateGenera contenido SEO optimizado
POST /api/v1/adaptAdapta contenido a redes sociales
GET /api/v1/platformsLista plataformas disponibles con límites
GET /api/v1/creditsConsulta el saldo de créditos del usuario
GET /api/v1/usageResumen de uso por periodo (day, week, month)
Parámetros
topicTema del contenido (obligatorio)languageIdioma: es o encontentTypeTipo: article, blog_post, tutorial, newsletter, social_post, product_description, documentation, landing_page, case_study, comparison, listicle, faq, how_to, opinionlengthLongitud: short, medium, long, extra_longtoneTono: professional, casual, academic, conversational, persuasive, technical, journalistic, educational, inspirational, authoritativeoutputFormatFormato: html, markdown, plain_textEstructura 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óncreated_atFecha ISO 8601 de creaciónstatusEstado: completed, failed o partialcontent.formatFormato solicitado (html, markdown, plain_text)content.bodyContenido generado completo (HTML, Markdown o texto plano)length_wordsNúmero de palabras del contenidometa_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 bodyqaPreguntas 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, modelRate 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 tiempoX-RateLimit-RemainingPeticiones restantes en la ventana actualRetry-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-UsedCré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.
Sentiment API (DistilBERT)
Analiza reacciones a tus publicaciones. Combina con Studio para medir impacto del contenido generado.
Moderation API (Toxic-BERT)
Filtra comentarios tóxicos en tu blog o CMS. Útil si publicas contenido con sección de comentarios.
Prediction API (Chronos-2)
Predice tráfico o demanda de contenido por fecha. Ayuda a planificar cuándo publicar.
Recommendations API (MiniLM)
Sugiere artículos similares por similitud semántica. Ideal para secciones ‘relacionados’.
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.