Туториал по Baiyun API: быстро начать
От входа, депозита и создания ключей к первому запросу открытого текста API. Включает полные этапы инспекции, практическую проверку и устранение ошибок.
Давайте начнём
Эта страница помогает начать пользоваться сайтом через чат или через API-вызовы. Текущий спектр услуг следующий:Полные, проверяемые запросы в открытом тексте。
Попробуйте это на сайте
- Зарегистрируйтесь или войдите в этот аккаунт.
- ОткрытьКошелёкПосле подтверждения суммы Doken (WordKnife, DK) и фактической суммы выплаты в юане, пополните деньги через Alipay или WeChat; Текущая цена единицы — 0,30 юаня/DK.
- ОткрытьОпыт общенияВыберите открытую модель и сначала задайте короткий, обычный текстовый вопрос.
- СуществуютПульт управленияПросмотр записей об использовании и потреблении.
В настоящее время потребление зависит от баланса; подписка на членство не требуется. Пожалуйста, прочитайте перед тем, как подзарядиться или закрыть игруПравила использования。
Создайте ключ вызова для приложения
СуществуютУправление ключамиСоздавать API-ключи для вызовов моделей; Устанавливайте баланс и лимиты модели в соответствии с реальными потребностями и храните их правильно после сохранения.
Приложение используетКлюч вызова модели, а не пароль для входа в веб-систему. Не вводите ключи в публичный код, скриншоты, чат или интерфейс, доступный в браузере. Утекшие ключи должны быть отозваны и воссозданы в управлении ключами.
Настройте клиент
| Элементы конфигурации | Текущий заполненный контент |
|---|---|
| API Base URL | https://api.baiyun.si/v1 |
| API Key | Ключ вызова, созданный управлением ключами сайта |
| Модель | Например, gpt-6-Luna; Точный список см. Model Square |
| Интерфейс | Текстовый режим для завершения или ответов в чате |
Разные клиенты определяют адреса по-разному: заполните его Base URL Обычно он сохраняется в это время /v1； Если вам нужно указать полный адрес в чате, пожалуйста, заполните его https://api.baiyun.si/v1/chat/completions。 Не убирайте её /v1 Повторяйте склеивание дважды. Не все клиенты, плагины и функции совместимы по умолчанию.
Первый запрос API
Установите переменные среды на локальном терминале, чтобы избежать входа в общий терминал или экран записи при вводе ключа:
read -r -s -p '请输入本站 API 密钥：' BAIYUN_API_KEY
printf '\n'
export BAIYUN_API_KEY
curl --fail-with-body https://api.baiyun.si/v1/chat/completions \
-H "Authorization: Bearer $BAIYUN_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt-6-luna",
"messages": [{"role": "user", "content": "你好，请用一句话介绍你能帮我做什么。"}],
"stream": false
}'Успешный запрос возвращает сгенерированный текст и информацию об использовании, а остаток DK вычитается из указанной референсной цены единицы. 1 DK относится к партии токенов, оценённых в 1 USD согласно выбранным коммерческим API-эталонным котировкам, а не фиксированным количеству токенов или наличных, конвертируемых в доллары США. Вышеуказанные обычные запросы также создают небольшое количество потребления.
Текущая цена 0,30 юаня/DK — это цена пополнения на этом сайте, а не точная стоимость подписки, подтвержденная реальным тестированием; Эталонная стоимость и стоимость подписки для той же партии токенов отображаются в конвертации в юань или JPYТрёхэтапные инструкции по выставлению счетов。
Если хотите получать выход непрерывно, проверьтеПример потоковой передачи чата； При использовании Responses приложение может его просматриватьПримеры ответов。
Проверьте модели для вызова
Интерфейс списка моделей также требует аутентификации ключей:
curl --fail-with-body https://api.baiyun.si/v1/models \
-H "Authorization: Bearer $BAIYUN_API_KEY"Преобладает модель, которая фактически возвращает текущий ключ. Если модели отсутствует или она недоступна, пожалуйста, проверьте название модели, лимиты ключей и баланс, и не повторяйте неподдерживаемые запросы.
Контрольный список перед практическим применением
- Подготовьте свой собственный аккаунт и ключи доступа, и не используйте общие учетные данные других.
- Записывает клиентские версии, системы и модели для удобства воспроизведения при устранении неполадок.
- Сохраните оригинальную конфигурацию или скриншот, спрячьте ключи, коды подтверждения и приватный контент.
- Убедитесь, что тестирование может потреблять небольшое количество DK, начиная с одного предложения и одного запроса.
- Ознакомьтесь с текущей моделью площади и страницу статуса, прежде чем решать, включать ли новые функции.
Детальное исследование: сузить круг проблемы по порядку
Сначала убедитесь, что счет завершён, ключ действительн, а баланс DK достаточен, затем проверьте протокол, адрес и модель. Сделайте минимальный текстовый запрос с помощью той же клавиши; Только после успеха он восстанавливает вложения, инструменты или автоматически перепробует каждый элемент. После сохранения конфигурации клиента заново откройте сессию, чтобы избежать использования предыдущего поставщика в старой сессии.
Как подтвердить, что этот раздел изучен
Не стоит просто отметить запрос «Конфигурация успешно сохранена». Вы должны чётко указывать текущий базовый URL, использование ключа, выбранную модель и протокол запроса, а также проверять результаты работы на соответствующей консоли. Клиентский туториал использует один реальный ответ в виде обычного текста и соответствующие логи в качестве начального стандарта завершения; Обучающие материалы по аккаунтам основаны на обширной информации о безопасности; В учебном материале по биллингу используется соответствие между принципалом, комиссией за каналы и DK в качестве стандарта.
Если возникает ошибка, запишите время появления, статус HTTP, содержимое анонимизированной ошибки и фактический ожидаемый результат. Не делайте скриншоты полного ключа страницы и не давайте пароль или код подтверждения другим. Для 401 сначала следует решить аутентификацию; для 400 — сначала решить параметры; для 429 — прекратить интенсивные повторные попытки; для 404 — проверить пути запросов и верификация по верхнему потоку; перезарядка не может устранить все ошибки.
Небольшое задание, подходящее для практики
Выполните минимальные шаги в этом разделе в своей тестовой среде, записывая в тексте «как вы изначально настроили, какой элемент изменили и какие результаты увидели». Не воспринимайте производственные данные, реальные платежи или невосстанавливые команды как упражнения. Если вы столкнётесь с функциями, выходящими за рамки этого раздела, сначала ознакомьтесь с соответствующим учебником по протоколу, прежде чем рассматривать возможность добавления новых функций; Изменение только одной конфигурации за раз позволяет легко определить, какой шаг приводит к ошибкам.
Следующий шаг — граница версии
Вернуться к полной карте обучения · Оптимизированная конфигурация сайта API · Статус сайта в реальном времени。
Обучающий материал был составлен 9 октября 2026 года. Конкретный интерфейс и возможности могут различаться в зависимости от клиента и восходящих версий; Инструкции по конфигурации не означают, что все клиентские версии прошли тест. Для оплаты баланса, входа в QQ / Alipay и открытых каналов, пожалуйста, обратитесь к самой странице страницы; Интерфейсы сжатия: Ранее каналы 404 и RAW были недоступны, так что не предполагайте, что конфигурационные файлы можно автоматически удалять.