> ## Documentation Index > Fetch the complete documentation index at: https://docs.doconda.com/llms.txt > Use this file to discover all available pages before exploring further. # Crear > Un documento nuevo desde una frase, desde tu Markdown o usando tus ficheros. `operation: "create"` es la operación por defecto. Necesita **uno** de `prompt` o `content`, y opcionalmente `format`: `docx` (Word + PDF), `pdf` (solo el PDF), `pptx` (PowerPoint + PDF), `xlsx` (Excel + PDF) o `artifact` (una página web con sus datos, ver [artifacts](/es/guides/artifacts)). Si no lo pones, Doconda lo deduce de tu `prompt`. ```json theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} { "format": "docx", "content": { "markdown": "# Solicitud de vacaciones\n\nEstimada Sra. García: ..." }, "style": "títulos azules" } ``` El Markdown admite títulos, párrafos, listas, tablas, negrita/cursiva, enlaces, saltos de página e [imágenes](#imágenes). El texto se usa tal cual. ```json theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} { "format": "docx", "prompt": "Reporte de la ley de vivienda con títulos azules y centrado" } ``` Doconda escribe el contenido y aplica el estilo que pidas en la misma frase. ```json theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} { "format": "pdf", "prompt": "Resume esto en 2 páginas", "sources": ["file_01JAB3..."] } ``` Sube antes los ficheros con [`POST /files`](/es/api-reference/introduction), o usa un documento que ya hizo Doconda por su id (`doc_…`). En `sources` van tus documentos (Word, PowerPoint, Excel, PDF, también `.doc`, `.ppt` y `.xls`, TXT, Markdown o HTML, hasta 5, solo con `prompt`) y tus [imágenes](#imágenes) (hasta 10), juntos. [Otras formas de pasar ficheros](/es/guides/extract#cuatro-formas-de-pasar-un-fichero). ## Qué recibes Un archivo editable de verdad: textos, tablas, gráficos y fórmulas, no imágenes. El aspecto va en los estilos del documento (en Word, Normal, Título 1…), así lo que añadas después sigue el mismo diseño. Con cada archivo llegan su PDF, las vistas de sus páginas y un [informe](#avisos-del-informe). * **Word y PDF**: la maquetación se adapta a la clase de documento (un contrato, con cláusulas numeradas; una carta, sin números de página). * **PowerPoint**: 16:9, con gráficos nativos y un tema que siguen las diapositivas que añadas. * **Excel**: fórmulas reales (no números copiados), con los supuestos en sus propias celdas y sin errores de cálculo. ## Niveles de calidad Con `quality` eliges cuánto trabajo se pone en el archivo. Cada nivel tiene su precio ([precios](/es/guides/account#precios)). | `quality` | Para qué | Tiempo | | - | - | - | | `fast` | Borradores y documentos sencillos. Estilo básico: fuente, tamaño, colores, alineación, márgenes, portada, índice, cabecera y pie | Segundos | | `standard` | La mayoría de documentos. Cualquier estilo, también tu plantilla o el diseño de un archivo, gráficos y control de cambios | Minutos | | `best` | Documentos importantes: más revisión y más cuidado del diseño | Minutos, más que `standard` | | `auto` (por defecto) | Doconda elige el nivel (ver abajo) | | * Con `auto`: desde una frase (`prompt`), el nivel que necesita tu petición; ante la duda, el más barato. Desde tu Markdown (`content`, sin `prompt`), siempre `standard`. Y `best` si copias el diseño de un archivo (salvo una plantilla de PowerPoint para una presentación), si con documentos en `sources` mencionas una plantilla, o si una edición pide comentarios o control de cambios. * Con `auto`, `max_quality` pone un tope: `"max_quality": "standard"` no pasa nunca de estándar. * El documento dice qué nivel se usó y por qué en `quality` (`requested`, `level`, `reason`). * En `fast`, lo que no cabe en el estilo básico vuelve en `style_unsupported`. * Si un documento en `best` no se puede terminar a ese nivel, se entrega en `standard`, se avisa (`agent.fallback`) y se cobra como `standard`. * En `standard` y `best` un documento suele tardar más de 120 s: en [modo directo](/es/guides/modes) la llamada responde entonces `202` con el documento aún en marcha, y lo sigues con `GET /documents/{id}`. El `create()` de los SDK sigue esperando por ti. ## Imágenes Word, PowerPoint y Excel pueden llevar imágenes: ```json theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} { "format": "docx", "prompt": "Informe de la reforma de la oficina con las fotos", "sources": ["file_presupuesto.pdf...", "file_foto1.jpg...", "file_foto2.jpg..."] } ``` * **Tuyas**: súbelas con [`POST /files`](/es/api-reference/introduction) (PNG, JPEG, GIF o WebP) y pásalas en `sources`, junto a tus documentos (hasta 10 imágenes). Los documentos se usan como material y las imágenes van dentro, donde encajan. * **Con tu propio Markdown**: apúntalas en su propia línea con `![Pie de foto](img:1)` (`img:1` es la primera imagen de `sources`, `img:2` la segunda…), o con un enlace `![Pie de foto](https://…)`. * **De internet**: al crear desde una frase, si el documento lo necesita (datos actuales, un catálogo, un destino), Doconda busca información y fotos reales. * Las imágenes que no son tuyas llevan la fuente en el pie y el aviso `image.web_source`, para que compruebes que puedes usarlas. Si una imagen no se puede poner, el documento sale igual y el informe lo dice (`image.unavailable`). ## Copiar el diseño de un archivo Pasa en `sources` el archivo cuyo aspecto quieres copiar (una presentación, un Word, un Excel, un PDF, una página web en HTML o una imagen PNG, JPEG o WebP; del HTML se copian sus fuentes, colores y tamaños tal como se ven, con su CSS) y dilo en la petición (`prompt`): «con el diseño de nuestra plantilla». El resto de fuentes siguen siendo material para el contenido. * Una presentación se usa como plantilla: el resultado parte de sus diapositivas. * Cualquier otro archivo: se copian sus fuentes, colores, márgenes, cabecera y pie, logo y portada. * En `standard` y `best`. En `fast` el documento sale con un diseño propio y el informe lo avisa (`design.not_copied`). Con `auto`, copiar el diseño de un archivo que no sea una plantilla de PowerPoint para una presentación elige `best`. * El evento `design.chosen` dice qué archivo se usó. ## Opciones Un nombre para encontrarlo después («Contrato piso Malasaña», hasta 200 caracteres). Vale también para revisar y editar (no para [leer](/es/guides/extract)). Los ficheros se descargan con ese nombre (`Contrato piso Malasana.docx`). Clave-valor tuyo (cada valor hasta 500 caracteres), se devuelve tal cual. Usa `?dry_run=true` para validar la petición (campos, operación y ficheros) sin generar nada. No comprueba el estilo (se lee al hacer el documento: lo que no se pueda hacer vuelve entonces en `style_unsupported`) ni el saldo. ## Avisos del informe Cuando Doconda escribe el contenido, comprueba lo que entrega y te avisa en el informe de lo que conviene revisar: | Código | Qué significa | | - | - | | `content.unsupported_fact` | Una cifra, fecha o dato que no está en tu petición ni en tus fuentes | | `content.unsupported_data` | Muchas cifras que no están en tu petición ni en tus fuentes: parecen inventadas | | `content.unsupported_citation` · `content.citation_to_review` | Una cita legal (artículo, ley, sentencia) que no viene de tus fuentes | | `content.unclear` · `content.contradiction` | Algo que un lector no encontraría en el texto, o que se contradice (`standard` y `best`) | | `source.instructions` | Una fuente intentaba dar órdenes; se ha ignorado | | `source.selected` | Tus fuentes eran muy largas y se ha usado la parte que trata de lo que pides | | `request.review` | La petición podría usarse para engañar a alguien; revísala | | `content.truncated` | El texto era demasiado largo y se ha cortado al final | Además, en `standard` y `best`, cuando Doconda escribe el contenido, el informe incluye `key_data`: importes, fechas, NIF/CIF e IBAN del documento, con su papel (importe principal, fecha de firma, vencimiento…). ## Errores que no se cobran * `format_unclear`: no pusiste `format` y la petición no deja claro qué archivo quieres. * `request_refused`: la petición busca engañar o hacer daño (falsificaciones, suplantaciones, páginas que piden contraseñas o tarjetas). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.