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

Responses 文本接口

Indirizzo dell'interfaccia: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 文本接口。

Checklist prima dell'uso pratico

1. Prepara il tuo account e le chiavi di accesso, e non usare le credenziali condivise di altri.
2. Registra versioni, sistemi e modelli client da utilizzare per una facile riproduzione durante la risoluzione dei problemi.
3. Salva la configurazione originale o lo screenshot, nascondi chiavi, codici di verifica e contenuti privati.
4. Conferma che i test possono consumare una piccola quantità di DK, iniziando con una singola frase e una singola richiesta.
5. Esamina la piazza del modello attuale e la pagina di stato prima di decidere se abilitare ulteriori funzionalità.

Indagine dettagliata: restringere l'ambito del problema in ordine

Per prima cosa, conferma che l'account sia completo, la chiave valida e che il saldo DK sia sufficiente, poi verifica il protocollo, l'indirizzo e il modello. Effettua una richiesta minima di testo usando la stessa chiave; Solo dopo il successo ripristina allegati, strumenti o riprova automaticamente ogni oggetto. Dopo aver salvato la configurazione client, riapri la sessione per evitare di usare il fornitore precedente nella vecchia sessione.

Come confermare che questa sezione è stata appresa

Non controllare semplicemente il prompt "Configurazione salvata con successo". Dovresti essere in grado di indicare chiaramente l'URL base corrente, l'uso della chiave, il modello scelto e il protocollo di richiesta, e poter verificare i risultati delle tue operazioni sulla console corrispondente. Il tutorial lato client utilizza una singola risposta in testo semplice e i relativi log come standard iniziale di completamento; I tutorial sugli account si basano su informazioni di sicurezza complete; Il tutorial di fatturazione utilizza la corrispondenza tra capitale, commissioni di canale e DK come standard.

Se si verifica un errore, registra il tempo di occorrenza, lo stato HTTP, il contenuto dell'errore anonimizzato e il risultato effettivo atteso. Non fare screenshot dell'intera chiave della pagina e non fornire la password o il codice di verifica ad altri. Per 401, l'autenticazione dovrebbe essere risolta prima; per 400, i parametri devono essere risolti per primi; per 429, i tentativi intensivi devono essere interrotti; per 404, i percorsi di richiesta e la verifica a monte devono essere verificati; la ricarica non può risolvere tutti gli errori.

Un piccolo compito adatto alla pratica

Completa i passaggi minimi di questa sezione nel tuo ambiente di test, registrando nel testo "come l'hai impostato originariamente, quale elemento hai modificato e quali risultati hai visto." Non considerare dati di produzione, pagamenti reali o comandi irrecuperabili come esercizi. Se incontri funzionalità oltre quelle offerte da questa sezione, consulta prima il relativo tutorial sul protocollo prima di considerare di aggiungere funzionalità; Cambiare solo una configurazione alla volta rende facile giudicare quale passaggio porta agli errori.

Il passo successivo è il confine della versione

Torna alla mappa completa dell'apprendimento · Configurazione API semplificata del sito · Stato in tempo reale di questo sito。

Il tutorial è stato compilato il 9 ottobre 2026. L'interfaccia specifica e le capacità possono variare a seconda del client e delle versioni a monte; Le linee guida di configurazione non significano che tutte le versioni client abbiano superato il test. Per i pagamenti di saldo, l'accesso QQ / Alipay e i canali aperti, si prega di consultare la pagina effettiva; Interfacce di compressione: In precedenza, i canali immagine upstream 404 e raw non erano disponibili, quindi non dare per scontato che i file di configurazione possano essere rimossi automaticamente.