---
title: "Resumen de la API"
description: "Qué hace la API REST, dónde se encuentra y cómo crear, modificar y publicar un sitio con ella."
canonical: "https://atelier201.com/docs/es/api/overview"
updated: "2026-11-06"
---

# Resumen de la API

La API está en `https://api.atelier201.com/v1`. Permite hacer todo lo que se puede hacer en la aplicación,
y la [CLI](/docs/cli/overview) y el [servidor MCP](/docs/mcp/overview) usan
el mismo contrato.

## Tu primera llamada

```bash
curl https://api.atelier201.com/v1/account \
  -H "Authorization: Bearer $ATELIER201_API_KEY"
```

**Llama primero a `/v1/account`.** Una sola solicitud te indica el espacio de trabajo, el plan y
los permisos exactos que se han concedido a la credencial que tienes. Averiguarlos
a base de errores 403 es la forma más lenta.

## De cero a un sitio publicado

Cada paso requiere una llamada. Solo el último cambia lo que ven los visitantes.

1. [Crea un sitio](/docs/api/sites/create). Parte de la plantilla inicial de Atelier201 y
   se compila una vez.
2. [Consulta el modelo de contenido](/docs/api/content/model) y luego modifica textos y
   entradas con [Crear o actualizar una entrada](/docs/api/content/save-entry) y
   [Cambiar un campo](/docs/api/content/set-field).
3. [Compila el sitio](/docs/api/builds/start) y consulta periódicamente
   [la compilación](/docs/api/builds/retrieve) hasta que esté `ready`.
4. [Comparte una vista previa](/docs/api/previews/create) con el propietario.
5. [Revisa](/docs/api/publishing/review) y, cuando el propietario dé su aprobación,
   [publica](/docs/api/publishing/publish).

Encontrarás los conceptos que hay detrás de cada paso en
[Cómo se publica un sitio](/docs/platform/drafts-builds-and-publishing).

## Costes

Editar, compilar, previsualizar y publicar están incluidos en el plan del sitio y
no consumen créditos. Hay una excepción: [generar una imagen o un vídeo con
IA](/docs/api/media/generate), con un precio fijo y una primera generación gratuita, protegido por su
propio permiso `media:generate`. Consulta [Planes y créditos](/docs/platform/credits-and-plans).

## Qué no hace

No es una API de streaming ni mantiene abierta la conexión. Al iniciar una
compilación, la API responde de inmediato con una compilación `queued`, y tienes que consultar el resultado. La compilación
continúa aunque se desconecte tu cliente.