Guide d'intégration GloopAPI
Réponses en flux
Consommer les événements en flux et les signaux de fin.
Le streaming livre la sortie progressivement sans modifier les autorisations ni la facturation. Définissez stream: true et consommez text/event-stream. Ne traitez pas la réponse entière comme un seul document JSON.
Responses utilise des événements typés tels que response.output_text.delta et response.completed ; analysez chaque événement selon son type.
Analyse selon le protocole
Les data SSE de Chat Completions sont des fragments JSON ; le texte se trouve généralement dans choices[].delta, et les appels d'outils peuvent aussi être fragmentés. data: [DONE] marque la fin du protocole. Une requête avec stream_options.include_usage peut recevoir un dernier fragment d'utilisation dont choices est vide ; l'absence d'utilisation ne signifie pas gratuité.
Limites réseau
Un bloc d'octets réseau n'est pas un événement : accumulez jusqu'au séparateur de ligne vide, fusionnez les lignes data, puis analysez le JSON. Gérez les caractères UTF-8 répartis entre fragments, les lignes vides, les commentaires et les événements d'erreur du service. Les exemples à droite du point de terminaison montrent la forme des événements du protocole.
Si la connexion est interrompue ou si l'événement final manque, marquez la sortie comme incomplète et conservez le texte déjà affiché ainsi que les diagnostics de la requête. Fermer la connexion ne garantit ni l'absence d'exécution ni un remboursement. Une requête texte synchrone non confirmée n'a pas le contrat de récupération d'une tâche persistante et ne doit pas être renvoyée automatiquement.
Utilisation et traitement ultérieur
Ne validez le résultat complet qu'après une fin normale ; la facturation finale repose sur les relevés d'utilisation de la plateforme, pas sur le nombre local de fragments. Si le flux signale une erreur après HTTP 200, traitez-la selon le protocole plutôt que de vous fier au seul état initial. Voir Gestion des erreurs et Facturation.