Быстрый старт с curl

Проверьте весь маршрут минимальным запросом OpenAI compatible.

Подготовка

• Подготовьте YOUR_API_KEY на странице ключей.
• Выберите доступную модель на странице моделей и цен и подставьте её вместо YOUR_MODEL.
• Убедитесь, что сеть открывает https://api.popgo.site.

Актуальные модели и цены

Проверка перед подключением

• Сначала замените только YOUR_API_KEY и YOUR_MODEL. Не меняйте одновременно путь, протокол и расширенные параметры клиента.
• Если приложение просит Base URL, введите корневой или /v1 уровень из руководства. Полный Endpoint нужен только когда приложение прямо этого требует.
• Получите один успешный ответ quickstart, затем перенесите те же Key, модель и адрес в клиент.

Выбор адреса и endpoint по протоколу

Клиенты OpenAI compatible обычно используют Base URL /v1. Claude Messages и нативный Gemini используют корневой адрес, после чего клиент или полный Endpoint добавляет путь протокола.

Полный список публичных endpoint смотрите в API Reference. Видео-задачи и медиа-параметры описаны в разделе Генерация изображений и видео.

Подготовка локальной среды

Если вы запускаете CLI, скрипт или инструмент, которому нужен Node.js, сначала установите Node.js и npm. Проверьте версии в том же терминале, из которого будет запущен инструмент:

node --version
npm --version

• Windows: используйте официальный установщик или менеджер пакетов для версии Node.js LTS.
• macOS: используйте официальный установщик или Homebrew.
• Linux/WSL2: используйте менеджер пакетов дистрибутива или рекомендованный способ установки Node.js.
• Если команда всё ещё не найдена, закройте старый терминал и откройте новый, чтобы загрузить обновлённый PATH.

Отправка запроса

Запрос использует OpenAI compatible Base URL.

curl https://api.popgo.site/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [
      {"role": "user", "content": "Подтвердите подключение"}
    ]
  }'

Признак успеха

Успешный HTTP-статус и содержимое ответа подтверждают Base URL, ключ и модель. При ошибке перейдите к соответствующему коду в разделе устранения неполадок.

Следующий шаг

Откройте руководство OpenAI, Claude или Gemini, которое поддерживает клиент, либо выберите интеграцию.