Variabili dell'ambiente lato server, esempi minimi di Responses/Chat SDK e ritentativi. Include passaggi completi di ispezione, verifica pratica e gestione degli errori.

Python, Node.js e LangChain

Il server memorizza la chiave

La chiave passa attraverso le variabili dell'ambiente di processo BAIYUN_API_KEY Leggilo. Le pagine web del browser e le app mobili non possono avere chiavi condivise integrate; Devi avere un'autenticazione backend e una quota per inviare la richiesta per tuo conto. Prima della distribuzione, verifica se i log stampano intestazioni di richiesta o variabili di ambiente.

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 È la comodità fornita dall'SDK; Quando si analizza direttamente il JSON REST, dovrebbe essere attraversato output Campo di testo nell'elemento del messaggio. Le dipendenze dovrebbero essere installate in un ambiente isolato e i file di blocco del progetto conservati; Non aggiornare l'intero progetto di produzione solo per i test.

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

Usa un adattatore modello che supporti indirizzi compatibili OpenAI e imposta la chiave API, l'URL base e il modello nella versione attuale. Prima chiama il testo semplice, poi aggiungi link, recupero o strumenti; Eventuali parametri aggiuntivi aggiunti automaticamente dal framework devono comunque rispettare l'ambito aperto del sito; non considerare il nome del framework come una garanzia di compatibilità.

Errori e ritentativi

Per prima cosa, distinguere tra stato HTTP, errori di analisi SDK e errori di ritorno aziendale. Le interruzioni di generazione possono già consumare denaro; non riprovano automaticamente all'infinito; 429 Ritirata come richiesto, 401 Credenziali di riparazione, 400 parametri di riparazione. Quando la connessione scade, controlla la pagina di stato e la rete prima di decidere se riprovare.

Progetto ufficiale Python SDK · Progetto ufficiale SDK Node · Documentazione ufficiale di LangChain

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à.

Risoluzione dettagliata dei problemi: separare i problemi di richiesta da quelli di codice

Per prima cosa, esegui il curl minimo con la stessa chiave e modello, poi confronta l'indirizzo reale, il protocollo di richiesta e i parametri dell'SDK. Se il curl ha successo ma l'SDK fallisce, si verifica l'ambiente proxy, il ritentativo automatico dell'SDK, il timeout e campi aggiuntivi. Non stampare Authorization nei log degli errori; Le chiavi durante il deployment non possono essere scritte nelle variabili di costruzione frontend.

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.