Переменные среды на стороне сервера, минимальные примеры Responses/Chat SDK и повторные попытки. Включает полные этапы инспекции, практическую проверку и устранение ошибок.

Python, Node.js и LangChain

Сервер хранит ключ

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

Python

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["BAIYUN_API_KEY"],
                base_url="https://api.baiyun.si/v1",
                timeout=120.0, max_retries=0)
response = client.responses.create(model="gpt-6-luna",
                                   input="用一句话说明 Token 是什么。")
print(response.output_text)

output_text Это удобство, предоставляемое SDK; При прямом парсинге REST JSON его следует пройти output Текстовое поле в сообщении. Зависимости должны устанавливаться в изолированной среде, а файлы блокировки проекта сохраняться; Не обновляйте весь производственный проект только ради тестирования.

Node.js

import OpenAI from 'openai';
const client = new OpenAI({
  apiKey: process.env.BAIYUN_API_KEY,
  baseURL: 'https://api.baiyun.si/v1',
  maxRetries: 0,
  timeout: 120000,
});
const stream = await client.chat.completions.create({
  model: 'gpt-6-luna', stream: true,
  messages: [{role: 'user', content: '你好'}],
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

LangChain

Используйте адаптер модели, поддерживающий совместимые с OpenAI адреса, и установите API-ключ, базовый URL и модель в текущей версии. Сначала вызовите открытый текст, затем добавьте ссылки, поиск или инструменты; Любые дополнительные параметры, автоматически добавляемые фреймворком, должны соответствовать открытому объёму сайта; не рассматривайте название фреймворка как гарантию совместимости.

Ошибки и повторные попытки

Во-первых, различайте ошибки HTTP-статуса, ошибки разбора SDK и ошибки бизнес-возврата. Прерывания генерации могут уже потреблять деньги; не повторяйте автоматически бесконечно; 429 Отступление по требованию, 401 Удостоверение ремонта, 400 Параметры ремонта. Когда соединение заканчивается, проверьте страницу статуса и сеть, прежде чем решать, стоит ли пробовать снова.

Официальный проект Python SDK · Официальный проект Node SDK · Официальная документация LangChain

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

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

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

Сначала запустите минимальный закрут с тем же ключом и моделью, затем сравните фактический адрес, протокол запроса и параметры SDK. Если Curl удаётся, но SDK не работает, устраните неисправность среды прокси, автоповтор попытки SDK, тайм-аут и дополнительные поля. Не печатайте авторизацию в журналах ошибок; Ключи во время развертывания нельзя записывать в переменные сборки фронтенда.

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

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

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

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

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

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

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

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