Шаг 1. Создайте аккаунт и получите ключ
Зарегистрируйтесь на странице velourapi.ru/register. Новый аккаунт получает приветственный $1 на самые доступные модели, этого хватает, чтобы всё проверить. Затем откройте раздел «Ключи API» в кабинете и нажмите «Новый ключ».
Ключ можно ограничить: задать потолок расходов, срок действия и список моделей. Для каждого приложения лучше создавать свой ключ: так видно, где тратятся деньги, а утечка одного ключа не затронет остальные.
Шаг 2. Укажите адрес сервера
Velour повторяет формат OpenAI, поэтому достаточно заменить base_url. Адрес API: https://api.velourapi.ru/v1.
from openai import OpenAI
client = OpenAI(api_key="ВАШ_КЛЮЧ", base_url="https://api.velourapi.ru/v1")
answer = client.chat.completions.create(
model="gpt-6.1-sol",
messages=[{"role": "user", "content": "Объясни, что такое токен, в двух предложениях."}],
)
print(answer.choices[0].message.content)То же самое через curl:
curl https://api.velourapi.ru/v1/chat/completions \
-H "Authorization: Bearer $VELOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "Привет!"}]}'Шаг 3. Выберите модель
Название модели передаётся в поле model. Список доступных моделей с ценами лежит в каталоге: текстовые, для картинок, видео и звука. Если сомневаетесь, какая подойдёт, опишите задачу в подборе по задаче — ассистент предложит модели и посчитает цену.
Смена модели — это смена одной строки. Можно начать с дешёвой модели, а для сложных запросов переключаться на сильную, не переписывая интеграцию.
Что ещё поддерживается
- Потоковые ответы (
stream: true) и вызов инструментов (tool calling); - Формат Anthropic для моделей Claude: подойдёт для Claude Code и SDK Anthropic;
- Картинки и видео через
/v1/images/generationsи/v1/videos; - Ограничения ключа: сумма, срок, список моделей, IP-адреса.
Частые ошибки при подключении
- 401 Unauthorized: ключ скопирован не полностью или с пробелом. Ключи начинаются с
sk-. - Модель не найдена: имя написано с ошибкой. Копируйте его из каталога кнопкой рядом с названием.
- 402 или «недостаточно средств»: закончился баланс или исчерпан лимит самого ключа.
- Старый адрес: если в коде остался
api.openai.com, запросы уйдут не к нам.
Частые вопросы
Нужен ли VPN?
Нет. Velour доступен напрямую, вы обращаетесь к одному адресу и не настраиваете доступ к каждому провайдеру отдельно.
Можно ли использовать готовые библиотеки?
Да. Подойдёт любая библиотека, которая умеет работать с OpenAI API: достаточно изменить base_url и ключ.