Szkic artykułu

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

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

Odpowiedź

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