Что такое Base URL/Model ID/Token? Примеры настройки + типичные ошибки (обязательно для новичков 2026)

Введение

При настройке AI-клиента 90% новичков сталкиваются с тремя терминами: Base URL (адрес интерфейса), Model ID (название модели), Token (единица измерения). Неправильный Base URL вернет 404, неправильный Model ID выдаст "модель не найдена", непонимание Token приведет к неконтролируемым расходам. Эта статья объясняет простым языком и примерами эти три концепции, дает правильные примеры настройки OpenAI/Claude/агрегаторов и предоставляет контрольный список для диагностики распространенных ошибок 401/404/model not found, проверено в августе 2026 года.

Подготовка

Перед началом вам нужно:

Подготовить аккаунт
- Зарегистрирован аккаунт у какого-либо провайдера API
- Создан API Key (если не создан, см. Руководство по созданию API Key)
Подготовить клиент
- Установлен ChatBox, Cherry Studio или другой клиент
- Или готовы настроить вызов API в коде
Ожидаемое время
Чтение статьи 8 минут, завершение настройки 5-10 минут

Base URL: Адрес для отправки запросов

Что такое Base URL

Определение: Базовый адрес API, клиент отправляет запросы на этот адрес.

Аналогия:

Base URL = адрес главного офиса курьерской компании
Конкретный путь интерфейса = определенный отдел внутри офиса
Полный адрес запроса = адрес офиса + название отдела

Пример:

Base URL: https://api.openai.com/v1
Конкретный интерфейс: /chat/completions
Полный адрес: https://api.openai.com/v1/chat/completions

Клиент автоматически объединяет, вам нужно только заполнить Base URL.

Base URL распространенных платформ

Официальные API:

Платформа	Base URL	Примечание
OpenAI	`https://api.openai.com/v1`	Включает `/v1`
Anthropic (Claude)	`https://api.anthropic.com/v1`	Включает `/v1`
Google Gemini	`https://generativelanguage.googleapis.com/v1`	Включает `/v1`

Примеры агрегаторов:

Провайдер	Base URL	Примечание
H API	`https://api.h-api.com/v1`	Совместимо с форматом OpenAI
Провайдер B	`https://api.providerb.com/v1`	Совместимо с форматом OpenAI

⚠️ Требуется ручное копирование: Не угадывайте, обязательно скопируйте из документации провайдера

Где скопировать Base URL

Метод 1: Документация провайдера (рекомендуется)

Войдите на сайт провайдера
Найдите "Документация разработчика" или "API Документация"
Найдите раздел "Base URL" или "Адрес интерфейса"
Скопируйте полный адрес

Метод 2: Страница консоли

Войдите в консоль
Найдите "Управление API" или "Быстрый старт"
Обычно есть поле "Base URL" или "Адрес интерфейса"
Нажмите кнопку "Копировать"

Пример интерфейса настройки ChatBox:

┌─────────────────────────────────────┐
│ Конфигурация провайдера              │
├─────────────────────────────────────┤
│ Адрес интерфейса (Base URL):        │
│ https://api.openai.com/v1           │
│                                     │
│ API Key:                            │
│ sk-xxxxxxxxxxxxx                    │
│                                     │
│ Модель:                             │
│ gpt-4-turbo-2024-04-09              │
└─────────────────────────────────────┘

Частые ошибки

Ошибка 1: Указан адрес консоли

❌ Ошибка: https://console.openai.com
❌ Ошибка: https://h-api.com/dashboard
✅ Правильно: https://api.openai.com/v1
✅ Правильно: https://api.h-api.com/v1

Проявление: Возврат 404 или HTML-содержимое веб-страницы

Ошибка 2: Пропущен /v1

❌ Ошибка: https://api.openai.com
✅ Правильно: https://api.openai.com/v1

Проявление: Возврат 404 Not Found

Ошибка 3: Лишний слэш

⚠️ Возможна проблема: https://api.openai.com/v1/
✅ Рекомендуется: https://api.openai.com/v1

Проявление: Большинство клиентов обработают автоматически, но некоторые могут выдать ошибку

Ошибка 4: HTTP vs HTTPS

❌ Ошибка: http://api.openai.com/v1
✅ Правильно: https://api.openai.com/v1

Проявление: Сбой подключения или предупреждение о небезопасности

Проверка правильности Base URL

Метод 1: Доступ через браузер (быстрая проверка)

Скопируйте Base URL
Вставьте в адресную строку браузера
Наблюдайте результат

Нормальное явление:

Отображается ошибка в формате JSON (например, {"error": "unauthorized"})
Означает, что адрес правильный, просто нет прав

Аномальное явление:

Отображается "Не удается получить доступ к этому сайту": Неверный адрес или проблема сети
Отображается веб-содержимое: Это адрес консоли, а не адрес API

Метод 2: Тест с curl (точная проверка)

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer sk-ваш-ключ"

Нормальный возврат:

{
  "data": [
    {"id": "gpt-4-turbo-2024-04-09", ...},
    {"id": "gpt-3.5-turbo", ...}
  ]
}

Аномальный возврат:

404: Неверный Base URL
401: Неверный API Key

Model ID: Какую модель вызывать

Что такое Model ID

Определение: Уникальный идентификатор модели, используемый для указания серверу, какую модель вы хотите использовать.

Важно: Model ID ≠ Отображаемое имя на странице

Отображаемое имя	Фактический Model ID
GPT-4 Turbo	`gpt-4-turbo-2024-04-09`
GPT-4	`gpt-4-0613`
Claude Sonnet 3.5	`claude-3-5-sonnet-20240620`
Claude Opus 3	`claude-3-opus-20240229`

Model ID распространенных платформ

OpenAI:

Модель	Model ID	Примечание
GPT-4 Turbo (последняя)	`gpt-4-turbo`	Автоматически указывает на последнюю версию
GPT-4 Turbo (фиксированная версия)	`gpt-4-turbo-2024-04-09`	Фиксированная версия, не изменится
GPT-4	`gpt-4-0613`	Старая версия GPT-4
GPT-3.5 Turbo	`gpt-3.5-turbo`	Автоматически указывает на последнюю версию

Anthropic (Claude):

Модель	Model ID	Примечание
Claude Sonnet 3.5	`claude-3-5-sonnet-20240620`	Последняя версия Sonnet
Claude Opus 3	`claude-3-opus-20240229`	Самая мощная версия Opus
Claude Haiku 3	`claude-3-haiku-20240307`	Самая быстрая версия Haiku

Агрегаторы:

Отображаемое имя	Возможный Model ID	Примечание
GPT-4	`gpt-4` или `gpt-4-turbo`	Может отличаться на разных платформах
GPT-4 Turbo	`gpt-4-turbo` или `gpt-4-turbo-2024-04-09`	-

Где скопировать Model ID

Метод 1: Список моделей в клиенте (рекомендуется)

Откройте настройки клиента
Найдите опцию "Модель" или "Model"
Нажмите "Обновить список моделей" или "Получить доступные модели"
Выберите из выпадающего списка

Пример ChatBox:

┌─────────────────────────────────────┐
│ Выбор модели                        │
├─────────────────────────────────────┤
│ [Выпадающее меню]                   │
│   gpt-4-turbo-2024-04-09            │
│   gpt-4-0613                        │
│   gpt-3.5-turbo                     │
│   claude-3-5-sonnet-20240620        │
└─────────────────────────────────────┘

Метод 2: Консоль провайдера

Войдите в консоль
Найдите "Доступные модели" или "Список моделей"
Скопируйте полный Model ID (включая номер версии и дефисы)

Метод 3: Запрос API (для разработчиков)

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer sk-ваш-ключ"

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

Частые ошибки

Ошибка 1: Указано только сокращение

❌ Ошибка: gpt4
❌ Ошибка: GPT-4
✅ Правильно: gpt-4-turbo-2024-04-09

Проявление: model not found

Ошибка 2: Ошибка в регистре

❌ Ошибка: GPT-4-Turbo
✅ Правильно: gpt-4-turbo

Проявление: model not found (Model ID чувствителен к регистру)

Ошибка 3: Пропущен номер версии

⚠️ Возможна проблема: gpt-4
✅ Рекомендуется: gpt-4-turbo-2024-04-09

Объяснение:

gpt-4 может указывать на старую версию
gpt-4-turbo-2024-04-09 точно указывает версию

Ошибка 4: Model ID агрегатора несовместим

Некоторые агрегаторы для упрощения могут использовать собственный Model ID:

Официальный Model ID	Model ID агрегатора
`gpt-4-turbo-2024-04-09`	`gpt-4-turbo` или `gpt4-turbo`
`claude-3-5-sonnet-20240620`	`claude-3.5-sonnet`

Решение: Проверьте документацию или консоль данного агрегатора.

Проверка правильности Model ID

Метод: Отправка тестового запроса

curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-ваш-ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4-turbo-2024-04-09",
    "messages": [{"role": "user", "content": "привет"}]
  }'

Нормальный возврат:

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Привет! Чем могу помочь?"
      }
    }
  ]
}

Аномальный возврат:

{
  "error": {
    "message": "The model 'gpt-4-turbo' does not exist",
    "type": "invalid_request_error"
  }
}

Означает, что Model ID неверен или нет прав.

Token: Единица для подсчета использования текста

Что такое Token

Определение: Минимальная единица при обработке текста моделью, похожа на "символ", но не совсем то же самое.

Аналогия:

Token = блок LEGO
Текст = произведение, собранное из блоков
Обработка модели = подсчет количества блоков

Китайский vs Английский:

Язык	Текст	Количество токенов
Английский	"Hello world"	2 токена
Китайский	"你好世界"	4-6 токенов

Почему китайского больше:

Английский: Одно слово обычно = 1 токен
Китайский: Один иероглиф обычно = 1.5-2 токена (зависит от модели)

Правила подсчета токенов

Токены ввода = контент, который вы отправляете:

Контент	Учитывается ли
Ваш вопрос	✅ Да
История диалога (контекст)	✅ Да
Системный промпт (System Prompt)	✅ Да
Вложения (изображения/файлы)	✅ Да (рассчитывается по размеру)

Токены вывода = контент, возвращенный моделью:

Контент	Учитывается ли
Ответ модели	✅ Да

Общие токены = Токены ввода + Токены вывода

Реальные случаи

Случай 1: Короткий диалог

Пользователь: Какая столица Китая?
Модель: Пекин.

Статистика токенов:

Ввод: около 10 токенов
Вывод: около 3 токенов
Всего: около 13 токенов

Стоимость (GPT-4 Turbo):

Ввод: 10 × $10/1M = $0.0001
Вывод: 3 × $30/1M = $0.00009
Всего: около $0.00019 (около ¥0.0014)

Случай 2: Длинный диалог (с историей)

[Раунд 1]
Пользователь: Расскажи о Пекине.
Модель: [Ответ на 500 символов]

[Раунд 2]
Пользователь: Какой там климат?
Модель: [Ответ на 300 символов]

Статистика токенов (Раунд 2):

Ввод:
- Сообщение пользователя раунда 1: около 50 токенов
- Ответ модели раунда 1: около 700 токенов
- Сообщение пользователя раунда 2: около 30 токенов
- Всего: около 780 токенов
Вывод: около 400 токенов
Всего раунда 2: около 1180 токенов

Стоимость:

Ввод: 780 × $10/1M = $0.0078
Вывод: 400 × $30/1M = $0.012
Всего: около $0.0198 (около ¥0.14)

Ключевое наблюдение: Стоимость раунда 2 намного выше раунда 1, потому что включает историю диалога!

Как просмотреть количество токенов

Метод 1: Отображение в клиенте

Большинство клиентов отображают под диалогом:

📊 Расход: ввод 780 токенов, вывод 400 токенов, всего 1180 токенов
💰 Стоимость: ¥0.14

Метод 2: Счет провайдера

Войдите в консоль
Проверьте "Счета" или "Статистика использования"
Каждый запрос имеет детальное количество токенов

Метод 3: Онлайн-инструмент (оценка)

OpenAI Tokenizer
Введите текст, отображается количество токенов в реальном времени

Как уменьшить потребление токенов

Совет 1: Ограничьте количество раундов истории диалога

❌ Сохранить всю историю (100 раундов)
✅ Сохранить только последние 10 раундов

Настройка ChatBox:

Настройки → Диалог → Максимальное количество раундов истории: 10

Совет 2: Сокращайте промпты

❌ Многословно: "Пожалуйста, как профессиональный переводчик, используя очень идиоматичный китайский, переведите следующий английский..."
✅ Кратко: "Переведи на китайский:"

Совет 3: Ограничьте длину вывода

❌ "Подробно расскажи о Пекине"
✅ "Расскажи о Пекине в 100 словах"

Совет 4: Используйте более дешевую модель

Модель	Цена ввода	Цена вывода	Подходящий сценарий
GPT-3.5 Turbo	$0.50/M	$1.50/M	Простые вопросы, перевод
GPT-4 Turbo	$10/M	$30/M	Сложные рассуждения, код

Простые задачи используйте GPT-3.5, сложные — GPT-4.

Как три элемента работают вместе

Полный процесс запроса

1. Вы вводите вопрос в клиенте: "Какая столица Китая?"
   ↓
2. Клиент строит запрос:
   - Base URL: https://api.openai.com/v1/chat/completions
   - API Key: sk-xxxxx (в заголовке запроса)
   - Model ID: gpt-4-turbo-2024-04-09
   - Содержание сообщения: "Какая столица Китая?"
   ↓
3. Отправка на сервер
   ↓
4. Обработка на сервере:
   - Проверка API Key: ✅ Действителен
   - Поиск модели: ✅ gpt-4-turbo-2024-04-09 существует
   - Подсчет токенов ввода: 10 токенов
   - Вызов модели для генерации ответа
   - Подсчет токенов вывода: 3 токена
   ↓
5. Возврат результата: "Пекин."
   ↓
6. Списание:
   - Ввод: 10 × $10/1M = $0.0001
   - Вывод: 3 × $30/1M = $0.00009
   - Списание с баланса аккаунта

Аналогия: Заказ еды

Концепция API	Аналогия с заказом еды
Base URL	Адрес ресторана
API Key	Номер вашей карты лояльности
Model ID	Название блюда (свинина в кисло-сладком соусе)
Содержание сообщения	Примечания (меньше сахара, меньше соли)
Token	Количество ингредиентов (сколько килограммов мяса)
Стоимость	Сумма счета

Контрольный список при ошибках настройки

Ошибка 1: 401 Unauthorized

Проявление:

{"error": {"message": "Incorrect API key", "type": "invalid_request_error"}}

Возможные причины:

Неверный или истекший API Key
Пробелы до или после API Key
API Key отключен

Шаги диагностики:

Повторно скопируйте API Key (удалите пробелы)
Проверьте, нормален ли статус аккаунта
Попробуйте заново создать ключ

Ошибка 2: 404 Not Found

Проявление:

{"error": "Not Found"}

Или возврат HTML-содержимого веб-страницы.

Возможные причины:

Неверный Base URL
Пропущен /v1
Указан адрес консоли

Шаги диагностики:

Проверьте, включает ли Base URL /v1
Зайдите на Base URL через браузер, должна вернуться JSON-ошибка, а не веб-страница
Повторно скопируйте из документации провайдера

Ошибка 3: Model not found

Проявление:

{"error": {"message": "The model 'gpt-4-turbo' does not exist"}}

Возможные причины:

Ошибка в написании Model ID
Ошибка в регистре
Провайдер не поддерживает эту модель
Аккаунт не имеет прав на использование этой модели

Шаги диагностики:

Выберите из "Списка моделей" клиента (не вводите вручную)
Проверьте, учитывается ли регистр
Проверьте список доступных моделей провайдера
Попробуйте сменить на базовую модель (например, gpt-3.5-turbo)

Ошибка 4: Баланс падает слишком быстро

Проявление:

После отправки нескольких сообщений баланс уменьшился на ¥10+

Возможные причины:

Сохранено большое количество истории диалога
Использована дорогая модель (например, GPT-4)
Длина вывода слишком велика
Вложения слишком большие (изображения/файлы)

Шаги диагностики:

Проверьте счет, подтвердите количество токенов
Ограничьте количество раундов истории (установите 5-10 раундов)
Смените на более дешевую модель для теста (например, GPT-3.5)
Ограничьте длину вывода (укажите в промпте "ответь в 100 словах")

Часто задаваемые вопросы

Q1: Нужно ли добавлять слэш `/` в конце Base URL?

A: Рекомендуется не добавлять

✅ Рекомендуется: https://api.openai.com/v1
⚠️ Возможна проблема: https://api.openai.com/v1/

Большинство клиентов обработают автоматически, но некоторые могут выдать ошибку.

Q2: Можно ли сокращать Model ID?

A: Зависит от провайдера

Официальный OpenAI: gpt-4-turbo автоматически укажет на последнюю версию
Агрегаторы: Может требоваться полный Model ID

Рекомендация: Используйте полный Model ID (включая дату), это точнее.

Q3: Можно ли заранее узнать количество токенов?

A: Можно оценить

Метод 1: Используйте инструмент OpenAI Tokenizer
Метод 2: Грубая оценка
- Английский: 1 слово ≈ 1 токен
- Китайский: 1 символ ≈ 1.5-2 токена

Q4: Одинаков ли способ подсчета токенов для разных моделей?

A: ❌ Не совсем одинаков

Серия GPT: Использует BPE (Byte Pair Encoding)
Серия Claude: Использует похожий, но не полностью идентичный способ

Реальный тест (одинаковый текст):

GPT-4: около 100 токенов
Claude Sonnet: около 105 токенов

Разница около 5%, небольшая.

Объяснение стоимости

Чтение статьи: бесплатно
Тестовая настройка: около ¥0.01-0.05 (отправка нескольких тестовых сообщений)

Напоминания о безопасности

Не раскрывайте API Key
Base URL и Model ID можно публиковать, но API Key абсолютно нельзя раскрывать
Копируйте конфигурацию из официальной документации
Не угадывайте Base URL или Model ID наугад
Контролируйте потребление токенов
Ограничьте количество раундов истории, сокращайте промпты, ограничивайте длину вывода
Регулярно проверяйте счета
Проверяйте раз в неделю, при обнаружении аномалий немедленно обрабатывайте
Подготовьте резервную конфигурацию
Записывайте конфигурации основного и резервного провайдеров, переключайтесь при сбое одного

Дата обновления: 2026-08-14
Тестовые платформы: OpenAI, Anthropic, 3 агрегатора
Тестовые инструменты: ChatBox, curl, OpenAI Tokenizer

Введение

Подготовка

Base URL: Адрес для отправки запросов

Что такое Base URL

Base URL распространенных платформ

Где скопировать Base URL

Частые ошибки

Проверка правильности Base URL

Model ID: Какую модель вызывать

Что такое Model ID

Model ID распространенных платформ

Где скопировать Model ID

Частые ошибки

Проверка правильности Model ID

Token: Единица для подсчета использования текста

Что такое Token

Правила подсчета токенов

Реальные случаи

Как просмотреть количество токенов

Как уменьшить потребление токенов

Как три элемента работают вместе

Полный процесс запроса

Аналогия: Заказ еды

Контрольный список при ошибках настройки

Ошибка 1: 401 Unauthorized

Ошибка 2: 404 Not Found

Ошибка 3: Model not found

Ошибка 4: Баланс падает слишком быстро

Часто задаваемые вопросы

Q1: Нужно ли добавлять слэш `/` в конце Base URL?

Q2: Можно ли сокращать Model ID?

Q3: Можно ли заранее узнать количество токенов?

Q4: Одинаков ли способ подсчета токенов для разных моделей?

Объяснение стоимости

Напоминания о безопасности

Похожие статьи

Что делать после утечки API Key? Экстренный чек-лист из 5 шагов (проверено 2026)

Как выбрать AI модель? Экономьте, выбирая по типу задачи (сравнение 2026)

Что делать, если вызов API не работает? 5 шагов для быстрой диагностики (2026)

Введение

Подготовка

Base URL: Адрес для отправки запросов

Что такое Base URL

Base URL распространенных платформ

Где скопировать Base URL

Частые ошибки

Проверка правильности Base URL

Model ID: Какую модель вызывать

Что такое Model ID

Model ID распространенных платформ

Где скопировать Model ID

Частые ошибки

Проверка правильности Model ID

Token: Единица для подсчета использования текста

Что такое Token

Правила подсчета токенов

Реальные случаи

Как просмотреть количество токенов

Как уменьшить потребление токенов

Как три элемента работают вместе

Полный процесс запроса

Аналогия: Заказ еды

Контрольный список при ошибках настройки

Ошибка 1: 401 Unauthorized

Ошибка 2: 404 Not Found

Ошибка 3: Model not found

Ошибка 4: Баланс падает слишком быстро

Часто задаваемые вопросы

Q1: Нужно ли добавлять слэш / в конце Base URL?

Q2: Можно ли сокращать Model ID?

Q3: Можно ли заранее узнать количество токенов?

Q4: Одинаков ли способ подсчета токенов для разных моделей?

Объяснение стоимости

Напоминания о безопасности

Похожие статьи

Что делать после утечки API Key? Экстренный чек-лист из 5 шагов (проверено 2026)

Как выбрать AI модель? Экономьте, выбирая по типу задачи (сравнение 2026)

Что делать, если вызов API не работает? 5 шагов для быстрой диагностики (2026)

Q1: Нужно ли добавлять слэш `/` в конце Base URL?