Crear

{
  "format": "docx",
  "content": { "markdown": "# Solicitud de vacaciones\n\nEstimada Sra. García: ..." },
  "style": "títulos azules"
}

{
  "format": "docx",
  "prompt": "Reporte de la ley de vivienda con títulos azules y centrado"
}

{
  "format": "pdf",
  "prompt": "Resume esto en 2 páginas",
  "sources": ["file_01JAB3..."]
}

​

Qué recibes

• 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 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 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

{
  "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 (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

• 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

​

Avisos del informe

​

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