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

# SDK de TypeScript

> Instálalo, dale tu API key y crea tu primer documento en tres líneas.

El SDK de TypeScript hace lo mismo que la API, pero con tipos, reintentos y streaming ya resueltos. Funciona en
Node 20 o superior (también en funciones serverless) y su única dependencia en ejecución es `zod`.

<Tip>También en Python, con los mismos métodos: [SDK de Python](/es/sdk/python).</Tip>

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
npm install @doconda/sdk
```

## Tu primer documento

```ts theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
import { Doconda } from "@doconda/sdk"

const doconda = new Doconda()
const doc = await doconda.documents.create({ format: "docx", prompt: "Informe de la ley de vivienda" })

console.log(doc.status) // "ready"
console.log(doc.outputs) // enlaces al Word y al PDF
```

`new Doconda()` lee la key de `DOCONDA_API_KEY`. Créala en el panel, en **API keys**.

## Opciones

```ts theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
const doconda = new Doconda({
  apiKey: process.env.DOCONDA_API_KEY, // por defecto
  maxRetries: 2,                       // reintentos de red, 429 y 5xx
  baseUrl: "https://api.eu.doconda.com/v1", // normalmente no hace falta
  language: "es",                      // mensajes en español; sin él, en inglés
})
```

| Opción | Para qué |
| - | - |
| `apiKey` | Tu key (`ak_eu_…`). |
| `maxRetries` | Cuántas veces reintentar un fallo de red o del servidor. Por defecto 2. |
| `baseUrl` | Otra URL de la API (por ejemplo, tu entorno local: `http://localhost:3000/v1`). También `DOCONDA_BASE_URL`. |
| `fetch` | Tu propio `fetch`, para tests o entornos especiales. Lo usan todas las llamadas, también `download`. |
| `language` | `"es"` o `"en"`: el idioma de los mensajes de error y de los textos del informe ([idioma de los mensajes](/es/guides/errors#idioma-de-los-mensajes)). Sin él, en inglés. |

<Warning>
  Usa el SDK **en tu servidor**, nunca en el navegador: tu API key da acceso a todos los documentos del proyecto.
  Si quieres enseñar un documento construyéndose en tu web, mira [Ver el documento en directo](/es/sdk/stream).
</Warning>

## Qué sigue

<CardGroup cols={2}>
  <Card title="Crear documentos" href="/es/sdk/create">Word, PDF, PowerPoint, Excel y artifacts.</Card>
  <Card title="Ver el documento en directo" href="/es/sdk/stream">Eventos mientras se escribe.</Card>
  <Card title="Revisar y editar tu archivo" href="/es/sdk/review-edit">Sube un fichero y trabaja sobre él.</Card>
  <Card title="Errores y reintentos" href="/es/sdk/errors">Qué puede fallar y cómo reaccionar.</Card>
</CardGroup>


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