Подключить n8n к CheapTokens: учётные данные OpenAI

В n8n создайте учётные данные OpenAI, впишите в Base URL адрес https://api.cheaptokens.dev/v1, в API Key — ключ CheapTokens, а в узле OpenAI Chat Model выберите id модели. Это вся замена: ни своего узла, ни сторонних пакетов. Готовые workflow остаются как есть — им просто назначают новые учётные данные.

Работает это потому, что API CheapTokens понимает формат OpenAI Chat Completions (и Anthropic Messages тоже), а узел OpenAI в n8n разницы не замечает. Если «базовый адрес» для вас новое слово, короткий разбор объяснит его за пару минут.

Что есть в учётных данных n8n#

В учётных данных OpenAI четыре вещи. По исходному коду credential в репозитории n8n (ветка master, проверено 1 ноября 2026) это API Key (обязателен, маскируется), Organization ID (необязательно), Base URL (по умолчанию https://api.openai.com/v1, поле переопределяет базовый адрес API) и переключатель Add Custom Header с именем и значением заголовка.

Есть нюанс: на странице документации n8n про эти учётные данные описаны только ключ и Organization ID. Поле Base URL видно в исходном коде, на него и опирается эта инструкция.

При сохранении n8n проверяет учётные данные запросом на {Base URL}/models с заголовком Authorization: Bearer <API Key>. Так что неверный адрес или ключ выясняется сразу, ещё до сборки workflow.

Настройка в четыре шага#

Не знаете, какой id писать? Спросите у самого API: статья «List models with GET /v1/models» показывает точные строки. У разных сервисов одна и та же модель называется по-разному, поэтому берите id из CheapTokens, а не из чужой документации.

Сначала проверьте ключ вне n8n#

Если проверка учётных данных не прошла, надо понять: виноват n8n или ключ. Короткая проверка в терминале даёт ответ. Ключ лежит в переменной окружения, так что секрет не попадёт в историю команд.

export CHEAPTOKENS_API_KEY="your-key-here"
curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
r = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Reply with one word: ready"}],
    max_tokens=20,
)
print(r.choices[0].message.content, r.usage)

Первый workflow: сортируем входящие письма#

Допустим, в общий ящик приходит около тысячи писем в день. Каждое нужно пометить как billing, bug или other и добавить одну строку-резюме для того, кто возьмёт письмо в работу.

Собирается так: Gmail Trigger (или узел Webhook) передаёт письмо в Basic LLM Chain. Промпт в цепочке примерно такой: «Отнеси письмо к billing, bug или other и перескажи его одним предложением», а текст письма подставляется из предыдущего узла. Думает за цепочку узел OpenAI Chat Model с вашими учётными данными CheapTokens.

Задача короткая и однотипная: маленький вход, маленький ответ, тысячи одинаковых запусков. Именно здесь дешёвая модель со стабильной ценой окупается сильнее всего. Для такой работы в CheapTokens подойдёт DeepSeek-V4-Flash: одна цена в любое время суток, контекст 380K и до 32 768 токенов в ответе.

Сколько стоит запуск#

Допустим, на каждое письмо уходит промпт около 1 500 токенов (инструкция плюс письмо), а модель пишет в ответ около 300 токенов. Один запуск на DeepSeek-V4-Flash стоит $0.000053. А вот 1 000 писем в день по всем моделям рядом с OpenRouter, вход и выход вместе:

Числа токенов здесь — допущение для примера. Замерьте свои: отправьте типичное письмо через проверку в Python, прочитайте usage и подставьте числа. Актуальные цены — на странице тарифов.

Чат-сценарий устроен иначе. С узлом памяти вся история уходит при каждом вызове, и вход растёт с каждым сообщением. Как быстро это набегает, показывает статья «Why a long AI chat costs more».

Если не работает#

Чаще всего виноват ключ, адрес или id модели. Статья «API 401 or 404: wrong key, base URL or model id» разбирает тексты каждой ошибки. А перед ней пройдитесь по списку:

Хотите увидеть остальные настройки? В документации CheapTokens есть полный справочник API. Тот же приём работает и в других инструментах: Open WebUI и LangChain подключаются так же — один адрес, один ключ, один id модели.