API TextIQ

REST API позволяет запускать любые шаблоны TextIQ из ваших скриптов, CRM или интеграций. Доступен на тарифе Pro и выше. Все запросы — HTTPS, ответы в JSON.

1. Получите ключ

Откройте Настройки → API-доступ, нажмите «Создать» и скопируйте токен сразу — он больше не будет показан. Храните ключ как пароль: любой, кто его получит, сможет тратить ваши кредиты.

2. Аутентификация

Передавайте ключ в заголовке Authorization:

Authorization: Bearer tiq_xxxxxxxxxxxx...

3. Запуск генерации

POST https://text-iq.ru/api/generations — создаёт задачу и возвращает id. Статус и результат получаются через GET.

curl -X POST https://text-iq.ru/api/generations \
  -H "Authorization: Bearer $TIQ_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateCode": "wb_card",
    "input": {
      "product_name": "Платье миди",
      "category": "Одежда",
      "keywords": "вискоза, лето, приталенное"
    }
  }'

Ответ (HTTP 202):

{
  "id": "cmo97prq000077flpqy7nlqfy",
  "status": "pending",
  "createdAt": "2026-04-22T04:00:00.000Z"
}

4. Получение результата

curl https://text-iq.ru/api/generations/<id> \
  -H "Authorization: Bearer $TIQ_KEY"

Поле status проходит путь pending → processing → completed (или failed). Когдаcompleted, в output будет готовый текст или JSON (зависит от outputFormat шаблона).

5. Перечень шаблонов

GET https://text-iq.ru/api/templates — публичный эндпоинт, возвращает список активных шаблонов с их code, inputSchema.fields и стоимостью в кредитах.

Коды ошибок

401 Unauthorized — ключ отсутствует, неверный или отозван
402 Payment Required — закончились кредиты
400 Invalid input — не прошла схема inputSchema шаблона (детали в details)
404 Template not found — неверный templateCode
429 — rate limit (30 POST /generations в минуту)

Лимиты

До 10 активных ключей на аккаунт
POST /api/generations: 30 запросов в минуту
Стоимость в кредитах указана в поле creditsPerRun шаблона

Поддержка

Вопросы, баги, предложения — пишите на hello@text-iq.ru.