Обучающее руководство по интеграции API

Туториал по Baiyun API: Чатовый текстовый интерфейс

Редакционная команда Baiyun SI2026-10-09Примерно 7 минут на чтение

Пример синхронизации завершений чата с SSE-потоковыми запросами. Включает полные этапы инспекции, практическую проверку и устранение ошибок.

Текстовый интерфейс завершения чата

Адрес интерфейса:POST https://api.baiyun.si/v1/chat/completions。

В настоящее время для клиентов, которые явно поддерживают протокол Chat от OpenAI, доступны разговоры в стиле Chat. Запросите на использование ключа сайта и отправьте полный текст контекста, необходимый для этого разговора.

Структура запроса

{
  "model": "gpt-6-luna",
  "messages": [
    {"role": "system", "content": "用简洁的中文回答。"},
    {"role": "user", "content": "请解释什么是 Token。"}
  ],
  "stream": false
}

model Это название модели, которая фактически доступна на этом сайте;messages Текстовые сообщения отправлены по порядку;stream Решите, возвращаться синхронно или стримить. В этой статье представлена только открытая базовая структура текста; сложные параметры SDK и функции расширения по умолчанию не должны быть доступны.

Синхронный вызов

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":"用一句话解释 Token。"}],"stream":false}'

Сгенерированный текст находится по адресу choices[].message.content； Информация о дозировке доступна здесь usage。 Конкретный контент, количество токенов и комиссии зависят от фактических откликов и данных о потреблении за это время.

Вызовы потоков

curl --no-buffer --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":"用三句话介绍 Token。"}],
    "stream":true,
    "stream_options":{"include_usage":true}
  }'

Поток возвращается с помощью SSE: read data: JSON, соедините их по порядку choices[].delta.content。data: [DONE] Указывает конец потока; Активация include_usage Сообщение о применении в конце должно оставаться после записи. Не рассматривайте каждый SSE-шард как отдельный HTTP-ответ.

Контекст диалога и границы параметров

Текущий канал использует стандартную дискретизацию модели.temperature、top_p、frequency_penalty И presence_penalty В настоящее время регулируемые органы управления не предоставляются; Общие стандартные значения на стороне клиента удаляются при совместимости и не меняют настройки выборки модели.

Должно быть несколько раундов диалогов messages Отправьте необходимую полную историю текста. В настоящее время внешние инструменты, сетевые функции, изображения и файлы приостановлены, и невозможно обойти отправку текста через непроверенную внешнюю историю.

Некоторые модели или клиенты поддерживают параметры выхода по-разному. Даже если вы попросите заполнить max_tokens、max_completion_tokens Или значения вроде 8192 и так далееЭто нельзя рассматривать как фиксированную длину выпуска или лимит стоимости, гарантированный этим сайтом。 Начните с короткого запроса, проверьте свои расходы и установите лимиты баланса для ключей, которые вам подходят.

Один и тот же ваучер может быть обработан максимум одновременно 2 запроса； Модельные вызовы также ограничены частотой. Если встретите 429, подождите и нажмитеНеверное утверждениеОпределите причину и избегайте повторных попыток высокочастотных циклов.

Контрольный список перед практическим применением

Подготовьте свой собственный аккаунт и ключи доступа, и не используйте общие учетные данные других.
Записывает клиентские версии, системы и модели для удобства воспроизведения при устранении неполадок.
Сохраните оригинальную конфигурацию или скриншот, спрячьте ключи, коды подтверждения и приватный контент.
Убедитесь, что тестирование может потреблять небольшое количество DK, начиная с одного предложения и одного запроса.
Ознакомьтесь с текущей моделью площади и страницу статуса, прежде чем решать, включать ли новые функции.

Детальное исследование: сузить круг проблемы по порядку

Сначала убедитесь, что счет завершён, ключ действительн, а баланс DK достаточен, затем проверьте протокол, адрес и модель. Сделайте минимальный текстовый запрос с помощью той же клавиши; Только после успеха он восстанавливает вложения, инструменты или автоматически перепробует каждый элемент. После сохранения конфигурации клиента заново откройте сессию, чтобы избежать использования предыдущего поставщика в старой сессии.

Как подтвердить, что этот раздел изучен

Не стоит просто отметить запрос «Конфигурация успешно сохранена». Вы должны чётко указывать текущий базовый URL, использование ключа, выбранную модель и протокол запроса, а также проверять результаты работы на соответствующей консоли. Клиентский туториал использует один реальный ответ в виде обычного текста и соответствующие логи в качестве начального стандарта завершения; Обучающие материалы по аккаунтам основаны на обширной информации о безопасности; В учебном материале по биллингу используется соответствие между принципалом, комиссией за каналы и DK в качестве стандарта.

Если возникает ошибка, запишите время появления, статус HTTP, содержимое анонимизированной ошибки и фактический ожидаемый результат. Не делайте скриншоты полного ключа страницы и не давайте пароль или код подтверждения другим. Для 401 сначала следует решить аутентификацию; для 400 — сначала решить параметры; для 429 — прекратить интенсивные повторные попытки; для 404 — проверить пути запросов и верификация по верхнему потоку; перезарядка не может устранить все ошибки.

Небольшое задание, подходящее для практики

Выполните минимальные шаги в этом разделе в своей тестовой среде, записывая в тексте «как вы изначально настроили, какой элемент изменили и какие результаты увидели». Не воспринимайте производственные данные, реальные платежи или невосстанавливые команды как упражнения. Если вы столкнётесь с функциями, выходящими за рамки этого раздела, сначала ознакомьтесь с соответствующим учебником по протоколу, прежде чем рассматривать возможность добавления новых функций; Изменение только одной конфигурации за раз позволяет легко определить, какой шаг приводит к ошибкам.

Следующий шаг — граница версии

Вернуться к полной карте обучения · Оптимизированная конфигурация сайта API · Статус сайта в реальном времени。

Обучающий материал был составлен 9 октября 2026 года. Конкретный интерфейс и возможности могут различаться в зависимости от клиента и восходящих версий; Инструкции по конфигурации не означают, что все клиентские версии прошли тест. Для оплаты баланса, входа в QQ / Alipay и открытых каналов, пожалуйста, обратитесь к самой странице страницы; Интерфейсы сжатия: Ранее каналы 404 и RAW были недоступны, так что не предполагайте, что конфигурационные файлы можно автоматически удалять.

Возвращайтесь в сообщество и продолжайте читать Делюсь своим опытом