Zukko API — полная база знаний

Сгенерировано с https://zukko.pro/docs — загрузите в ИИ или сохраните как PDF через Печать.

# 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_*`, а все запросы отправляете на единый домен:

```bash
https://api.zukko.pro
```

## Что такое Zukko

Zukko работает как AI gateway: вы подключаете один endpoint, а дальше используете Claude, GPT и другие модели через единый слой доступа, ключей и биллинга.

## Что вы получаете

- один API для нескольких провайдеров;
- единый кабинет и биллинг;
- совместимость с OpenAI-like и Anthropic-like SDK;
- быстрый запуск в IDE, агентах и своих приложениях.

## Базовые URL

```bash
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):

```bash
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_`.

```bash
fetch_xxxxxxxxxxxxxxxxxxxxx
```

## Шаг 2. Укажите base URL

Для OpenAI-compatible клиентов используйте:

```bash
https://api.zukko.pro/v1
```

Для Anthropic-compatible клиентов используйте:

```bash
https://api.zukko.pro
```

## Шаг 3. Отправьте первый запрос

```bash
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_*`.

## Заголовок авторизации

```bash
Authorization: Bearer fetch_YOUR_KEY
```

## Базовые правила

- используйте HTTPS: `https://api.zukko.pro`;
- не передавайте ключ в query string;
- для Anthropic-compatible запросов добавляйте `anthropic-version`;
- один и тот же ключ можно использовать для всех совместимых endpoint'ов.

## Пример

```bash
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.

## Пример запроса

```bash
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`.

## Пример запроса

```bash
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.

## Пример запроса

```bash
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 перед отправкой основного запроса.

## Пример запроса

```bash
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

Возвращает список доступных моделей.

## Пример запроса

```bash
curl https://api.zukko.pro/v1/models \
  -H "Authorization: Bearer fetch_YOUR_KEY"
```

## Когда использовать

- для загрузки каталога моделей;
- для выбора модели в UI;
- для интеграции в IDE и агентов.

---

# GET /v1/models/info

Возвращает расширенную информацию о моделях: описание, провайдера, цены и дополнительные возможности.

## Пример запроса

```bash
curl https://api.zukko.pro/v1/models/info \
  -H "Authorization: Bearer fetch_YOUR_KEY"
```

---

# GET /v1/balance

Возвращает текущий баланс аккаунта.

## Пример запроса

```bash
curl https://api.zukko.pro/v1/balance \
  -H "Authorization: Bearer fetch_YOUR_KEY"
```

---

# GET /v1/usage

Возвращает usage-статистику по аккаунту или ключу.

## Пример запроса

```bash
curl https://api.zukko.pro/v1/usage \
  -H "Authorization: Bearer fetch_YOUR_KEY"
```

---

# POST /v1/responses

Responses-style endpoint для unified generation flow.

## Пример запроса

```bash
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 для запросов с веб-поиском, если такая возможность включена на стороне сервиса.

## Пример запроса

```bash
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 для проверки доступности сервиса.

## Пример запроса

```bash
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**

```bash
curl -fsSL https://claude.ai/install.sh | bash
claude --version
```

**Windows (PowerShell)**

```powershell
irm https://claude.ai/install.ps1 | iex
```

После установки полностью закройте и снова откройте PowerShell, затем проверьте `claude --version`.

Через npm (все платформы):

```bash
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`

```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. Что делает этот конфиг

**Подключение**

```json
"ANTHROPIC_BASE_URL": "https://api.zukko.pro",
"ANTHROPIC_AUTH_TOKEN": "fetch_..."
```

Все запросы идут в Zukko вместо официального эндпоинта Anthropic. Используйте именно `ANTHROPIC_AUTH_TOKEN` (отправляется как Bearer), а не `ANTHROPIC_API_KEY` — так Claude Code не будет просить логин в Anthropic.

**Слоты моделей**

```json
"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. Запуск

```bash
claude
```

Конфиг подхватывается автоматически. Чтобы проверить связь, задайте любой вопрос — первый ответ подтвердит, что биллинг идёт с баланса Zukko. Модель можно сменить командой `/model`.

### 5. Разовый запуск без settings.json

Только для быстрой проверки — переменные живут до закрытия терминала.

**macOS / Linux**

```bash
export ANTHROPIC_BASE_URL="https://api.zukko.pro"
export ANTHROPIC_AUTH_TOKEN="fetch_..."
claude
```

**Windows (PowerShell)**

```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`:

```json
{
  "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**

```bash
curl -fsSL https://zukko.pro/downloads/codex-setup-macos.sh | bash
```

**Windows**

```powershell
powershell -ExecutionPolicy Bypass -Command "irm https://zukko.pro/downloads/codex-setup-windows.ps1 | iex"
```

## Вручную

`~/.codex/config.toml`:

```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`:

```json
{ "OPENAI_API_KEY": "fetch_..." }
```

---

# Агенты

# Hermes

[Hermes Agent](https://hermes-agent.nousresearch.com/) → Zukko. Ключ `fetch_...` с [API-ключей](/app/api-keys).

Выйди из чата (`Ctrl+C` / `/quit`), затем:

```bash
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 добавит сам):

```yaml
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`:

```bash
# ~/.hermes/.env
OPENAI_API_KEY=fetch_...
OPENAI_BASE_URL=https://api.zukko.pro/v1
```

Или в `config.yaml`:

```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)

```bash
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

```json5
{
  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" },
      },
    },
  },
}
```

```bash
openclaw gateway config.apply --file ~/.openclaw/openclaw.json
```

## Anthropic Messages — ~/.openclaw/openclaw.json

```json5
{
  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" },
      },
    },
  },
}
```

```bash
openclaw gateway config.apply --file ~/.openclaw/openclaw.json
```

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

- **model not allowed** — добавь модель в allowlist: `agents.defaults.models["zukko/<id>"]`
- **Нет в /models** — проверь и `models.providers.zukko`, и allowlist
- **401** — ключ `fetch_...` и URL по таблице выше (с `/v1` или без)

---

_Конец базы знаний Zukko API. Источник: https://zukko.pro/docs_