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

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

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

Responses 同步与 SSE 流式文本请求及完整上下文说明。附完整检查步骤、实操验证和错误处理。

Responses 文本接口

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

适合明确支持 Responses 协议的应用。当前可使用同步和 SSE 流式文本请求；完整接口的工具、文件、图像等扩展功能暂未开放。

同步文本请求

curl --fail-with-body https://api.baiyun.si/v1/responses \
  -H "Authorization: Bearer $BAIYUN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model":"gpt-6-luna",
    "input":"请用一句话介绍你能帮我做什么。",
    "stream":false
  }'

响应中的 output 数组包含输出项。读取消息项 content 中 type 为 output_text 的 text 字段，并保留 usage 用量信息。不要假设原始 REST JSON 一定存在 SDK 提供的便利字段 output_text。

SSE 流式请求

curl --no-buffer --fail-with-body https://api.baiyun.si/v1/responses \
  -H "Authorization: Bearer $BAIYUN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-6-luna","input":"请写两句普通的问候语。","stream":true}'

按 SSE 事件类型解析：response.output_text.delta 提供文本增量；完整结束时应收到 response.completed。流未完成、出现失败事件或网络中断时，不应把已经显示的部分内容当成完整响应。

提交完整文本历史

{
  "model": "gpt-6-luna",
  "instructions": "用中文简短回答。",
  "input": [
    {"role": "user", "content": "什么是 Token？"},
    {"role": "assistant", "content": "Token 是模型处理文本时使用的计量单位。"},
    {"role": "user", "content": "它与字数完全相同吗？"}
  ],
  "stream": false
}

当前应把必要上下文以文本随本次请求提交。引用上游会话的 previous_response_id、外部历史、工具调用或不可检查的媒体载荷暂不开放。

使用前核对

先通过带 Bearer 鉴权的 /v1/models 核对实际模型名称。
当前仅开放文本模式，不支持任意 Responses 扩展字段或 SDK 自动附加的工具功能。
max_output_tokens 等参数不是已保证的输出或费用硬上限；按实际用量和消费记录核对费用。
每凭据最多 2 个并发请求；遇限流先等待，避免自动无限重试。

完整政策和暂未开放范围见本站使用规则；Chat 客户端查看Chat 文本接口。

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

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

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

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

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

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

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

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

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

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

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

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

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