Dal login, deposito e creazione delle chiavi fino alla prima richiesta API in chiaro. Include passaggi completi di ispezione, verifica pratica e gestione degli errori.

Cominciamo

Questa pagina ti aiuta a iniziare a usare il sito tramite chat o chiamate API. L'attuale ambito dei servizi è:Richieste complete e verificabili in chiaro。

Vivilo sul sito web

1. Registrati o accedi a questo account del sito.
2. OpenPortafoglioDopo aver confermato l'importo del Doken (WordKnife, DK) e l'importo effettivo del pagamento RMB, ricarica tramite Alipay o WeChat; Il prezzo unitario attuale è di 0,30 RMB/DK.
3. OpenEsperienza di chatSeleziona il modello aperto e invia prima una breve domanda di testo normale.
4. EsistereConsole di controlloVisualizza i registri di utilizzo e consumo.

Attualmente, il consumo si basa sul saldo; non è richiesta alcuna iscrizione. Per favore, leggi prima di ricaricare o di interrompere il giocoRegole d'uso。

Crea una chiave di chiamata per l'applicazione

EsistereGestione delle chiaviCreare chiavi API per le chiamate al modello; Stabilisci i limiti di bilanciamento e modello in base alle esigenze reali, e conservali correttamente dopo aver risparmiato.

L'app utilizza ilChiave di chiamata modello, non una password di accesso web. Non inserire chiavi in codice pubblico, screenshot, contenuti di chat o codice frontend accessibile al browser. Le chiavi trapelate dovrebbero essere revocate e ricreate nella gestione delle chiavi.

Configura il client

Clienti diversi definiscono gli indirizzi in modo diverso: compilarli Base URL Di solito viene mantenuto in quel periodo /v1； Se devi compilare l'indirizzo completo della Chat, ti preghiamo di compilarlo https://api.baiyun.si/v1/chat/completions。 Non metterlo via /v1 Ripeti la giunzione due volte. Non tutti i client, i plugin e le funzioni sono compatibili di default.

La prima richiesta API

Imposta le variabili ambientali sul terminale locale per evitare di entrare nella schermata condivisa o nella registrazione durante l'inserimento della chiave:

read -r -s -p '请输入本站 API 密钥：' BAIYUN_API_KEY
printf '\n'
export BAIYUN_API_KEY

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": "你好，请用一句话介绍你能帮我做什么。"}],
    "stream": false
  }'

Una richiesta riuscita restituisce il testo generato e le informazioni di utilizzo, e detrae il saldo DK dal prezzo di riferimento indicato. 1 DK si riferisce al lotto di token con un prezzo di 1 USD secondo alcune quote di riferimento commerciali API selezionate, non quantità fisse di token o contanti convertibili in dollari USA. Le richieste normali sopra elencate generano anche una piccola quantità di consumo.

L'attuale 0,30 RMB/DK è il prezzo di ricarica su questo sito, non il costo esatto dell'abbonamento dimostrato dai test reali; Il valore di riferimento e il costo dell'abbonamento per lo stesso lotto di token sono mostrati in conversione RMB o JPYIstruzioni di fatturazione in tre fasi。

Se vuoi ricevere output continuamente, controllaloEsempio di chat streaming； Quando si utilizza Responses, l'app può visualizzarliEsempi di risposte。

Controlla i modelli chiamabili

L'interfaccia della lista modelli richiede anche l'autenticazione delle chiavi:

curl --fail-with-body https://api.baiyun.si/v1/models \
  -H "Authorization: Bearer $BAIYUN_API_KEY"

Il modello che effettivamente restituisce la chiave corrente prevalerà. Se il modello non esiste o non è disponibile, si prega di verificare il nome del modello, i limiti delle chiavi e il bilanciamento, e non riprovare ripetutamente richieste non supportate.

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.