Get API

GET API · Integrazioni per sviluppatori

Come creare e utilizzare una chiave Get API in modo sicuro

Dopo la registrazione o l'accesso a Get API, creare una chiave nella pagina Chiavi API, assegnarle un nome riconoscibile e selezionare il gruppo che corrisponde allo strumento o al modello di destinazione. Una chiave completa può essere mostrata solo una volta, quindi memorizzala immediatamente in un gestore segreto lato server o in una variabile di ambiente locale controllata; non inserire mai una chiave di produzione nel codice del browser, negli screenshot, nei repository pubblici o nei log.

Il nome organizza le chiavi; l'accesso all'ambito del gruppo

Un nome chiave separa lo sviluppo, il test e l'utilizzo in produzione. Il suo gruppo determina i modelli o gli strumenti a cui la chiave può arrivare. Un gruppo non è un gruppo sociale, e la sua etichetta non dovrebbe essere trattata come una promessa modello permanente; rivedere il catalogo live e l'interfaccia utente corrente prima di creare la chiave.

  • Utilizzare chiavi separate per ambienti separati
  • Scegli il gruppo che corrisponde allo strumento o al modello di destinazione
  • Considera la console corrente come autorevole per l'accesso

Conserva le credenziali in un ambiente controllato

Pacchetti browser, archivi pubblici, schermate e registri ordinari possono esporre le credenziali. Le applicazioni server dovrebbero leggere una chiave dall'archivio segreto o da una variabile di ambiente; gli strumenti desktop dovrebbero utilizzare la loro superficie di configurazione protetta.

  • Non utilizzare una chiave di produzione nelle variabili di build esposte al client
  • Registra solo un identificatore oscurato
  • Disabilitare una chiave sospetta prima di crearne la sostituzione

Inizia con una richiesta minima

Per il primo controllo, utilizza un identificatore del modello corrente dal catalogo live e una richiesta messages minima. Aggiungi streaming, strumenti, immagini o output strutturato una funzionalità alla volta dopo il lavoro di autenticazione e routing.

  • Utilizza https://relay-api.getapi.pro/v1 come URL di base
  • Invia richieste di chat a /chat/completions
  • Copia l'identificatore del modello dal catalogo live

Crea e verifica una chiave nella console

Questo flusso non richiede mai la pubblicazione di una chiave reale; gli screenshot mostrano solo la navigazione e i campi vuoti.

  1. Registrati o accedi a Get API

    Completa l'accesso all'account sul sito principale. I nuovi utenti possono utilizzare /register; gli utenti esistenti possono accedere direttamente alla console.

  2. Apri la pagina Chiavi API

    Selezionare API Chiavi nella navigazione della console per raggiungere l'elenco in cui sono gestite le chiavi.

    API Voce di navigazione tramite tasti nella console Get API
    Apri la pagina Chiavi API dalla navigazione della console. L'interfaccia utente di riferimento è mostrata in cinese.
  3. Inserisci un nome e seleziona un gruppo

    Scegli Crea chiave, inserisci un nome riconoscibile e seleziona il gruppo che corrisponde allo strumento o al modello di destinazione.

    Campi nome e gruppo utilizzati per creare una chiave Get API
    Nome e gruppo sono i campi principali. Le opzioni nella console corrente rimangono autorevoli; l'interfaccia utente di riferimento è mostrata in cinese.
  4. Copialo e conservalo in modo sicuro

    Copia immediatamente la chiave completa e inseriscila nell'archivio segreto lato server o in una variabile di ambiente locale controllata. Non dare per scontato che il valore completo rimarrà visibile in seguito.

  5. Invia una richiesta di convalida minima

    Copia un identificatore del modello attualmente disponibile dal catalogo live e convalida l'autenticazione Bearer, Base URL e la richiesta chat minima.

Una richiesta che evita di scrivere la chiave nella cronologia della shell

Leggi la variabile d'ambiente senza visualizzarla, quindi invia una richiesta minima con un modello segnaposto. Windows può impostare la stessa variabile in un ambiente controllato.

read -s GETAPI_API_KEY
export GETAPI_API_KEY
curl https://relay-api.getapi.pro/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model-name","messages":[{"role":"user","content":"Hello"}]}'

Risoluzione dei problemi relativi alla chiave API

Osserva innanzitutto lo stato HTTP o della console, modifica una variabile ed esegui nuovamente il test.

SintomoProbabile causaAzioneControllo di successo
401 o errore di autenticazioneChiave incompleta, scaduta o disabilitata; Intestazione di autorizzazione non validaLeggere la chiave da un archivio sicuro e mantenere uno spazio tra Bearer e la chiaveLa richiesta minima non restituisce più un errore di autenticazione
La chiave è disabilitataAzione amministrativa, controllo del rischio o rotazione intenzionaleSmetti di riprovare con la vecchia chiave e creane una sostitutiva quando autorizzatoLa sostituzione è disponibile nella console
La modella è assente dal gruppoIl gruppo chiave non include il modello targetEsamina il catalogo live e le opzioni del gruppo correnteIl modello selezionato è visibile al tasto
Messaggio di saldo o quotaIl saldo, il piano o lo stato di utilizzo corrente impediscono la richiestaControlla il saldo, il piano e l'utilizzo in tempo reale nella console senza assumere una soglia fissaLo stato della console consente una richiesta di test
404 o mancata corrispondenza del percorso/v1 mancante, percorso duplicato o endpoint erratoImposta l'URL di base su https://relay-api.getapi.pro/v1 e aggiungi il percorso della chat una voltaLa richiesta raggiunge l'endpoint del protocollo

Domande frequenti

Quali campi sono richiesti per creare una chiave Get API?

Inserisci un nome riconoscibile e seleziona il gruppo che corrisponde allo strumento o al modello di destinazione. La console corrente rimane autorevole per i gruppi disponibili e l'accesso.

È possibile memorizzare una chiave Get API nel codice del browser?

Non conservare lì una chiave di produzione. Il codice del browser e le variabili di ambiente esposte al client possono essere letti dagli utenti; utilizzare l'archiviazione lato server o un'impostazione protetta dello strumento desktop.

Perché una richiesta restituisce 401?

Le cause più comuni sono una chiave incompleta, scaduta o disabilitata oppure un'intestazione di autorizzazione che non utilizza il formato Bearer. Diagnosticare con una richiesta minima e non stampare mai la chiave completa nei log.

Un tasto può chiamare ogni modello?

Non dare per scontato che sia così. Il gruppo di chiavi, l'autorizzazione dell'account, il catalogo in tempo reale e lo stato attuale del servizio determinano i suoi modelli accessibili.

Richieste commerciali: business@honeykid.cn