Блог Zukko

Гайды по Claude Code, Cursor, Codex и API Claude и GPT: настройка, экономия токенов, разбор ошибок.

Асинхронные запросы OpenAI в Python: тысячи запросов с повторами и учётом

6 мин · · разработка

Рабочий скрипт для партии из тысяч запросов: ограничение параллельности, повторы только там, где они помогают, подсчёт токенов и денег.

Каскад моделей LLM: дешёвая модель сначала, сильная — по эскалации

5 мин · · разработка

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

GPT-6.1 Sol через API: подключение, цены и кэш в Zukko

5 мин · · модели

Как вызвать GPT-6.1 Sol по ключу Zukko, сколько она стоит, как проверить кэш через cached_tokens и с какими моделями её сравнивать.

Claude через /v1/messages или /v1/chat/completions: что будет с кэшем

5 мин · · экономия

Claude отвечает в обоих форматах, но скидку за кэш даёт только Anthropic-формат. Расчёт разницы и инструкция по переключению кода и инструментов.

Кэширование промптов: как считаются чтение и запись кэша в Zukko

7 мин · · экономия

Из чего складывается счёт, когда работает кэш промптов: свежий вход, чтение, запись и выход. Формула и два расчёта на текущих ценах.

LobeChat (LobeHub): подключение Zukko через интерфейс и env

7 мин · · разработка

LobeChat, теперь LobeHub, работает с любым OpenAI-совместимым API. Показываем настройку в интерфейсе и через env, расчёт стоимости и разбор типичных ошибок.

Cherry Studio: добавление API-провайдера Zukko

5 мин · · разработка

Cherry Studio подключает сторонние API как провайдеров. Показываем, что вписать в API Host, как добавить модели и почему важно включить провайдер.

Chatbox: подключение собственного API-ключа Zukko

5 мин · · разработка

Chatbox позволяет добавить свой провайдер с собственным ключом. Разбираем поля API Host и API Path, добавление моделей и типичные ошибки.

LibreChat: кастомный эндпоинт Zukko в librechat.yaml

5 мин · · разработка

LibreChat подключает сторонних провайдеров через librechat.yaml. Готовый конфиг для Zukko, монтирование в Docker и типичные ошибки.

Open WebUI: подключение к Zukko через Docker и панель администратора

6 мин · · разработка

Open WebUI работает с любым OpenAI-совместимым API. Показываем команду запуска, настройку через Connections, расчёт стоимости и разбор ошибок.

Discord-бот на Claude или GPT: минимальный пример

4 мин · · разработка

Двадцать строк кода и один API-ключ — и в Discord-канале уже отвечает Claude или GPT. Разбираем рабочий пример и типичные ошибки под нагрузкой.

Мобильное приложение на Claude или GPT API

4 мин · · разработка

Ключ, вшитый в мобильное приложение, рано или поздно окажется в чужих руках. Разбираем архитектуру с бэкендом-прокси и реальные примеры на Kotlin, Swift и Node.

Потоковая передача ответа: когда нужен stream: true

4 мин · · разработка

stream: true не для каждого случая. Разбираем, как читать поток событий, где он реально нужен и какие ошибки чаще всего в нём прячутся.

Как писать системные промпты, которые реально работают

3 мин · · разработка

Большинство системных промптов не работают не из-за модели, а из-за формулировок. Разбираем, что реально меняет поведение, а что модель просто игнорирует.

История списаний через GET /v1/usage для своей отчётности

5 мин · · API

Если нужно посчитать, сколько потратил каждый клиент или проект, дергать кабинет руками не вариант. Разбираем, как выгрузить всю историю через API.

Баланс через API: как построить свой дашборд расходов

4 мин · · API

Кабинет показывает баланс, но не даёт агрегировать расход по моделям и дням так, как нужно именно вам. Собираем свой дашборд из трёх источников данных API.

Автономный ИИ-агент с нуля: минимальный рабочий пример

4 мин · · агенты

Агент — это не библиотека, а цикл из трёх шагов. Собираем минимальный рабочий пример на голом API, без фреймворков.

Извлечение структурированных данных из документов

4 мин · · разработка

Разбор счетов, накладных и анкет вручную не масштабируется. Как отдать эту работу vision-модели и получить на выходе валидный JSON.

RAG-пайплайн на своих данных: минимальная схема

5 мин · · разработка

RAG не обязан начинаться с векторной базы. Разбираем минимальную схему: когда достаточно длинного контекста, а когда нужен полноценный retrieval.

Автоматический код-ревью на Claude через API

4 мин · · разработка

Ставим Claude в GitHub Actions так, чтобы он комментировал пул-реквесты, не дублировал списания при перезапуске джобы и не съедал бюджет на одном гигантском диффе.

Какая модель лучше пишет код на Python

4 мин · · модели

Вместо рейтинга «лучшая модель для Python» — рабочая методика: как прогнать одну и ту же задачу через несколько моделей и сравнить честно, на своих тестах.

Function calling у Claude, GPT и GLM: что по-разному

4 мин · · разработка

Формат tool calling зависит не от модели, а от эндпоинта, через который вы её вызываете. Разбираем разницу между /v1/messages, /v1/chat/completions и /v1/responses.

Свой Telegram-бот на Claude или GPT: минимальный пример

3 мин · · разработка

Собираю минимального Telegram-бота на aiogram, который дергает Claude или GPT через шлюз. Полный код, плюс что делать с ошибками баланса и лимитов прямо в чате.

LangChain: как указать наш base_url вместо OpenAI

4 мин · · разработка

В LangChain это буквально один параметр — base_url. Показываю точный код для ChatOpenAI и ChatAnthropic, чтобы вместо OpenAI пойти в наш шлюз с моделями Claude, GPT и GLM.