Perfiles de estilo

Los perfiles de estilo son la huella de estilo de escritura de tu marca, guardada como rasgos estructurados (tono, formalidad, longitud de frase, vocabulario, estructura). Hay dos formas de crear un perfil: pegar texto o subir un archivo directamente, o indicar un dominio que el sistema rastrea para deducir el estilo. Un perfil terminado se selecciona al generar un artículo y se incorpora al prompt de redacción como instrucción — así cada artículo se mantiene coherente en el tono, sin importar quién o qué lo generó.

Qué permite

• Perfil a partir de texto/archivo — pega texto o sube un TXT/Markdown/DOCX/PDF; la IA analiza tono, formalidad, longitud de frase, vocabulario y estructura.
• Perfil a partir de una web — indica un dominio, el sistema rastrea el sitemap (con un rastreo de la portada como respaldo) y analiza varias subpáginas ricas en contenido.
• Revisión antes de activar — los perfiles aprendidos de una URL pasan por un paso de revisión antes de usarse realmente.
• Perfil predeterminado — marca un perfil por equipo como predeterminado (en la interfaz bajo /style-profiles).
• Reutilizable entre módulos — el mismo perfil se puede seleccionar para artículos individuales, el editor de artículos, Storylines y Autopilot.

Cuándo usarlo

• Varios autores o artículos generados por IA deben leerse como si vinieran de la misma persona.
• Quieres adoptar el estilo de una web existente sin describirlo a mano.
• Un cliente o marca tiene un tono claramente reconocible que debe mantenerse en muchos artículos.
• Estás construyendo un flujo automatizado (Autopilot, generación masiva) donde nadie revisa manualmente el estilo de cada artículo.

Workflow

1. Ver perfiles existentes — GET /projects/{project}/style-profiles lista todos los perfiles del proyecto.
2. Crear a partir de texto/archivo — actualmente se hace desde la interfaz en /style-profiles: pega texto o sube un archivo, el análisis corre de forma asíncrona en segundo plano (10 créditos), después status: ready.
3. Crear a partir de una URL — POST /projects/{project}/style-profiles/from-url con {source_url, name?}. Primero se comprueba si hay créditos suficientes (si no, 402); con créditos suficientes el análisis arranca de forma asíncrona, respuesta 202 con {id, status: 'pending', source_url, message}.
4. Consultar el estado — GET /style-profiles/{id}/scrape-status devuelve status, scraped_pages, failure_reason y pending_review para hacer polling.
5. Revisar el resultado — cuando el análisis de la URL termina (pending_review: true), puedes hacer POST /style-profiles/{id}/accept (conservarlo) o POST /style-profiles/{id}/discard (descartarlo — solo funciona mientras pending_review siga siendo true).
6. Crear un perfil directamente — POST /projects/{project}/style-profiles crea un perfil de forma síncrona con datos de estilo que ya tienes ({name, description?, style_data?}), por ejemplo para tu propia integración que calculó el estilo por su cuenta. Sin cobro de créditos.
7. Usarlo — al iniciar un artículo (artículo individual, editor de artículos, Storylines, Autopilot), elige un perfil con status: ready; el estilo se incorpora automáticamente al prompt de redacción.

API

Ejemplo de inicio de un análisis de URL:

POST /v1/projects/42/style-profiles/from-url
{"source_url": "https://example.com", "name": "Estilo de example.com"}

Créditos y límites

• Aprender desde una URL cuesta 25 créditos — se cobran solo cuando el job termina con éxito, no al iniciarlo. Si el análisis falla antes de que se hayan analizado con éxito suficientes páginas (al menos 5), se cobran 0 créditos.
• Aprender desde texto/archivo (por la interfaz) cuesta 10 créditos.
• Crear directamente vía la API con datos de estilo que ya tienes, así como listar, actualizar, eliminar y accept/discard, no tienen coste.
• El análisis de URL corre de forma asíncrona y puede tardar de 2 a 4 minutos; sigue el progreso haciendo polling sobre scrape-status.

Módulos relacionados

• Storylines — los artículos de storyline se pueden generar con el mismo perfil de estilo que los artículos individuales.
• Automation — Autopilot también usa un perfil de estilo guardado al generar artículos automáticamente.
• AI Content Editor — el editor de artículos permite elegir un perfil de estilo para reescrituras.