Nesta página, você encontra uma visão geral de como usar as APIs instaladas com o Vertex AI no appliance isolado do Google Distributed Cloud (GDC) e a documentação de referência.
Endpoint de serviço e documento de descoberta
Um endpoint de serviço é necessário para interagir de maneira programática com as APIs da Vertex AI.
Para conferir os endpoints das APIs pré-treinadas, consulte o status e os endpoints do serviço.
Acesso à API
É possível acessar as APIs pré-treinadas usando gRPC ou uma das bibliotecas de cliente fornecidas. As bibliotecas de cliente são criadas no gRPC.
Como alternativa, você pode acessar algumas APIs pré-treinadas usando REST.
Bibliotecas de cliente
A Vertex AI oferece bibliotecas de cliente Python para APIs pré-treinadas. A tabela a seguir mostra uma comparação das vantagens e desvantagens de usar bibliotecas de cliente:
| Vantagens | Desvantagens |
|---|---|
|
Mantidos pelo Google.
Autenticação integrada. Novas tentativas integradas. Corpo da solicitação HTTP de buffer de protocolo eficiente. |
Não disponível para todas as linguagens de programação. |
REST
As APIs OCR e Translation são compatíveis com REST. Para mais informações, consulte as referências da API REST destes serviços:
A tabela a seguir mostra uma comparação das vantagens e desvantagens de usar REST:
| Vantagens | Desvantagens |
|---|---|
|
Interface JSON simples.
É compatível com muitas ferramentas e bibliotecas do Google e de terceiros. |
Você precisa criar seu próprio cliente.
Você precisa implementar a autenticação. Você precisa implementar novas tentativas. Corpo da solicitação HTTP JSON menos eficiente. O streaming REST não é compatível com essas APIs. |
Ao chamar a API REST, o comportamento do valor padrão para buffers de protocolo pode resultar em campos ausentes em uma resposta JSON. Esses campos são definidos como o valor padrão e, portanto, não são incluídos na resposta.
gRPC
As APIs pré-treinadas e a API Gemini são compatíveis com gRPC. Para mais informações sobre as descrições genéricas dos tipos, métodos e campos gerados para uma biblioteca gRPC, consulte a seguinte referência do gRPC:
A tabela a seguir mostra uma comparação das vantagens e desvantagens de usar o gRPC:
| Vantagens | Desvantagem |
|---|---|
|
Compatível com muitas linguagens de programação.
Corpo da solicitação HTTP de buffer de protocolo eficiente. |
Você precisa gerar o próprio cliente com buffers de protocolo fornecidos pelo Google.
Você precisa implementar a autenticação. Você precisa implementar novas tentativas. |
Tipo, método e nomes de campos
Dependendo de você usar bibliotecas de cliente, REST, gRPC ou KRM, o tipo, o método e os nomes dos campos da API variam das seguintes maneiras:
- O REST é organizado por hierarquias de recursos e seus métodos.
- As bibliotecas de cliente e o gRPC são organizados por serviços e métodos.
- Os nomes de campos do KRM usam camelCase, mas o serviço da API aceita camelCase ou snake_case.
- Os nomes dos campos REST e gRPC usam snake_case.
- Os nomes dos campos das bibliotecas de cliente usam maiúsculas ou minúsculas e a concatenação de texto, dependendo do nome idiomático da linguagem.