Baiyun Super Intelligence BAIYUN.SI
Tutoriel d’intégration API

Tutoriel API Baiyun : Interface texte de réponses

Lecture gratuite

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

Responses 文本接口

Adresse de l’interface :POST https://api.baiyun.si/v1/responses。

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

同步文本请求

bash
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 流式请求

bash
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。流未完成、出现失败事件或网络中断时,不应把已经显示的部分内容当成完整响应。

提交完整文本历史

json
{
  "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 文本接口。

Liste de contrôle avant utilisation pratique

  1. Préparez votre propre compte et vos clés d’accès, et n’utilisez pas les identifiants partagés des autres.
  2. Enregistre les versions, systèmes et modèles clients pour faciliter la reproduction lors du dépannage.
  3. Sauvegardez la configuration originale ou la capture d’écran, masquez les clés, les codes de vérification et le contenu privé.
  4. Confirmez que les tests peuvent consommer une petite quantité de DK, en commençant par une seule phrase et une seule demande.
  5. Examinez la place du modèle actuel et la page d’état avant de décider d’activer d’autres fonctionnalités.

Enquête détaillée : réduire l’étendue du problème dans l’ordre

D’abord, confirmez que le compte est complet, que la clé est valide et que le solde DK est suffisant, puis vérifiez le protocole, l’adresse et le modèle. Faites une demande de texte minimale en utilisant la même clé ; Ce n’est qu’après son succès qu’il restaure les pièces jointes, les outils, ou réessaie automatiquement chaque objet. Après avoir sauvegardé la configuration client, rouvrez la session pour éviter d’utiliser le fournisseur précédent dans l’ancienne session.

Comment confirmer que cette section a été apprise

Ne vous contentez pas de cocher l’invite « Configuration sauvegardée avec succès ». Vous devriez pouvoir indiquer clairement l’URL de base actuelle, l’utilisation des clés, le modèle choisi et le protocole de requête, et pouvoir vérifier vos résultats d’opération sur la console correspondante. Le tutoriel côté client utilise une seule réponse en texte brut et les journaux correspondants comme norme initiale de complétion ; Les tutoriels de compte reposent sur des informations de sécurité complètes ; Le tutoriel de facturation utilise la correspondance entre le principal, les frais de chaîne et DK comme norme.

Si une erreur survient, notez l’heure d’occurrence, l’état HTTP, le contenu de l’erreur anonymisée et le résultat réel attendu. Ne faites pas de capture d’écran de la clé de la page entière, et ne donnez pas le mot de passe ou le code de vérification à d’autres. Pour 401, l’authentification doit être résolue en premier ; pour 400, les paramètres doivent être résolus en premier ; pour 429, les tentatives intensives doivent être arrêtées ; pour 404, les chemins de requête et la vérification en amont doivent être vérifiés ; la recharge ne peut pas résoudre toutes les erreurs.

Une petite tâche adaptée à la pratique

Complétez les étapes minimales de cette section dans votre propre environnement de test, en notant dans le texte « comment vous l’avez initialement configuré, quel élément vous avez modifié et quels résultats vous avez obtenus. » Ne considérez pas les données de production, les paiements réels ou les commandes irrécupérables comme des exercices. Si vous rencontrez des fonctionnalités au-delà de ce que propose cette section, consultez d’abord le tutoriel de protocole correspondant avant d’envisager d’ajouter des fonctionnalités ; Ne changer qu’une seule configuration à la fois facilite la mesure de la décision de savoir quelle étape entraîne des erreurs.

L’étape suivante est la frontière de la version

Retour à la carte d’apprentissage complète · Configuration simplifiée du site API · Statut en temps réel de ce site。

Le tutoriel a été compilé le 9 octobre 2026. L’interface spécifique et les capacités peuvent varier selon le client et les versions en amont ; Les directives de configuration ne signifient pas que toutes les versions clients ont réussi le test. Pour les paiements de solde, la connexion QQ / Alipay et les canaux ouverts, veuillez consulter la page de la page réelle ; Interfaces de compression : Auparavant, les canaux d’image 404 et bruts en amont n’étaient pas disponibles, donc ne supposez pas que les fichiers de configuration peuvent être supprimés automatiquement.

Une fois que tu l’as appris, essaie.

Utilisez les 100 questions de SIN1 pour vérifier votre fond de teint.

Faites le test

Contactez la communauté Baiyun SI

Contactez par email.

Pour toute demande, échange de besoins ou discussions de coopération, veuillez envoyer un e-mail.