# Szkic artykułu

> POST /api/generate/draft: konspekt artykułu w blokach EditorJS na podstawie tematu.

```text
POST https://api.prosecaptain.com/api/generate/draft?token=TWOJ_TOKEN
```

Tworzy artykuł ze szkicem (konspektem) na podstawie tematu. Szkic jest w formacie bloków EditorJS. Artykuł trafia do Twojego workspace, gdzie możesz go rozwinąć w aplikacji.

## Treść żądania

```json
{
  "context": "Jak wybrać chatbota AI dla firmy usługowej",
  "title": "Chatbot AI w firmie usługowej",
  "keywords": ["chatbot AI", "obsługa klienta"],
  "toneOfVoice": "professional",
  "complexity": "moderate",
  "language": "polish",
  "includeImages": true
}
```

| Pole | Wymagane | Opis |
|---|---|---|
| `context` | tak | Temat lub brief artykułu. |
| `title` | nie | Tytuł, maksymalnie 120 znaków. Domyślnie pierwsza linia `context`. |
| `articleId` | nie | Istniejący artykuł z Twojego workspace, do którego ma trafić szkic. |
| `includeImages` | nie | Czy wygenerować miniaturę. Domyślnie `true`. |

Oraz [wspólne pola](/dokumentacja/api-artykulow/#wspólne-pola).

## Odpowiedź

```json
{
  "success": true,
  "article_id": "6f1c…",
  "draft": {
    "blocks": [
      { "type": "header", "data": { "text": "Chatbot AI w firmie usługowej", "level": 1 } },
      { "type": "paragraph", "data": { "text": "Wstęp…" } }
    ],
    "version": "2.29.1"
  },
  "processing_time_ms": 41250,
  "workspace": { "id": "…", "name": "…" }
}
```

## Błędy

| Status | `code` | Opis |
|---|---|---|
| 400 | `validation_failed` | Błędne pola, szczegóły w `errors`. |
| 404 | `article_not_found` | `articleId` nie istnieje w Twoim workspace. |
| 504 | `draft_generation_timeout` | Generowanie trwało za długo. Spróbuj krótszego `context`. |
| 500 | `generation_failed` | Błąd generowania. Ponów żądanie. |