DocsВведениеДля чайников

Для чайников

Введение

Это самый простой разбор: что такое Zukko, куда стучаться и как не запутаться.

Одной фразой

Zukko — это «розетка» для ИИ. Вы один раз подключаете адрес api.zukko.pro и ключ fetch_..., а дальше можете звать Claude, GPT и другие модели как будто это один провайдер.

Три вещи, которые нужно знать

  1. Ключ — секретный пароль вида fetch_xxxxx. Берёте в кабинете → API keys. Никому не светите.
  2. Адрес APIhttps://api.zukko.pro. Это сервер Zukko, не Anthropic и не OpenAI напрямую.
  3. Модель — строка вроде claude-sonnet-5 или gpt-4o. Пишете в поле model запроса.

Какой URL ставить

Зависит от того, чем вы пользуетесь:

Чем пользуетесьBase URL
Cursor / OpenAI SDK / большинство IDEhttps://api.zukko.pro/v1
Claude Code / Anthropic SDKhttps://api.zukko.pro

Оба варианта идут в один и тот же Zukko. Разница только в формате запроса (OpenAI-style vs Anthropic-style).

Первый запрос без боли

  1. Зарегистрируйтесь на 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.

Дальше: Быстрый старт или гайд под вашу IDE в меню слева.

Для чайников