Как проверить API-ключ ИИ с помощью curl и Python

Вот как проверить доступ по AI API-ключу без создания чего-либо: три запроса, около двух минут, и вы узнаете, валиден ли ключ, есть ли на нем средства и разрешено ли генерировать текст.
Ключевые моменты
- Сначала вызовите GET /v1/models: это доказывает, что ключ принят без траты баланса.
- Отправьте один короткий запрос в модель uncensored, чтобы подтвердить работу генерации.
- Прочитайте заголовок X-Balance-USD или GET /v1/balance, чтобы увидеть остаток.
- 401 указывает на ключ, 402 — на баланс, 429 — на частоту ваших запросов.
Трехшаговый тест
Чтобы правильно протестировать API-ключ ИИ, нужно доказать три отдельных факта: сервер принимает ключ, за ключом числится баланс и возвращается реальный ответ. Один вызов на вопрос делает диагностику простой. Если что-то не сработает, вы поймёте, на каком уровне ошибка.
- Список моделей. Аутентифицирует ключ и ничего не стоит.
- Завершение чата. Подтверждает, что модель отвечает и ваш формат запроса верен.
- Баланс. Подтверждает, что осталось после теста.
Всё ниже использует базовый URL https://api.aiapisource.com/v1 и идентификатор модели uncensored. Поместите ваш ключ в переменную окружения, чтобы он никогда не попадал в историю оболочки или репозиторий.
export AIAPI_KEY="paste-your-key-here"
Если у вас ещё нет ключа, на странице API-ключ показано, как его создать. При регистрации новому аккаунту можно одним кликом получить $0,50 пробного баланса — этого более чем достаточно для всех тестов в этой статье.
Шаг 1: список моделей через curl
Самая дешёвая проверка — запрос только на чтение. GET /v1/models возвращает список моделей и требует действительный ключ, поэтому успешный ответ доказывает аутентификацию.
curl -s https://api.aiapisource.com/v1/models \
-H "Authorization: Bearer $AIAPI_KEY"
Корректный ответ — это JSON с массивом data, содержащим uncensored. Если вы видите HTML-страницу, ошибку подключения или пустой ответ, проблема в URL, а не в ключе. Убедитесь, что вы сохранили суффикс /v1 и что после ключа в переменной нет пробела.
Добавьте -i к команде curl, чтобы увидеть заголовки ответа. API отправляет X-Request-Id при каждом вызове. Сохраните это значение, если когда-либо свяжетесь с поддержкой, потому что оно идентифицирует точный запрос.
Шаг 2: отправка одного запроса в чат
Теперь проверьте генерацию. Делайте промпт коротким и ограничивайте вывод, чтобы тест стоил доли цента.
curl -s https://api.aiapisource.com/v1/chat/completions \
-H "Authorization: Bearer $AIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the single word: ready"}],
"max_tokens": 10
}'
Ищите choices[0].message.content и объект usage с prompt_tokens и completion_tokens. Запрос примерно из 20 входных токенов и 5 выходных токенов стоит 20 / 1 000 000 x $0,15 плюс 5 / 1 000 000 x $0,50, что составляет около $0,0000055. Вы можете запустить сотню таких запросов за сумму значительно меньше цента.
Тот же эндпоинт также работает для потоковой передачи: добавьте "stream": true и токены поступают как события, отправляемые сервером. Протестируйте это отдельно, когда базовый вызов заработает.
Шаг 3: тот же тест на Python
Если ваш реальный код использует SDK OpenAI, протестируйте через SDK тоже. Он ловит проблемы, которые curl не покажет, например, когда базовый URL передан в неверный аргумент.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AIAPI_KEY"],
base_url="https://api.aiapisource.com/v1",
)
print([m.id for m in client.models.list().data])
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the single word: ready"}],
max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)
Первый вывод должен показать список, содержащий uncensored. Второй вывод покажет ответ модели. Более подробное руководство по настройке SDK см. в Python-гайде по API OpenAI на этом сайте.
Запустите версию Python из той же оболочки, где вы экспортировали ключ. Если он вызывает KeyError на AIAPI_KEY, переменная не установлена в этой сессии, что является самой частой причиной сбоя теста до того, как он вообще достигнет сети.
Node работает так же: передайте baseURL: "https://api.aiapisource.com/v1" и ключ в конструктор клиента OpenAI.
Проверка баланса
Ключ может быть валидным, но на нем не будет средств. Два способа прочитать баланс:
curl -s https://api.aiapisource.com/v1/balance \
-H "Authorization: Bearer $AIAPI_KEY"
# OpenAI-style alternative
curl -s https://api.aiapisource.com/v1/dashboard/billing/credit_grants \
-H "Authorization: Bearer $AIAPI_KEY"
Каждый ответ также содержит заголовок X-Balance-USD, поэтому вызов чата из шага 2 уже сообщил вам о состоянии оставшегося баланса, если вы выполнили его с флагом -i. В Python SDK OpenAI это доступно через client.chat.completions.with_raw_response.create(...), где вы можете прочитать значение response.headers["X-Balance-USD"].
Неудачные или отклонённые запросы не оплачиваются, поэтому запрос, завершившийся ошибкой, не расходует предоплаченный баланс. Предоплаченный баланс не сгорает, поэтому неиспользованные средства останутся доступны и на следующей неделе.
Чтение кодов ошибок
Когда тест не проходит, HTTP-статус быстро сужает причину.
| Код | Обычное значение | Что делать |
|---|---|---|
| 401 | Ключ отсутствует, введен с ошибкой или отозван | Проверьте заголовок Authorization: Bearer, скопируйте ключ снова, поищите скрытые пробелы или кавычки |
| 402 | Не осталось средств для оплаты запроса | Прочитайте баланс, затем пополните на странице цен |
| 404 | Неверный путь или неверный идентификатор модели | Используйте /v1/chat/completions и модель uncensored |
| 429 | Лимит частоты или параллельности, или кратковременная перегрузка | Подождите и повторите; см. ниже |
429 содержит код ошибки. rate_limited означает слишком много запросов в минуту, а concurrency означает слишком много одновременно. Полный ключ позволяет 300 запросов в минуту и 8 одновременных запросов; пробный ключ позволяет 60 в минуту и 2 одновременно. При временной перегрузке API отвечает 429 с Retry-After: 5, поэтому подождите пять секунд и отправьте запрос снова. Потоковый запрос удерживает свой слот параллельности до завершения потока, что является частой причиной, по которой пробный ключ достигает лимита во время параллельных тестов.
Коды статуса 401, 402 и 404 следуют обычным соглашениям API, поэтому относитесь к таблице как к первой догадке и читайте тело ошибки JSON для точного сообщения.
Скрипт для дымового тестирования
После успешного ручного теста сохраните скрипт, который можно запускать после ротации ключей или смены окружения.
import os, sys
import requests
BASE = "https://api.aiapisource.com/v1"
H = {"Authorization": "Bearer " + os.environ["AIAPI_KEY"]}
m = requests.get(BASE + "/models", headers=H, timeout=15)
print("models", m.status_code)
c = requests.post(
BASE + "/chat/completions",
headers=H,
json={"model": "uncensored",
"messages": [{"role": "user", "content": "ping"}],
"max_tokens": 5},
timeout=60,
)
print("chat", c.status_code, "balance", c.headers.get("X-Balance-USD"))
sys.exit(0 if m.ok and c.ok else 1)
Код выхода позволяет легко встроить проверку в развертывание. Для параметров, выходящих за рамки этого минимума, документация API перечисляет всё, что принимает эндпоинт.
Дополнительные руководства
Вопросы и ответы
Приходится ли платить за тестирование API-ключа?
Список моделей доступен бесплатно. Короткий запрос чата с низким значением max_tokens стоит несколько миллионных долей доллара: $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов. За неудачные запросы плата не взимается.
Как протестировать ключ без карты?
Получите пробный баланс $0,50 на странице API-ключа после входа. Карта не нужна, срок действия — 7 дней, один на человека.
Почему валидный ключ сразу возвращает 429?
Скорее всего, вы превысили лимит параллельных запросов или лимит запросов в минуту. Пробные ключи позволяют выполнять 2 параллельных запроса и 60 запросов в минуту; полные ключи — 8 и 300 соответственно. Проверьте код ошибки, затем снизьте частоту запросов или повторите попытку через несколько секунд.
Могу ли я протестировать ключ в Postman или другом приложении вместо curl?
Да. Любой клиент, совместимый с OpenAI, подойдет: укажите базовый URL как https://api.aiapisource.com/v1, вставьте ключ в качестве токена Bearer и используйте модель uncensored.
Ваш ключ — всего в одной форме
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.