Cette page présente l'utilisation des API installées avec Vertex AI sur l'appliance Google Distributed Cloud (GDC) air-gapped et sa documentation de référence.
Point de terminaison du service et document de découverte
Un point de terminaison de service est requis pour interagir de manière programmatique avec les API Vertex AI.
Pour obtenir les points de terminaison des API pré-entraînées, consultez l'état et les points de terminaison des services.
Accès API
Vous pouvez accéder aux API pré-entraînées à l'aide de gRPC ou de l'une des bibliothèques clientes fournies. Les bibliothèques clientes sont basées sur gRPC.
Vous pouvez également accéder à certaines API pré-entraînées à l'aide de REST.
Bibliothèques clientes
Vertex AI fournit des bibliothèques clientes Python pour les API pré-entraînées. Le tableau suivant compare les avantages et les inconvénients de l'utilisation de bibliothèques clientes :
| Avantages | Inconvénients |
|---|---|
|
Géré par Google.
Authentification intégrée. Nouvelles tentatives intégrées. Corps de requête HTTP avec tampon de protocole efficace. |
Non disponible pour tous les langages de programmation. |
REST
Les API OCR et Translation sont compatibles avec REST. Pour en savoir plus, consultez la documentation de référence de l'API REST pour ces services :
Le tableau suivant compare les avantages et les inconvénients de l'utilisation de REST :
| Avantages | Inconvénients |
|---|---|
|
Interface JSON simple.
Pleinement compatible avec de nombreux outils et bibliothèques Google et tiers |
Vous devez créer votre propre client.
Vous devez mettre en œuvre l'authentification. Vous devez implémenter les nouvelles tentatives. Corps de requête HTTP JSON moins efficace. Le streaming REST n'est pas compatible avec ces API. |
Lorsque vous appelez l'API REST, le comportement des valeurs par défaut pour les tampons de protocole peut entraîner l'absence de champs dans une réponse JSON. Ces champs sont définis sur la valeur par défaut et ne sont donc pas inclus dans la réponse.
gRPC
Les API pré-entraînées et l'API Gemini sont compatibles avec gRPC. Pour en savoir plus sur les descriptions génériques des types, des méthodes et des champs générés pour une bibliothèque gRPC, consultez la documentation de référence gRPC suivante :
- Documentation de référence sur l'OCR gRPC
- Documentation de référence sur gRPC Speech-to-Text
- Documentation de référence sur la traduction gRPC
Le tableau suivant compare les avantages et les inconvénients de l'utilisation de gRPC :
| Avantages | Inconvénient |
|---|---|
|
Compatible avec de nombreux langages de programmation.
Corps de requête HTTP avec tampon de protocole efficace. |
Vous devez générer votre propre client à partir des tampons de protocole fournis par Google.
Vous devez mettre en œuvre l'authentification. Vous devez implémenter les nouvelles tentatives. |
Noms de type, de méthode et de champs
Selon que vous utilisez des bibliothèques clientes, REST, gRPC ou KRM, les noms de type, de méthode et de champ de l'API varient comme suit :
- L'architecture REST est organisée par hiérarchies de ressources et leurs méthodes.
- Les bibliothèques clientes et gRPC sont organisées par services et par leurs méthodes.
- Les noms de champs KRM utilisent la convention typographique camelCase, mais le service d'API accepte aussi bien camelCase que snake_case.
- Les noms de champs REST et gRPC utilisent snake_case.
- Les noms de champs de la bibliothèque cliente utilisent soit la casse du titre, soit camelCase ou snake_case, selon le caractère idiomatique du nom dans le langage concerné.