Guida all'integrazione GloopAPI
Panoramica dell'integrazione
Ottieni una Key, scopri i modelli e invia la prima richiesta.
GloopAPI espone modelli, attività di generazione, strumenti e file dei risultati tramite un'API unificata. Crea prima una Key separata per l'applicazione, poi scopri il catalogo accessibile con essa. I modelli o gli strumenti mostrati sul sito non implicano che la tua Key sia autorizzata a chiamarli.
Prima richiesta
Crea una Key nelle impostazioni sviluppatore dell'account e inseriscila in una variabile d'ambiente del server. GLOOP_API_BASE è l'origine API del deployment, senza /v1; gli esempi web usano l'indirizzo API configurato attualmente.
export GLOOP_API_BASE="https://api.gloopapi.com"
curl "$GLOOP_API_BASE/v1/models" \
-H "Authorization: Bearer $GLOOP_API_KEY"
Scegli dal catalogo restituito un modello che supporti il testo, salvalo come GLOOP_MODEL, poi invia una richiesta testuale minima:
curl "$GLOOP_API_BASE/v1/chat/completions" \
-H "Authorization: Bearer $GLOOP_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"model\":\"$GLOOP_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"
Gli esempi spiegano come usare l’API. Modelli disponibili e prezzi dipendono dal catalogo e dai preventivi attuali. Leggere o copiare la documentazione non invia richieste.
Scegliere il flusso
Per la generazione di testo puoi consumare direttamente la risposta. Per immagini e video persistenti, consulta prima il catalogo, prepara gli input, richiedi il preventivo, conferma la creazione e conserva la chiave di richiesta per il recupero. Immagini sincrone e voce restituiscono direttamente il risultato e non possono usare le interfacce di recupero delle attività persistenti.
Leggi prima Autenticazione, Selezione dei modelli e Integrazione SDK. Per la lettura in streaming consulta Risposte in streaming; per il recupero delle attività consulta Attività asincrone e idempotenza.
Punti di ingresso API
- Catalogo dei modelli: ottieni gli ID pubblici disponibili per la Key corrente.
- Generazione di testo: invia messaggi e consuma risposte sincrone o in streaming.
- Funzionalità delle immagini persistenti: scopri modalità di input e dimensioni prima di preparare le risorse.
- Sintesi vocale: salva i dati audio binari; la clonazione usa un'interfaccia di attività separata.
- Funzionalità dei video persistenti: ottieni un preset completo, poi conferma il preventivo.
- Catalogo degli strumenti: scopri versioni autorizzate e regole di prezzo a consumo.
- Catalogo dei file: controlla lo stato di salvataggio e ottieni l'URL di download.
- Creare una risposta