Tutorial API di Baiyun: Integrazione compatibile con OpenAI
Indirizzo unificato, selezione del protocollo, richiesta minima e ambito di compatibilità. Include passaggi completi di ispezione, verifica pratica e gestione degli errori.
Accesso compatibile OpenAI
Tre caratteristiche fondamentali
| Campo | Questa stazione è molto apprezzata |
|---|---|
| Base URL | https://api.baiyun.si/v1 |
| API Key | Chiamate di modello nella gestione delle chiavi |
| Modello | Copia il nome esatto dal quadrato del modello, come gpt-6-luna |
Chat Completions e Response sono due protocolli di richiesta diversi, non due chiavi. I client di chat ordinari generalmente usano Chat; I fornitori di codex custom usano Response. Elenco modelli con prezzi inclusiModel Squareprevarre.
Per prima cosa, verifica la lista dei modelli
curl --fail-with-body https://api.baiyun.si/v1/models -H "Authorization: Bearer $BAIYUN_API_KEY"
BAIYUN_API_KEY Queste sono variabili di ambiente che imposti privatamente localmente; non scrivere i veri valori in tutorial, repository di codice o screenshot. 401 prima controlla la chiave, 404 prima controlla l'indirizzo, 429 aspetta prima, non ripetere il processo all'infinito.
Invia di nuovo la richiesta minima di messaggio
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":"你好"}],"stream":true}'
Le richieste di flusso restituiscono segmento per segmento. Inserire i modelli non significa che la generazione abbia avuto successo; Generare testo ordinario non significa che siano disponibili immagini, audio, file, ricerca o tutti gli strumenti. Mantieni prima l'impostazione minima, poi abilita le funzioni una per una in base all'area effettivamente aperta del sito.
Parametri e limiti di capacità
Non aggiungere automaticamente il client toolsImmagini, allegati o citazioni storiche sono tutti considerati competenze generali. Attualmente, i canali Codex hanno adattamenti dedicati, quindi i clienti comuni dovrebbero comunque usare prima il testo semplice. Il percorso di compressione contestuale è aperto, ma l'upstream ha precedentemente restituito 404; Quando si incontra questo errore, non si può risolverlo cambiando ripetutamente le chiavi.
Checklist prima dell'uso pratico
- Prepara il tuo account e le chiavi di accesso, e non usare le credenziali condivise di altri.
- Registra versioni, sistemi e modelli client da utilizzare per una facile riproduzione durante la risoluzione dei problemi.
- Salva la configurazione originale o lo screenshot, nascondi chiavi, codici di verifica e contenuti privati.
- Conferma che i test possono consumare una piccola quantità di DK, iniziando con una singola frase e una singola richiesta.
- 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.