Embedding Providers

Embedding providers store API credentials for embedding services used to generate vector embeddings.

Supported Providers

Provider	Models
openai	text-embedding-3-small (1536d), text-embedding-3-large (3072d), text-embedding-ada-002 (1536d)
gemini	text-embedding-004 (768d)

Create Embedding Provider

POST /v1/embedding-providers

Request Body:

Field	Type	Required	Description
name	string	Yes	Display name (1-100 chars)
provider	string	Yes	openai or gemini
api_key	string	Yes	API key for the embedding service
default_model	string	No	Default model for this provider

Example:

curl -X POST https://api.embedd.to/v1/embedding-providers \
  -H "Authorization: Bearer sk_your_key" \
  -H "X-Environment-Id: env_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "openai-prod",
    "provider": "openai",
    "api_key": "sk-proj-...",
    "default_model": "text-embedding-3-small"
  }'

Response (201):

{
  "id": "ep_abc123",
  "org_id": "org_xyz",
  "environment_id": "env_abc123",
  "name": "openai-prod",
  "provider": "openai",
  "default_model": "text-embedding-3-small",
  "status": "active",
  "created_at": "2025-01-15T10:00:00Z"
}

List Embedding Providers

GET /v1/embedding-providers

Get Embedding Provider

GET /v1/embedding-providers/{provider_id}

Update Embedding Provider

PUT /v1/embedding-providers/{provider_id}

Request Body:

Field	Type	Required	Description
name	string	No	Updated name
api_key	string	No	Updated API key
default_model	string	No	Updated default model

Delete Embedding Provider

DELETE /v1/embedding-providers/{provider_id}

Response: 204 No Content

List Available Models

GET /v1/embedding-providers/{provider_id}/models

Returns the available embedding models for the provider.

Response (200):

{
  "models": [
    {
      "model": "text-embedding-3-small",
      "dimensions": 1536,
      "max_tokens": 8191,
      "provider": "openai"
    },
    {
      "model": "text-embedding-3-large",
      "dimensions": 3072,
      "max_tokens": 8191,
      "provider": "openai"
    }
  ]
}