> ## 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.

# API para generar Word y PowerPoint con tu plantilla

> Genera un Word o un PowerPoint con el diseño de tu plantilla por API: pasa el archivo en sources y pide «con el diseño de nuestra plantilla».

Para generar un Word o un PowerPoint desde tu plantilla con la API de Doconda, sube la plantilla, pásala en `sources` y
dilo en la petición: «con el diseño de nuestra plantilla». Doconda escribe el contenido y copia el diseño. No es un motor
de marcadores (`{nombre}`, combinar correspondencia): si ya tienes los datos y quieres rellenar huecos, mira
[Carbone](/compare/carbone) o [Docmosis](/compare/docmosis).

## Pasos

1. Guarda tu API key (panel → **API keys**) en `DOCONDA_API_KEY` e instala el SDK (`pip install doconda` o
   `npm install @doconda/sdk`).
2. Sube la plantilla y, si quieres, los ficheros con el material del contenido.
3. Crea el documento con la plantilla en `sources` y menciónala en el `prompt`:

<CodeGroup>
  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  from doconda import Doconda

  doconda = Doconda()  # lee la key de DOCONDA_API_KEY
  plantilla = doconda.files.upload("plantilla-empresa.pptx")
  datos = doconda.files.upload("resultados-t3.xlsx")

  doc = doconda.documents.create(
      format="pptx",
      prompt="Resultados del trimestre para el comité, con el diseño de nuestra plantilla",
      sources=[plantilla["id"], datos["id"]],
  )
  open("resultados.pptx", "wb").write(doconda.documents.download(doc["id"], "pptx"))
  ```

  ```ts TypeScript theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  import { readFile, writeFile } from "node:fs/promises"
  import { Doconda } from "@doconda/sdk"

  const doconda = new Doconda()
  const plantilla = await doconda.files.upload(await readFile("plantilla-empresa.docx"), "plantilla-empresa.docx")

  const doc = await doconda.documents.create({
    format: "docx",
    prompt: "Informe de la reforma de la oficina, con el diseño de nuestra plantilla",
    sources: [plantilla.id],
  })
  await writeFile("informe.docx", await doconda.documents.download(doc.id, "docx"))
  ```
</CodeGroup>

## Qué se copia

* **Una presentación para una presentación** se usa como plantilla: el resultado parte de sus diapositivas.
* **Cualquier otro archivo** (un Word, un Excel, un PDF o una imagen PNG, JPEG o WebP): se copian sus fuentes, colores,
  márgenes, cabecera y pie, logo y portada.
* El resto de ficheros en `sources` siguen siendo material para el contenido (hasta 5 documentos).
* El evento `design.chosen` dice qué archivo se usó como diseño.

## Qué devuelve

* Un `.docx` o `.pptx` editable, con su PDF. 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.
* `status`: `ready`, `ready_with_warnings`, `needs_review` o `failed` (no se cobra).
* Un informe (`documents.report(id)`) que avisa, por ejemplo, de cifras que no están en tu petición ni en tus fuentes.

## Límites de calidad

Copiar el diseño funciona en `standard` y `best`. En `fast` el documento sale con un diseño propio y el informe lo avisa
(`design.not_copied`). Con `quality: "auto"` (por defecto), copiar el diseño de un archivo que no sea una plantilla de
PowerPoint para una presentación elige `best`. Ver [niveles de calidad](/guides/create#niveles-de-calidad).

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Puedo rellenar campos como {cliente} o {importe}?">
    No: Doconda no sustituye marcadores, copia el diseño y escribe el contenido. Para combinar datos JSON con una
    plantilla con marcadores, compara con [Carbone](/compare/carbone) y [Docmosis](/compare/docmosis).
  </Accordion>

  <Accordion title="¿Y si ya tengo el texto escrito?">
    Para usar el diseño de un archivo hay que pasarlo en `sources`, y los documentos en `sources` solo van con `prompt`.
    Si solo necesitas un estilo, descríbelo en `style` con tus palabras: ver [estilo](/guides/style).
  </Accordion>

  <Accordion title="¿Cuánto cuesta?">
    Pagas por documento entregado, según el nivel: crear desde una frase cuesta 0,50 € en `standard` y 1,50 € en `best`.
    Ver [precios](/guides/account#precios).
  </Accordion>
</AccordionGroup>

## Sigue leyendo

* [Crear](/guides/create#copiar-el-diseño-de-un-archivo): copiar el diseño de un archivo.
* [Documentos con el estilo de tu marca](/answers/brand-style-documents).
* [Quickstart](/quickstart).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.