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

# Empezar con el SDK

> 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 no tiene dependencias en ejecución.

```bash theme={null}
npm install @doconda/sdk
```

## Tu primer documento

```ts theme={null}
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={null}
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
})
```

| Opción | Para qué |
| - | - |
| `apiKey` | Tu key. Su prefijo decide la región: `ak_eu_…` va a la API de Europa, `ak_us_…` a la de EE. UU. |
| `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. |

<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](/sdk/stream).
</Warning>

## Qué sigue

<CardGroup cols={2}>
  <Card title="Crear documentos" href="/sdk/create">Word, PDF, PowerPoint, Excel y artifacts.</Card>
  <Card title="Ver el documento en directo" href="/sdk/stream">Eventos mientras se escribe.</Card>
  <Card title="Revisar y editar tu archivo" href="/sdk/review-edit">Sube un fichero y trabaja sobre él.</Card>
  <Card title="Errores y reintentos" href="/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.