Guide d'intégration GloopAPI
Choix des modèles
Découvrir les modèles accessibles à la Key actuelle.
L'ID du modèle doit provenir du catalogue accessible à votre Key. La présentation publique des modèles sert à la consultation ; elle n'accorde aucune autorisation et ne garantit ni les capacités de l'interface, ni les prix, ni l'activation en production.
Texte et protocoles
Consultez d’abord le catalogue accessible à votre clé. Les listes et détails utilisent le format OpenAI. Appelez les modèles de chat via Chat Completions ou Responses et vérifiez leurs capacités avant l’envoi.
Les images en entrée nécessitent un modèle doté de capacités visuelles. Les sorties structurées et appels d’outils dépendent du modèle choisi ; un ID présent ne garantit pas tous les champs optionnels.
Capacités image et vidéo
Les workflows persistants doivent consulter le catalogue dédié des capacités et vérifier les interrupteurs, modes d'entrée, dimensions et préréglages complets avant de demander un devis. La base actuelle des images persistantes comprend Ark Seedream Pro/Lite et Qwen ; la génération texte-image synchrone Venice ne produit qu'une image sans référence. Les capacités synchrones ne constituent pas une garantie du catalogue persistant.
Le catalogue vidéo renvoie des preset complets et exécutables. Utilisez-les tels quels, sans combiner résolution, durée, audio et rapport d'aspect issus de modes différents. Les images d'entrée doivent être des fichiers hébergés autorisés par le modèle ; certains modes image peuvent être absents si les entrées signées en HTTPS public ne sont pas prêtes.
Versions et enregistrements d'exécution
Les alias définissent l'identité publique du modèle sans hériter automatiquement des autorisations du modèle service. Les nouvelles tâches utilisent le routage et les prix en vigueur ; les tâches acceptées conservent leurs preuves d'exécution et de facturation. Si le catalogue ou les prix changent après le devis, confirmez à nouveau ; pour récupérer une tâche existante, utilisez l'identité et la clé de requête d'origine.
Si le catalogue des capacités est vide, vérifiez d'abord les autorisations et les interrupteurs ; ne sondez pas les interfaces de génération par interrogation répétée. Voir Gestion des erreurs et Facturation pour leurs limites respectives.