SerpJet Создать бриф и дождаться готовой статьи
POST /projects/{id}/manual-briefs ставит тему статьи в генерацию. Затем опрашивайте GET /manual-briefs/{id}, пока статус не станет ready, и заберите статью через GET /articles/{id}.
1. Отправить тему
POST /projects/321/manual-briefs
{"external_request_id": "article-request-789",
"title": "Как выбрать кондиционер для квартиры",
"description": "Нужно написать SEO-статью для сайта магазина климатической техники.",
"requirements": "Добавить блок про энергоэффективность.",
"auto_start": true}- Обязательны
external_request_id,title,description. auto_start: false— сохранить бриф без запуска.- Генерация асинхронная; ответ содержит
manual_brief.idи статус. - Запуск подчиняется дневному лимиту проекта и балансу пользователя — как в панели — Дневной лимит, московские сутки, запас тем и автоматический выпуск.
2. Следить за статусом
GET /manual-briefs/555| status | Что значит |
|---|---|
queued | Принят и стоит в очереди. |
processing | Идёт генерация. |
paused_no_balance | Недостаточно токенов — продолжится после пополнения. |
duplicate | Найдена похожая статья — новая не пишется. |
ready | Готово, есть article_id. |
failed | Ошибка генерации. |
Поле generation (stage, label, progress_pct, is_terminal) подходит для индикатора прогресса в вашем интерфейсе. Опрашивайте раз в 30–60 секунд, пока is_terminal не станет true.
3. Забрать статью
GET /articles/987
→ {"ok": true, "article": {"id": 987, "project_id": 321, "title": "…",
"description": "…", "content": "<h1>…</h1><p>…</p>", "status": "checked", …}}Для публикации на сайте с подтверждением и обновлениями удобнее External API — Связать Partner API генерации с External API доставки.
Не нашли ответ? Напишите в поддержку из панели — укажите проект и что вы видите на экране.