Блог Zukko
Гайды по Claude Code, Cursor, Codex и API Claude и GPT: настройка, экономия токенов, разбор ошибок.
Модель пропала из списка моделей — почему так и что делать
3 мин · · диагностика
Список моделей — не каталог на год вперёд, а снимок того, что работает прямо сейчас. Разбираем, почему он меняется.
Экономия на повторных запросах: кэш через X-Zukko-Cache и temperature:0
4 мин · · API
Одинаковый запрос дважды не должен стоить дважды. Разбираем, как включить кэш ответов и на каких сценариях он реально экономит деньги.
API или подписка ChatGPT Plus — что выгоднее разработчику
4 мин · · сравнение
Подписка и API решают разные задачи. Разбираем, во сколько реально обходится каждый вариант и когда есть смысл держать оба.
История списаний через GET /v1/usage для своей отчётности
5 мин · · API
Если нужно посчитать, сколько потратил каждый клиент или проект, дергать кабинет руками не вариант. Разбираем, как выгрузить всю историю через API.
Баланс через API: как построить свой дашборд расходов
4 мин · · API
Кабинет показывает баланс, но не даёт агрегировать расход по моделям и дням так, как нужно именно вам. Собираем свой дашборд из трёх источников данных API.
Как получать строго структурированный JSON от модели
3 мин · · API
Просить модель «ответь в формате JSON» в системном промпте работает через раз. Разбираем способ понадёжнее — через tools с жёсткой схемой.
Как посчитать стоимость запроса заранее через count_tokens
4 мин · · API
Перед тем как жечь баланс на длинный промпт, можно бесплатно узнать, во сколько токенов он обойдётся. Разбираем, как это сделать одним запросом.
Кэш ответов X-Zukko-Cache: когда запрос бесплатный
5 мин · · API
Одинаковый запрос от одного пользователя можно не оплачивать второй раз. Разбираем, как включается кэш и как проверить, сработал ли он.
Idempotency-Key: как ретраить запросы и не платить дважды
4 мин · · API
Таймаут на клиенте не значит, что запрос не выполнился на сервере. Заголовок Idempotency-Key решает это без ручной проверки истории.
Как самому проверить, что списания по API считаются честно
5 мин · · API
Не нужно верить на слово — стоимость каждого запроса видна прямо в заголовках ответа, а история списаний доступна по курсору в любой момент.
Мониторинг расхода в реальном времени по заголовкам ответа
4 мин · · API
Не нужно ждать отчёта за сутки, чтобы узнать, сколько стоил запрос — цена и остаток баланса приходят в заголовках каждого обычного (не потокового) ответа. Как это использовать.