Jev : différences de paramètres et d'API
Comprenez les capacités et différences d'utilisation des modèles Jev avec l'API de décision structurée.
Adaptez les types de questions, images et paramètres de contexte au modèle choisi. Consultez TypeSafe Decisions pour les requêtes, réponses et essais en ligne.
Modèles et points d'accès
| Modèle | Points d'accès pris en charge |
|---|---|
| jev-1.14.0Nouveau jev-1.13.0 | TypeSafe Decisions: /v1/decisions, /v1/systemone |
Différences des types de questions
| Configuration | Différences entre modèles et utilisation |
|---|---|
noul/choice/score | Pris en charge par les deux modèles et combinables dans une requête |
box | Nécessite Jev 1.14 ; Jev 1.13 utilise les trois premiers types |
state/instructions/criteria | Les deux acceptent texte et images. Référencez les images via assets, y compris dans les instructions et critères |
| Choix d'outil | choice renvoie le nom de l'action à exécuter par l'application ; l'application appelle ensuite les outils |
Images et Box
Les images et Box sont des capacités expérimentales officielles. Incluez TypeSafe-Danger-Zone-Images: true dans la requête.
| Configuration | Points clés |
|---|---|
| Formats d'image | Les deux acceptent PNG/JPEG, pas l'audio ou la vidéo directement ; extrayez d'abord des images fixes d'une vidéo |
| Envoi d'images | Utilisez JSON Base64 ou Multipart ; consultez l'API Reference pour les déclarations, références et dimensions |
Coordonnées box | L'origine est en haut à gauche. Multipliez les bords horizontaux par la largeur et les verticaux par la hauteur pour obtenir les positions en pixels |
box.confidence | Peut être null ; n'imposez pas une conversion numérique et ne traitez pas l'absence de valeur comme 0 |
| Cible absente | Box renvoie quand même des coordonnées. Vérifiez la présence avec Noul avant de décider de les utiliser |
| Plusieurs cibles | Une question Box localise une cible. Utilisez des questions distinctes et différenciez clairement les cibles dans les instructions |
Configuration du contexte
| Configuration | Points clés |
|---|---|
| Contexte par défaut | Pour les deux : 64K par requête et 32K par question. La requête compte state et toutes les questions ; une question compte state et une question |
| Contexte étendu | Avec TypeSafe-Danger-Zone-Long-Context: true, les deux limites passent à 262K. Activez par requête ; omettez pour les requêtes ordinaires |
| Nombre de questions | Pas de limite fixe indépendante, mais l'ensemble doit respecter les limites de contexte par requête et par question |
| Consommation | Images et texte comptent en Token d'entrée ; les Token de sortie sont gratuits. Consultez les prix dans le Catalogue des modèles |
Exemples d'appel
Remplacez MODEL_ID par l'ID complet fourni par la plateforme. Utilisez Jev 1.14 pour la localisation et remplacez image.png par une image locale conforme aux dimensions requises.
curl 'https://api.agtcloud.ai/v1/decisions' \
-H 'Authorization: Bearer your-api-key' \
-H 'TypeSafe-Danger-Zone-Images: true' \
-F 'request={"model":"MODEL_ID","state":{"photo":"reference_photo"},"questions":{"target":{"type":"box","instructions":"Localisez le rectangle rouge dans l'\''image photo."}},"assets":{"reference_photo":{"type":"image","part":"photo_file"}}};type=application/json' \
-F 'photo_file=@image.png;type=image/png'