Esempio di completamento delle chat che si sincronizzano con lo streaming SSE, richieste in testo semplice. Include passaggi completi di ispezione, verifica pratica e gestione degli errori.

Interfaccia di testo Chat Completions

Indirizzo dell'interfaccia:POST https://api.baiyun.si/v1/chat/completions。

Attualmente, sono disponibili conversazioni in testo semplice in stile Chat per i clienti che supportano esplicitamente il protocollo Chat di OpenAI. Richiedi l'uso della chiave del sito e invia il contesto testuale completo richiesto per questa conversazione.

Struttura delle richieste

{
  "model": "gpt-6-luna",
  "messages": [
    {"role": "system", "content": "用简洁的中文回答。"},
    {"role": "user", "content": "请解释什么是 Token。"}
  ],
  "stream": false
}

model Questo è il nome del modello effettivamente disponibile su questo sito;messages Invio dei messaggi di testo in ordine;stream Decidi se tornare in modo sincrono o in streaming. Questo articolo presenta solo la struttura di testo di base aperta; i parametri complessi dell'SDK e le funzionalità di estensione non dovrebbero essere disponibili di default.

Chiamata sincrona

curl --fail-with-body https://api.baiyun.si/v1/chat/completions \
  -H "Authorization: Bearer $BAIYUN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-6-luna","messages":[{"role":"user","content":"用一句话解释 Token。"}],"stream":false}'

Il testo generato si trova a choices[].message.content； Le informazioni sul dosaggio sono disponibili qui usage。 Contenuti specifici, numero di token e commissioni sono soggetti ai dati effettivi di risposta e consumo di quel periodo.

Chiamate di flusso

curl --no-buffer --fail-with-body https://api.baiyun.si/v1/chat/completions \
  -H "Authorization: Bearer $BAIYUN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model":"gpt-6-luna",
    "messages":[{"role":"user","content":"用三句话介绍 Token。"}],
    "stream":true,
    "stream_options":{"include_usage":true}
  }'

Ritorni di flusso usando SSE: read data: JSON, concatenali in ordine choices[].delta.content。data: [DONE] Indica la fine del corso; Attivato include_usage Il messaggio di utilizzo alla fine deve essere mantenuto dopo. Non trattare ogni shard SSE come una risposta HTTP autonoma.

Contesto del dialogo e confini dei parametri

Il canale attuale utilizza il campionamento predefinito del modello.temperature、top_p、frequency_penalty E presence_penalty Al momento non sono previsti controlli regolabili; I valori predefiniti comuni sul lato client vengono rimossi dall'elaborazione di compatibilità e non modificano le impostazioni di campionamento del modello.

Dovrebbero esserci più turni di dialogo messages Invia la cronologia completa richiesta del testo. Attualmente, strumenti esterni, reti, immagini e funzioni di file sono sospesi, e non c'è modo di bypassare l'invio di testo tramite la cronologia esterna non controllata.

Alcuni modelli o client supportano i parametri di output in modo differente. Anche se chiedi di compilarlo max_tokens、max_completion_tokens O valori come 8192, eccNon può essere considerato come una lunghezza di produzione fissa o un limite di costo garantito da questo sito。 Inizia con una breve richiesta, verifica i tuoi dati di spesa e imposta limiti di saldo per le chiavi che ti piacciono.

Lo stesso buono può essere elaborato al massimo simultaneamente 2 richieste； Le chiamate modello sono anche limitate dalla frequenza. Se incontri 429, aspetta e premiDichiarazione errataIdentifica la causa ed evita i ritentativi di loop ad alta frequenza.

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.