Guide d'intégration GloopAPI
Vue d'ensemble de l'intégration
Obtenir une Key, découvrir les modèles et envoyer une première requête.
GloopAPI expose modèles, tâches de génération, outils et fichiers de résultats au travers d'une API unifiée. Créez d'abord une Key distincte pour votre application, puis découvrez son catalogue accessible ; la présence d'un modèle ou d'un outil sur le site ne signifie pas que votre Key peut l'appeler.
Première requête
Créez une Key dans les paramètres développeur du compte et placez-la dans une variable d'environnement du serveur. GLOOP_API_BASE est l'origine API du déploiement, sans /v1 ; les exemples web utilisent l'adresse API actuellement configurée.
export GLOOP_API_BASE="https://api.gloopapi.com"
curl "$GLOOP_API_BASE/v1/models" \
-H "Authorization: Bearer $GLOOP_API_KEY"
Choisissez dans le catalogue renvoyé un modèle prenant en charge le texte, enregistrez-le dans GLOOP_MODEL, puis envoyez une requête texte minimale :
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\":\"你好\"}]}"
Ces exemples expliquent l’utilisation de l’API. Les modèles disponibles et les prix sont ceux du catalogue et des devis actuels. Lire ou copier la documentation n’envoie aucune requête.
Choisir un workflow
Pour le texte, consommez directement la réponse. Pour les images et vidéos persistantes, consultez le catalogue des capacités, préparez les entrées, obtenez un devis, confirmez la création et conservez la clé de requête pour la récupération. Les images synchrones et la voix renvoient directement leur résultat et ne peuvent pas utiliser les interfaces de récupération des tâches persistantes.
Lisez d'abord Authentification, Choix des modèles et Intégration SDK. Consultez Réponses en flux pour la lecture en flux et Tâches asynchrones et idempotence pour la récupération.
Points d'entrée API
- Catalogue des modèles : obtenir les ID publics accessibles à la Key actuelle.
- Génération de texte : envoyer des messages et consommer une réponse synchrone ou en flux.
- Capacités image persistantes : découvrir les modes d'entrée et dimensions avant de préparer les ressources.
- Synthèse vocale : sauvegarder les octets audio ; le clonage utilise une interface de tâches distincte.
- Capacités vidéo persistantes : obtenir un preset complet, puis un devis à confirmer.
- Catalogue des outils : découvrir les versions autorisées et les règles tarifaires à l'utilisation.
- Catalogue des fichiers : vérifier l'état de sauvegarde et obtenir une URL de téléchargement.
- Créer une réponse