Esta página oferece uma vista geral da utilização das APIs instaladas com a Vertex AI no dispositivo isolado do Google Distributed Cloud (GDC) e a respetiva documentação de referência.
Ponto final do serviço e documento de descoberta
É necessário um ponto final de serviço para interagir programaticamente com as APIs Vertex AI.
Para obter os pontos finais das APIs pré-formadas, consulte o estado do serviço e os pontos finais.
Acesso de API
Pode aceder às APIs pré-formadas através do gRPC ou de uma das bibliotecas de cliente fornecidas. As bibliotecas de cliente são criadas com base no gRPC.
Em alternativa, pode aceder a algumas APIs pré-preparadas através de REST.
Bibliotecas cliente
O Vertex AI fornece bibliotecas cliente Python para APIs pré-treinadas. A tabela seguinte mostra uma comparação das vantagens e desvantagens da utilização de bibliotecas de cliente:
| Vantagens | Desvantagens |
|---|---|
|
Mantido pela Google.
Autenticação incorporada. Repetições integradas. Corpo do pedido HTTP do buffer do protocolo eficiente. |
Não está disponível para todas as linguagens de programação. |
REST
As APIs OCR e Translation suportam REST. Para mais informações, consulte as referências da API REST para estes serviços:
A tabela seguinte mostra uma comparação das vantagens e desvantagens da utilização de REST:
| Vantagens | Desvantagens |
|---|---|
|
Interface JSON simples.
Bem suportado por muitas ferramentas e bibliotecas Google e de terceiros. |
Tem de criar o seu próprio cliente.
Tem de implementar a autenticação. Tem de implementar novas tentativas. Corpo do pedido HTTP JSON menos eficiente. O streaming REST não é suportado por estas APIs. |
Quando chama a API REST, o comportamento do valor predefinido para os buffers de protocolo pode resultar em campos em falta numa resposta JSON. Estes campos estão definidos com o valor predefinido, pelo que não estão incluídos na resposta.
gRPC
As APIs pré-treinadas e a API Gemini suportam gRPC. Para mais informações acerca das descrições genéricas dos tipos, métodos e campos gerados para uma biblioteca gRPC, consulte a seguinte referência do gRPC:
A tabela seguinte mostra uma comparação das vantagens e desvantagens da utilização do gRPC:
| Vantagens | Desvantagem |
|---|---|
|
Suporta muitas linguagens de programação.
Corpo do pedido HTTP do buffer do protocolo eficiente. |
Tem de gerar o seu próprio cliente a partir dos buffers do protocolo fornecidos pela Google.
Tem de implementar a autenticação. Tem de implementar novas tentativas. |
Tipo, método e nomes de campos
Consoante esteja a usar bibliotecas cliente, REST, gRPC ou KRM, o tipo, o método e os nomes dos campos da API variam das seguintes formas:
- O REST está organizado por hierarquias de recursos e respetivos métodos.
- As bibliotecas cliente e o gRPC estão organizados por serviços e respetivos métodos.
- Os nomes dos campos KRM usam camelCase, mas o serviço API aceita camelCase ou snake_case.
- Os nomes dos campos REST e gRPC usam snake_case.
- Os nomes dos campos da biblioteca de cliente usam letras maiúsculas no início de cada palavra, camelCase ou snake_case, dependendo do nome idiomático para o idioma.