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

Responses 文本接口

Schnittstellenadresse: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 文本接口。

Checkliste vor praktischer Anwendung

1. Bereiten Sie Ihr eigenes Konto und Ihre Zugangsschlüssel vor und verwenden Sie keine gemeinsamen Zugangsdaten anderer.
2. Zeichnet Client-Versionen, Systeme und Modelle auf, die zur einfachen Reproduktion während der Fehlersuche verwendet werden.
3. Speichere die Originalkonfiguration oder den Screenshot, verstecke Schlüssel, Verifizierungscodes und private Inhalte.
4. Bestätigen Sie, dass das Testen eine kleine Menge DK verbrauchen kann, beginnend mit einem einzelnen Satz und einer einzigen Anfrage.
5. Überprüfen Sie die aktuelle Modell-Plaza und die Status-Seite, bevor Sie entscheiden, ob Sie weitere Funktionen aktivieren möchten.

Detaillierte Untersuchung: Das Umfang des Problems eingrenzen, um die Reihenfolge zu erreichen

Zuerst bestätigen Sie, dass das Konto vollständig ist, der Schlüssel gültig ist und das DK-Guthaben ausreichend ist, dann überprüfen Sie das Protokoll, die Adresse und das Modell. Stellen Sie eine minimale Textanfrage mit demselben Schlüssel; Erst wenn es gelingt, stellt es Anhänge, Werkzeuge wieder her oder versucht automatisch jeden Gegenstand erneut. Nachdem Sie die Client-Konfiguration gespeichert haben, öffnen Sie die Sitzung erneut, um die Nutzung des vorherigen Anbieters in der alten Sitzung zu vermeiden.

Wie man bestätigt, dass dieser Abschnitt gelernt wurde

Kreuze nicht einfach die Eingabe "Konfiguration erfolgreich gespeichert" an. Du solltest in der Lage sein, die aktuelle Basis-URL, die Schlüsselnutzung, das gewählte Modell und das Anfrageprotokoll klar anzugeben und deine Betriebsergebnisse auf der entsprechenden Konsole überprüfen zu können. Das clientseitige Tutorial verwendet eine einzelne tatsächliche Klartextantwort und entsprechende Logs als Anfangsabschlussstandard; Konto-Tutorials basieren auf umfassenden Sicherheitsinformationen; Das Abrechnungstutorial verwendet die Korrespondenz zwischen Principal, Channel Fees und DK als Standard.

Tritt ein Fehler auf, notieren Sie die Ereigniszeit, den HTTP-Status, den Inhalt des anonymisierten Fehlers und das tatsächlich erwartete Ergebnis. Mach keinen Screenshot des gesamten Seitenschlüssels und gib weder das Passwort noch den Verifizierungscode an andere weiter. Bei 401 sollte die Authentifizierung zuerst gelöst werden; bei 400 zuerst die Parameter; bei 429 sollten intensive Wiederholungen gestoppt werden; bei 404 sollten Anfragepfade und Upstream-Verifizierung überprüft werden; Nachladen kann nicht alle Fehler beheben.

Eine kleine Aufgabe, die sich zum Üben eignet

Erledigen Sie die Mindestanforderungen in diesem Abschnitt in Ihrer eigenen Testumgebung und notieren Sie in Text: "Wie Sie es ursprünglich eingestellt haben, welches Element Sie modifiziert haben und welche Ergebnisse Sie gesehen haben." Behandeln Sie Produktionsdaten, reale Zahlungen oder nicht wiederherstellbare Befehle nicht als Übungen. Wenn du auf Funktionen stoßen, die über das hinausgehen, was dieser Abschnitt bietet, schau dir zuerst das entsprechende Protokoll-Tutorial an, bevor du darüber nachdenkst, Funktionen hinzuzufügen; Wenn man immer nur eine Konfiguration gleichzeitig ändert, kann man leicht beurteilen, welcher Schritt zu Fehlern führt.

Der nächste Schritt ist der Rand der Version

Rückkehr zur vollständigen Lernkarte · Optimierte API-Standortkonfiguration · Echtzeitstatus dieser Seite。

Das Tutorial wurde am 9. Oktober 2026 zusammengestellt. Die spezifische Benutzeroberfläche und Fähigkeiten können je nach Client und Upstream-Version variieren; Die Konfigurationsrichtlinien bedeuten nicht, dass alle Client-Versionen den Test bestanden haben. Für Guthabenzahlungen, QQ / Alipay-Login und offene Kanäle siehe bitte die eigentliche Seitenseite; Kompressionsschnittstellen: Früher waren upstream-404- und RAW-Bildkanäle nicht verfügbar, daher sollten Sie nicht davon ausgehen, dass Konfigurationsdateien automatisch entfernt werden können.