> For the complete documentation index, see [llms.txt](https://morphos.gitbook.io/morphos-ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://morphos.gitbook.io/morphos-ai/getting-started/grpc.md).

# gRPC API Reference

We have provided a gRPC interface for instances when there is a need to vectorize large amounts of vectors.

The choice between gRPC and the REST API is a trade-off between convenience and speed. gRPC is a binary protocol and can be more challenging to debug. This interface would be useful when converting an existing vector database to GreenVectors or when vectorizing large amounts of input vectors into a facet. 

The gRPC methods follow the same principles as REST. For each REST endpoint, there is a corresponding gRPC method.

### API URL <a href="#api-urls" id="api-urls"></a>

| Base URL                                                                  |
| ------------------------------------------------------------------------- |
| [https://greenvectors.morphos.ai/](http://greenvectors.morphos.ai/api/v1) |

### Authentication <a href="#authentication" id="authentication"></a>

Bearer Token:

The bearer token will be provided upon request and it is up to the client to keep it secret. Every API call needs to contain this token in order to authenticate and authorize the client.

### Protocol Documentation/Proto files <a href="#authentication" id="authentication"></a>

To locate the gRPC proto files, visit our Github repo: <https://github.com/morphosai/GreenVectors.Protobuf/blob/main/docs/grpc/docs.md>