Zukko API — полная база знаний Этот файл — полная документация Zukko API. Загрузите его в ИИ (ChatGPT, Claude, Cursor и т.д.), чтобы ассистент знал endpoints, auth, модели и примеры. Сайт: https://zukko.pro API: https://api.zukko.pro OpenAI-compatible base: https://api.zukko.pro/v1 Anthropic-compatible base: https://api.zukko.pro Auth: Authorization: Bearer fetch_YOUR_KEY ---------- Введение Введение Zukko даёт единый доступ к Claude, GPT и другим моделям через совместимый API. Вы используете один ключ fetch_*, а все запросы отправляете на единый домен: https://api.zukko.pro Что такое Zukko Zukko работает как AI gateway: вы подключаете один endpoint, а дальше используете Claude, GPT и другие модели через единый слой доступа, ключей и биллинга. Что вы получаете - один API для нескольких провайдеров; - единый кабинет и биллинг; - совместимость с OpenAI-like и Anthropic-like SDK; - быстрый запуск в IDE, агентах и своих приложениях. Базовые URL OpenAI-compatible: https://api.zukko.pro/v1 Anthropic-compatible: https://api.zukko.pro Как это обычно подключают Чаще всего интеграция выглядит так: 1. создаёте API-ключ в кабинете Zukko; 2. подставляете fetch_* ключ в приложение; 3. меняете base URL на https://api.zukko.pro или https://api.zukko.pro/v1; 4. выбираете модель и отправляете запрос. Что дальше 1. Зарегистрируйтесь на Zukko. 2. Создайте API-ключ с префиксом fetch_. 3. Откройте Quick Start и подключите ваш SDK или IDE. 4. Выберите модель и отправьте первый запрос. ---------- Для чайников Это самый простой разбор: что такое Zukko, куда стучаться и как не запутаться. Одной фразой Zukko — это «розетка» для ИИ. Вы один раз подключаете адрес api.zukko.pro и ключ fetch_..., а дальше можете звать Claude, GPT и другие модели как будто это один провайдер. Три вещи, которые нужно знать 1. Ключ — секретный пароль вида fetch_xxxxx. Берёте в кабинете → API keys. Никому не светите. 2. Адрес API — https://api.zukko.pro. Это сервер Zukko, не Anthropic и не OpenAI напрямую. 3. Модель — строка вроде claude-sonnet-5 или gpt-4o. Пишете в поле model запроса. Какой URL ставить Зависит от того, чем вы пользуетесь: Чем пользуетесь | Base URL --- | --- Cursor / OpenAI SDK / большинство IDE | https://api.zukko.pro/v1 Claude Code / Anthropic SDK | https://api.zukko.pro Оба варианта идут в один и тот же Zukko. Разница только в формате запроса (OpenAI-style vs Anthropic-style). Первый запрос без боли 1. Зарегистрируйтесь на zukko.pro (https://zukko.pro). 2. Пополните баланс (иначе запросы не уйдут). 3. Создайте ключ fetch_.... 4. Вставьте ключ и base URL в IDE или в curl. 5. Отправьте короткий вопрос — если пришёл ответ, всё ок. Минимальный curl (Anthropic-style): curl https://api.zukko.pro/v1/messages \ -H "Authorization: Bearer fetch_YOUR_KEY" \ -H "Content-Type: application/json" \ -H "anthropic-version: 2023-06-01" \ -d '{"model":"claude-sonnet-5","max_tokens":256,"messages":[{"role":"user","content":"Привет"}]}' Частые ошибки - 401 / unauthorized — кривой или пустой ключ. Проверьте Bearer fetch_.... - 402 / недостаточно средств — пополните баланс в кабинете. - 404 / model not found — опечатка в имени модели. Смотрите список моделей в доке. - Подключён старый URL провайдера — в IDE должен быть именно api.zukko.pro, не api.anthropic.com и не api.openai.com. Скачать API для ИИ Это база знаний по всему API Zukko: URL, ключи, модели, примеры запросов, интеграции. Скачайте один файл и закиньте его в ChatGPT, Claude, Cursor или любого другого ИИ — он сразу будет знать полный API и сможет писать код / настройки без ошибок. MD — лучше всего для нейросетей (рекомендуем). Также есть TXT, DOC и PDF. Дальше: Быстрый старт (/docs/introduction/quick-start) или гайд под вашу IDE в меню слева. ---------- Быстрый старт Подключить Zukko можно за несколько минут. Ниже минимальная последовательность, чтобы отправить первый запрос. Шаг 1. Создайте API-ключ В кабинете Zukko создайте ключ с префиксом fetch_. fetch_xxxxxxxxxxxxxxxxxxxxx Шаг 2. Укажите base URL Для OpenAI-compatible клиентов используйте: https://api.zukko.pro/v1 Для Anthropic-compatible клиентов используйте: https://api.zukko.pro Шаг 3. Отправьте первый запрос curl https://api.zukko.pro/v1/messages \ -H "Authorization: Bearer fetch_YOUR_KEY" \ -H "Content-Type: application/json" \ -H "anthropic-version: 2023-06-01" \ -d '{"model":"claude-sonnet-5","max_tokens":256,"messages":[{"role":"user","content":"Hi"}]}' Шаг 4. Подключите IDE или SDK После успешного теста можно подключать Cursor, Claude Code, VS Code, Codex или свои скрипты через OpenAI / Anthropic SDK. ---------- API Примеры Аутентификация Все запросы к Zukko API отправляются с ключом fetch_*. Заголовок авторизации Authorization: Bearer fetch_YOUR_KEY Базовые правила - используйте HTTPS: https://api.zukko.pro; - не передавайте ключ в query string; - для Anthropic-compatible запросов добавляйте anthropic-version; - один и тот же ключ можно использовать для всех совместимых endpoint'ов. Пример curl https://api.zukko.pro/v1/models \ -H "Authorization: Bearer fetch_YOUR_KEY" ---------- POST /v1/chat/completions OpenAI-compatible endpoint для текстовой генерации и чата. Когда использовать Используйте этот endpoint, если ваш SDK или приложение ожидает формат OpenAI Chat Completions. Пример запроса curl https://api.zukko.pro/v1/chat/completions \ -H "Authorization: Bearer fetch_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Hello"}]}' Что передавать - model — id модели; - messages — массив сообщений; - stream — опционально, если нужен streaming. ---------- POST /v1/images/generations OpenAI-совместимый endpoint для генерации и редактирования изображений (Nano Banana, GPT Image и др.). Когда использовать Используйте этот endpoint для text-to-image, edit и reference-to-image моделей. Текстовые модели по-прежнему идут через /v1/chat/completions или /v1/messages. Пример запроса curl https://api.zukko.pro/v1/images/generations \ -H "Authorization: Bearer fetch_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "openai-gpt-image-2-text-to-image", "prompt": "A cinematic travel poster for Kyoto in autumn", "size": "1024x1024", "quality": "high" }' Что передавать - model — id image-модели; - prompt — текстовое описание; - images — массив URL или data URL (для edit / reference); - size, quality — опционально для GPT Image. ---------- POST /v1/messages Anthropic-compatible endpoint для Claude-style запросов. Когда использовать Используйте этот endpoint, если ваш клиент работает в формате Anthropic Messages API. Пример запроса curl https://api.zukko.pro/v1/messages \ -H "Authorization: Bearer fetch_YOUR_KEY" \ -H "Content-Type: application/json" \ -H "anthropic-version: 2023-06-01" \ -d '{"model":"claude-sonnet-5","max_tokens":256,"messages":[{"role":"user","content":"Hi"}]}' Что передавать - model — id модели; - messages — массив сообщений; - max_tokens — лимит генерации. ---------- POST /v1/messages/count_tokens Подсчёт токенов для Anthropic-compatible payload перед отправкой основного запроса. Пример запроса curl https://api.zukko.pro/v1/messages/count_tokens \ -H "Authorization: Bearer fetch_YOUR_KEY" \ -H "Content-Type: application/json" \ -H "anthropic-version: 2023-06-01" \ -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Count these tokens"}]}' ---------- GET /v1/models Возвращает список доступных моделей. Пример запроса curl https://api.zukko.pro/v1/models \ -H "Authorization: Bearer fetch_YOUR_KEY" Когда использовать - для загрузки каталога моделей; - для выбора модели в UI; - для интеграции в IDE и агентов. ---------- GET /v1/models/info Возвращает расширенную информацию о моделях: описание, провайдера, цены и дополнительные возможности. Пример запроса curl https://api.zukko.pro/v1/models/info \ -H "Authorization: Bearer fetch_YOUR_KEY" ---------- GET /v1/balance Возвращает текущий баланс аккаунта. Пример запроса curl https://api.zukko.pro/v1/balance \ -H "Authorization: Bearer fetch_YOUR_KEY" ---------- GET /v1/usage Возвращает usage-статистику по аккаунту или ключу. Пример запроса curl https://api.zukko.pro/v1/usage \ -H "Authorization: Bearer fetch_YOUR_KEY" ---------- POST /v1/responses Responses-style endpoint для unified generation flow. Пример запроса curl https://api.zukko.pro/v1/responses \ -H "Authorization: Bearer fetch_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"gpt-5.6-terra","input":"Write a short hello world example"}' ---------- POST /v1/web-search Endpoint для запросов с веб-поиском, если такая возможность включена на стороне сервиса. Пример запроса curl https://api.zukko.pro/v1/web-search \ -H "Authorization: Bearer fetch_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"latest Anthropic model release"}' ---------- GET /health Служебный endpoint для проверки доступности сервиса. Пример запроса curl https://api.zukko.pro/health Когда использовать - в мониторинге; - в readiness / liveness проверках; - перед внешним проксированием трафика. ---------- IDE Интеграции Выбор провайдера Сначала выбери тип в IDE, потом URL и ключ fetch_.... Хочешь | Провайдер | Base URL --- | --- | --- Claude | Anthropic | https://api.zukko.pro OpenAI API / Compatible | OpenAI | https://api.zukko.pro/v1 Ключ один и тот же — API-ключи (/app/api-keys). ---------- Cursor IDE 1. Провайдер: OpenAI Compatible 2. Base URL: https://api.zukko.pro/v1 3. API Key: fetch_... Нужен платный Cursor Pro (trial не подходит). Алиасы Alias | Model --- | --- cursor47 | claude-opus-4.7 cursor46 | claude-opus-4.6 cursor45 | claude-opus-4.5 cursor46s | claude-sonnet-5 cursor45s | claude-sonnet-4.5 cursorgpt54 | gpt-5.6-terra cursorgpt55 | gpt-5.6-sol cursorgemini | gemini-3.1-pro-preview ---------- Claude Code Официальный coding-агент Anthropic (CLI + расширение VS Code). Ниже — быстрый старт и полный ручной разбор с troubleshooting в конце. Сначала выберите режим Anthropic (не OpenAI). Base URL без /v1. См. Выбор провайдера (/docs/ide-integrations/choose-provider). Самый быстрый способ 1. Возьмите ключ на странице API-ключей (/app/api-keys) — он вида fetch_.... 2. Установите Claude Code (если ещё нет). 3. Пропишите ~/.claude/settings.json как в шаге 2 ниже. 4. Запустите claude в новом терминале. Ключ никуда не отправляется, кроме локального файла настроек на вашем компьютере. ---------- Ручная настройка Всё то же по шагам: установка → постоянный конфиг через settings.json → запуск. Обязательные значения - Провайдер: Anthropic - ANTHROPIC_BASE_URL = https://api.zukko.pro — без суффикса /v1, Claude Code сам добавит путь. - ANTHROPIC_AUTH_TOKEN = ваш ключ fetch_... со страницы ключей (/app/api-keys). 1. Установите Claude Code Пропустите шаг, если claude --version уже работает. macOS / Linux curl -fsSL https://claude.ai/install.sh | bash claude --version Windows (PowerShell) irm https://claude.ai/install.ps1 | iex После установки полностью закройте и снова откройте PowerShell, затем проверьте claude --version. Через npm (все платформы): npm install -g @anthropic-ai/claude-code Если claude.ai отдаёт 403 в вашем регионе — используйте установку через npm: она работает везде. 2. Рекомендуется: постоянная настройка через settings.json Claude Code читает ~/.claude/settings.json при каждом запуске — настроили один раз и забыли. И CLI, и расширение VS Code используют один и тот же файл. - macOS / Linux: ~/.claude/settings.json - Windows: %USERPROFILE%\.claude\settings.json { "$schema": "https://json.schemastore.org/claude-code-settings.json", "env": { "ANTHROPIC_BASE_URL": "https://api.zukko.pro", "ANTHROPIC_AUTH_TOKEN": "fetch_...", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.8", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5", "DISABLE_TELEMETRY": "1", "DISABLE_ERROR_REPORTING": "1" } } Если settings.json уже есть — вмержите блок env внутрь файла, не затирайте весь конфиг. 3. Что делает этот конфиг Подключение "ANTHROPIC_BASE_URL": "https://api.zukko.pro", "ANTHROPIC_AUTH_TOKEN": "fetch_..." Все запросы идут в Zukko вместо официального эндпоинта Anthropic. Используйте именно ANTHROPIC_AUTH_TOKEN (отправляется как Bearer), а не ANTHROPIC_API_KEY — так Claude Code не будет просить логин в Anthropic. Слоты моделей "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.8", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5" В меню /model у Claude Code три фиксированных слота — Opus, Sonnet, Haiku. Эти переменные переназначают каждый слот на модель Zukko, чтобы стандартный переключатель продолжал работать. Можно указать любой ID из каталога, например закрепить Opus на claude-opus-4.7. Приватность (опционально) DISABLE_TELEMETRY и DISABLE_ERROR_REPORTING отключают аналитику и crash-репорты в Anthropic. На работу агента не влияют — оставляйте или убирайте по желанию. 4. Запуск claude Конфиг подхватывается автоматически. Чтобы проверить связь, задайте любой вопрос — первый ответ подтвердит, что биллинг идёт с баланса Zukko. Модель можно сменить командой /model. 5. Разовый запуск без settings.json Только для быстрой проверки — переменные живут до закрытия терминала. macOS / Linux export ANTHROPIC_BASE_URL="https://api.zukko.pro" export ANTHROPIC_AUTH_TOKEN="fetch_..." claude Windows (PowerShell) $env:ANTHROPIC_BASE_URL = "https://api.zukko.pro" $env:ANTHROPIC_AUTH_TOKEN = "fetch_..." claude 6. Расширение VS Code: один дополнительный шаг 1. Установите расширение Claude Code из Marketplace. 2. Убедитесь, что ~/.claude/settings.json из шага 2 уже есть — расширение читает тот же файл. 3. В настройках VS Code (Ctrl/Cmd + ,) включите Claude Code: Disable Login Prompt, чтобы не предлагался вход в Anthropic. 4. Перезагрузите окно (Developer: Reload Window). 7. Troubleshooting Windows: claude is not recognized Полностью закройте PowerShell и откройте новое окно — обновление PATH не доходит до уже открытых терминалов. Всё ещё не находится? Выполните where.exe claude: если пусто — переустановите Claude Code из шага 1. Claude Code просит войти в Anthropic Значит, токен не виден. Проверьте, что ключ задан как ANTHROPIC_AUTH_TOKEN (не ANTHROPIC_API_KEY) и что settings.json — валидный JSON: лишняя запятая в конце тихо ломает весь файл. Если раньше логинились аккаунтом Anthropic, один раз выполните /logout. 401 invalid_api_key Ключ опечатан, отозван или вокруг него есть пробелы. Ключи показываются один раз при создании — при сомнении выпустите новый на странице ключей (/app/api-keys). 402 / запросы внезапно перестали проходить Почти всегда пустой баланс. Пополните (/app/payments) и повторите — перезапуск не нужен. ---------- OpenCode Провайдер | Base URL | Key --- | --- | --- Anthropic | https://api.zukko.pro | fetch_... ~/.config/opencode/opencode.jsonc: { "provider": { "anthropic": { "options": { "baseURL": "https://api.zukko.pro", "apiKey": "fetch_..." } } } } ---------- Расширения VS Code Сначала провайдер, потом URL и fetch_.... Расширение | Провайдер | Base URL --- | --- | --- Cline | OpenAI Compatible | https://api.zukko.pro/v1 Roo Code | Anthropic | https://api.zukko.pro Kilo Code | OpenAI Compatible | https://api.zukko.pro/v1 ---------- Codex Провайдер: OpenAI. Base URL: https://api.zukko.pro/v1. Key: fetch_.... Автонастройка macOS / Linux curl -fsSL https://zukko.pro/downloads/codex-setup-macos.sh | bash Windows powershell -ExecutionPolicy Bypass -Command "irm https://zukko.pro/downloads/codex-setup-windows.ps1 | iex" Вручную ~/.codex/config.toml: model = "gpt-5.6-terra" model_provider = "zukko" model_reasoning_effort = "high" [model_providers.zukko] name = "zukko" base_url = "https://api.zukko.pro/v1" wire_api = "responses" requires_openai_auth = true ~/.codex/auth.json: { "OPENAI_API_KEY": "fetch_..." } ---------- Агенты Hermes Hermes Agent (https://hermes-agent.nousresearch.com/) → Zukko. Ключ fetch_... с API-ключей (/app/api-keys). Выйди из чата (Ctrl+C / /quit), затем: hermes model В мастере два пункта (выбери один): - Anthropic — Claude models via API key or Claude Code - OpenAI ▸ — Codex CLI or direct OpenAI API Вариант | Что выбрать дальше | Base URL | Ключ --- | --- | --- | --- Anthropic | API key (не Claude Code OAuth) | https://api.zukko.pro | fetch_... OpenAI | direct OpenAI API | https://api.zukko.pro/v1 | fetch_... Codex CLI и Claude Code OAuth — официальные подписки, для Zukko не подходят. Anthropic 1. hermes model → Anthropic 2. Auth: API key → fetch_... 3. Модель, например claude-sonnet-5 4. Base URL в ~/.hermes/config.yaml без /v1 (SDK добавит сам): model: provider: anthropic default: claude-sonnet-5 base_url: https://api.zukko.pro Ключ: ANTHROPIC_API_KEY=fetch_... в ~/.hermes/.env. OpenAI 1. hermes model → OpenAI → direct OpenAI API 2. API key: fetch_... 3. Модель, например claude-sonnet-5 или gpt-5.6-terra 4. Base URL с /v1: ~/.hermes/.env OPENAI_API_KEY=fetch_... OPENAI_BASE_URL=https://api.zukko.pro/v1 Или в config.yaml: model: provider: openai-api default: claude-sonnet-5 base_url: https://api.zukko.pro/v1 Запуск: hermes. В чате смена модели: /model. Если не работает - 401 — проверь ключ fetch_..., без пробелов - 402 — пополни баланс (/app/payments) - 404 на Anthropic — в base_url не должно быть /v1 - OpenAI ходит не туда — нужен https://api.zukko.pro/v1 и провайдер openai-api ---------- OpenClaw OpenClaw (https://docs.openclaw.ai/) → Zukko как custom provider. Конфиг: ~/.openclaw/openclaw.json. Ключ: fetch_... (API-ключи (/app/api-keys)). Нужны оба: models.providers и allowlist agents.defaults.models (иначе будет model not allowed). Вариант | api | baseUrl --- | --- | --- OpenAI Compatible | openai-completions | https://api.zukko.pro/v1 Anthropic Messages | anthropic-messages | https://api.zukko.pro Onboard (OpenAI) npm install -g openclaw openclaw onboard --non-interactive \ --mode local \ --auth-choice custom \ --custom-base-url "https://api.zukko.pro/v1" \ --custom-api-key "fetch_..." \ --custom-model-id "claude-sonnet-5" Если custom нет — те же --custom-* с --auth-choice vllm, либо ручной конфиг ниже. OpenAI Compatible — ~/.openclaw/openclaw.json { models: { mode: "merge", providers: { zukko: { baseUrl: "https://api.zukko.pro/v1", apiKey: "fetch_...", api: "openai-completions", models: [ { id: "claude-sonnet-5", name: "Claude Sonnet 4.6", input: ["text"], contextWindow: 200000, maxTokens: 8192, }, ], }, }, }, agents: { defaults: { model: { primary: "zukko/claude-sonnet-5" }, models: { "zukko/claude-sonnet-5": { alias: "sonnet" }, }, }, }, } openclaw gateway config.apply --file ~/.openclaw/openclaw.json Anthropic Messages — ~/.openclaw/openclaw.json { models: { mode: "merge", providers: { zukko: { baseUrl: "https://api.zukko.pro", apiKey: "fetch_...", api: "anthropic-messages", models: [ { id: "claude-sonnet-5", name: "Claude Sonnet 4.6", input: ["text"], contextWindow: 200000, maxTokens: 8192, }, ], }, }, }, agents: { defaults: { model: { primary: "zukko/claude-sonnet-5" }, models: { "zukko/claude-sonnet-5": { alias: "sonnet" }, }, }, }, } openclaw gateway config.apply --file ~/.openclaw/openclaw.json Если не работает - model not allowed — добавь модель в allowlist: agents.defaults.models["zukko/"] - Нет в /models — проверь и models.providers.zukko, и allowlist - 401 — ключ fetch_... и URL по таблице выше (с /v1 или без) ---------- _Конец базы знаний Zukko API. Источник: https://zukko.pro/docs_