Блог Zukko
Гайды по Claude Code, Cursor, Codex и API Claude и GPT: настройка, экономия токенов, разбор ошибок.
Claude и GPT API для учёбы: как не переплатить студенту
4 мин · · бизнес
Пять подписок ради разных задач — плохая идея на студенческий бюджет. Разбираем, как получить доступ ко всем моделям через один ключ и платить только за токены.
Шлюз для агентств и фрилансеров: биллинг по клиентам
5 мин · · бизнес
Когда с одного аккаунта работают несколько клиентских проектов, вопрос не в том, где взять модель, а в том, как не перепутать, кто сколько потратил.
Как на практике снизить расход токенов
5 мин · · экономия
Расход токенов почти никогда не снижается одним волшебным приёмом — обычно это пять маленьких решений, которые вместе дают заметную разницу.
Во что обходится очень длинный контекст
4 мин · · оплата
Контекст в миллион токенов звучит как разрешение ни в чём себе не отказывать. На практике за него платят не только деньгами.
Разница в цене входных и выходных токенов — почему так
4 мин · · оплата
Один и тот же счётчик токенов, но два разных тарифа. Разбираемся, откуда берётся разница и на что она влияет в реальной работе.
Как считается цена текстового запроса от начала до конца
5 мин · · оплата
От отправки запроса до списания денег проходит несколько шагов, и почти на каждом можно либо сэкономить, либо потерять контроль над расходом.
Как считается цена генерации изображения
4 мин · · изображения
Изображение стоит фиксированно за штуку, а не за токены. Разбираем, откуда взять точную цену конкретной модели и как проверить, сколько списалось на самом деле.
Таймауты при длинных генерациях: как их не ловить
4 мин · · разработка
Оборванный на середине ответ почти всегда значит не лимит по токенам, а таймаут вашего же клиента. Разбираем, где он берётся и как повторять запрос без двойного списания.
Ошибка 413: запрос слишком большой — как обойти
4 мин · · ошибки
413 почти всегда означает не проблему с ключом или моделью, а раздутое тело запроса. Разбираем, откуда берётся лишний вес и как его убрать.
Ограничения на размер и формат изображений: частые ошибки
5 мин · · изображения
Ошибка с картинкой почти никогда не называет точную причину прямо. Разбираем, где реально теряются изображения на входе и как это отладить быстро.
Генерация по референсному изображению: как это работает
4 мин · · изображения
Референс переносит стиль и композицию образца на новую сцену. Разбираем модель, формат запроса и типичные ограничения режима.
Редактирование изображений через API: пошагово
4 мин · · изображения
Редактирование изображения — это тот же эндпоинт, что и генерация, но с другой моделью и картинкой в теле запроса. Разбираем на реальных примерах.
Полный пример на Node.js: официальные SDK через наш шлюз
2 мин · · разработка
Node-версии официальных SDK настраиваются так же, как Python — один параметр baseURL меняет весь маршрут запроса.
Полный пример на Python: официальные SDK через наш шлюз
3 мин · · разработка
Официальные SDK не нужно ничем заменять — их достаточно направить на другой адрес. Разбираем оба клиента на реальном коде.
No-code автоматизация с ИИ в Zapier и Make
4 мин · · автоматизация
В Zapier и Make нет готового блока под наш шлюз — но есть универсальный HTTP-модуль, и этого достаточно для полноценной интеграции.
OpenAI Agents SDK через наш /v1/responses
4 мин · · агенты
Agents SDK по умолчанию ходит в OpenAI. Меняем два параметра клиента — и агенты работают через наш шлюз на моделях из каталога.
LlamaIndex: индексация данных на Claude и GPT
5 мин · · разработка
LlamaIndex разделяет LLM для синтеза ответов и модель для эмбеддингов — гейтвей закрывает только первую часть. Разбираем, как это настроить честно.
Vercel AI SDK: подключение в Next.js-приложении к Claude и GPT
5 мин · · разработка
В AI SDK OpenAI- и Anthropic-провайдер по-разному достраивают путь к baseURL — ошибиться с /v1 в одном route handler легче, чем кажется. Разбираем настройку.
Semantic Kernel: подключение .NET-приложения к Claude и GPT
5 мин · · агенты
SK ходит к OpenAI через официальный .NET SDK, который слушается HttpClient.BaseAddress. Разбираем настройку, частые 404 и повторные списания.
Microsoft AutoGen: настройка на своём ключе вместо OpenAI
5 мин · · агенты
AutoGen строит своего клиента поверх openai-python, поэтому base_url и api_key меняются в config_list напрямую. Разбираем настройку и типичные грабли.
CrewAI: подключение агентов к Claude и GPT через один ключ
5 мин · · агенты
CrewAI тянет к OpenAI через LiteLLM, но agent.llm можно переставить на любую модель гейтвея. Разбираем настройку и типичные ошибки на старте.
Массовая обработка запросов без упора в лимит скорости
4 мин · · разработка
Один ключ с лимитом на батч-задаче — гарантированный 429 на середине прогона. Разбираем, как строить массовую обработку так, чтобы это не случилось.
Зачем стартапу шлюз вместо прямого биллинга у провайдера
5 мин · · бизнес
Пять провайдеров — пять счетов, пять валют, пять форматов API. Разбираем, что меняется, когда за всем этим стоит один ключ и один баланс.
Neovim: подключение avante.nvim и codecompanion
4 мин · · IDE
У avante.nvim и codecompanion.nvim разная логика адресов под капотом — один провайдер ждёт /v1, другой нет. Разбираем обе конфигурации построчно.