Create embeddings
POST/v1/projects/:project_id/embeddings
Generates embedding vectors for one or more text inputs using the server's configured embedding model.
Provide input for a single text or inputs for a batch. At least one is required.
Returns embedding when input is used, and embeddings when inputs is used.
The call's token usage is metered against the project in the path, so embedding spend reaches the usage rollup and the project's cost_usd / tokens quotas.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 413
- 429
- 500
- 502
- 503
- 4XX
Embeddings generated successfully
Invalid request body
Unauthorized
The caller cannot write to the project
The project does not exist or the caller is not a member of it (RESOURCE_NOT_FOUND).
REQUEST_REJECTED — the request body is over the size the body parser accepts
QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens
Response Headers
Seconds until the quota window admits a request again
Unexpected server error — INTERNAL_ERROR, with the raw message never forwarded
The deployment's admission service is asked about this write and did not answer — ADMISSION_UNAVAILABLE; the write did not happen
Embedding service not configured
The deployment's admission service refused this write — answered under the service's own 4xx status, with its code (matching ^[A-Za-z_][A-Za-z0-9_]{0,63}$, not necessarily an ERROR_CODES key), message and meta; the write did not happen. A status this operation also declares on its own is documented there