Почему мой API Key недействителен?

Распространенные симптомы ошибок

Когда вы видите сообщения об ошибке вроде этого:

{
  "error": {
    "message": "Incorrect API key provided: sk-QqHvK***...",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Это обычно означает НЕ то, что ваш API Key неверен, а то, что Base URL настроен неверно.

Самая распространенная ошибка: использование Key от APIYI, но отправка запросов на официальный эндпоинт OpenAI https://api.openai.com

Что такое Base URL?

Base URL (Base URL / адрес запроса) — это адрес целевого сервера для API-запросов. Разные поставщики API-сервисов используют разные Base URL.

Base URL и API Key должны совпадать

Провайдер услуг	Base URL	Формат API Key	Совпадает?
APIYI	`https://api.apiyi.com`	`sk-xxxx......`	✅ Верно
Официальный OpenAI	`https://api.openai.com`	`sk-xxxx......`	✅ Верно
❌ APIYI Key	`https://api.openai.com`	`sk-xxxx......`	❌ Неверно
❌ OpenAI Key	`https://api.apiyi.com`	`sk-xxxx......`	❌ Неверно

Ключевой принцип: Используйте Base URL, который соответствует провайдеру вашего API Key.

Корректная конфигурация

Способ 1: Измените Base URL (рекомендуется)

Просто замените endpoint OpenAI на APIYI, оставьте все остальное без изменений:

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-apiyi-key",  # Get Key from APIYI dashboard
    base_url="https://api.apiyi.com/v1"  # Change to APIYI address
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello"}]
)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-apiyi-key',  // Get Key from APIYI dashboard
  baseURL: 'https://api.apiyi.com/v1'  // Change to APIYI address
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello' }]
});

curl https://api.apiyi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-apiyi-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Способ 2: Используйте переменные среды

Установите переменные среды, чтобы вам не нужно было указывать Base URL в коде:

export OPENAI_API_KEY="sk-your-apiyi-key"
export OPENAI_BASE_URL="https://api.apiyi.com/v1"

$env:OPENAI_API_KEY="sk-your-apiyi-key"
$env:OPENAI_BASE_URL="https://api.apiyi.com/v1"

set OPENAI_API_KEY=sk-your-apiyi-key
set OPENAI_BASE_URL=https://api.apiyi.com/v1

Поддерживаемые форматы Base URL

APIYI поддерживает три формата Base URL в зависимости от вашего кода:

Формат 1: С /v1 (рекомендуется)
Формат 2: С /v1/ (завершающий слэш)
Формат 3: Полный путь

https://api.apiyi.com/v1

Сценарий использования: Большинство библиотек автоматически добавляют к Base URL определенные путиПолные примеры запросов:

https://api.apiyi.com/v1/chat/completions
https://api.apiyi.com/v1/models

https://api.apiyi.com/v1/

Сценарий использования: Некоторые фреймворки требуют, чтобы Base URL заканчивался слэшемПолные примеры запросов:

https://api.apiyi.com/v1/chat/completions
https://api.apiyi.com/v1/models

https://api.apiyi.com/v1/chat/completions

Сценарий использования: Прямое использование полного API эндпоинта (например, запросов cURL)

Этот подход обычно используется для запросов cURL или сырых HTTP-запросов через библиотеку, Base URL задавать не нужно

Устранение неполадок

Я подтвердил, что Base URL указан верно, но ошибки все равно возникают

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

Несколько точек настройки: проверьте, не задан ли Base URL в конфигурационных файлах, переменных среды, инициализации кода и т. д.
Прокси или middleware: некоторые инструменты прокси могут перенаправлять запросы
Проблемы с кэшем: перезапустите программу или очистите кэш и повторите попытку
Опечатка: убедитесь, что apiyi написано правильно (не apiyii и не apiyl)

Как проверить, что мой Key действителен?

Проверьте в панели APIYI:

Войдите в панель APIYI console.apiyi.com
Откройте страницу “Tokens”
Проверьте, что статус Key — “Enabled”
Убедитесь, что на аккаунте достаточно баланса

Как настроить сторонние инструменты (например, ChatBox, OpenCat)?

В большинстве сторонних инструментов есть параметры “Custom API” или “Self-hosted Server”:

Адрес API / Base URL: https://api.apiyi.com/v1
API Key: скопируйте свой ключ из панели APIYI
Model Name: сверяйтесь со списком моделей в документации APIYI

Параметры настройки обычно находятся в разделах “Settings” → “API” или “Server”

Где найти примеры кода?

APIYI предоставляет полные примеры кода на нескольких языках:

Документация Quick Start: Главная страница → Примеры кода
Онлайн-инструмент для тестирования: Панель → ApiFox Online Testing
Репозиторий GitHub: github.com/apiyi/docs → каталог knowledge-base

Неверные и правильные примеры

❌ Неверная конфигурация

client = OpenAI(
    api_key="sk-apiyi-key",
    base_url="https://api.openai.com/v1"
    # ❌ Using OpenAI official endpoint
)

Результат: Сервер OpenAI отклонит ключ APIYI

✅ Правильная конфигурация

client = OpenAI(
    api_key="sk-apiyi-key",
    base_url="https://api.apiyi.com/v1"
    # ✅ Using APIYI endpoint
)

Результат: Запрос успешно отправлен на сервер APIYI

Метод быстрой проверки

Используйте команду cURL, чтобы быстро проверить вашу конфигурацию:

curl https://api.apiyi.com/v1/models \
  -H "Authorization: Bearer sk-your-apiyi-key"

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

{
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      ...
    }
  ]
}

Если вы получаете ошибку, проверьте:

API Key скопирован правильно (обратите внимание на пробелы в начале/конце)
Сетевое подключение работает
На аккаунте достаточно баланса

Сопутствующая документация

Помните основной принцип: Сопоставьте URL с провайдером ключа. Ключ APIYI использует https://api.apiyi.com/v1

Что делать, если вы забыли пароль?Как удалить учетную запись?

Возможности сайта

Модели и API

Tokens и журналы

Корпоративные услуги

Оплата и безопасность

Сеть и подключение

Аккаунт и вход

Почему мой API Key недействителен?

Распространенные симптомы ошибок

Что такое Base URL?

Base URL и API Key должны совпадать

Корректная конфигурация

Способ 1: Измените Base URL (рекомендуется)

Способ 2: Используйте переменные среды

Поддерживаемые форматы Base URL

Устранение неполадок

Неверные и правильные примеры

❌ Неверная конфигурация

✅ Правильная конфигурация

Метод быстрой проверки

Сопутствующая документация

​Распространенные симптомы ошибок

​Что такое Base URL?

​Base URL и API Key должны совпадать

​Корректная конфигурация

​Способ 1: Измените Base URL (рекомендуется)

​Способ 2: Используйте переменные среды

​Поддерживаемые форматы Base URL

​Устранение неполадок

​Неверные и правильные примеры

❌ Неверная конфигурация

✅ Правильная конфигурация

​Метод быстрой проверки

​Сопутствующая документация

Распространенные симптомы ошибок

Что такое Base URL?

Base URL и API Key должны совпадать

Корректная конфигурация

Способ 1: Измените Base URL (рекомендуется)

Способ 2: Используйте переменные среды

Поддерживаемые форматы Base URL

Устранение неполадок

Неверные и правильные примеры

Метод быстрой проверки

Сопутствующая документация