SmallPlate

Embedding Profiles

Manage embedding profiles, defaults, and provider utilities

Profile endpoints

MethodEndpointDescription
GET/plate-id/embedding-profilesList profiles
POST/plate-id/embedding-profilesCreate profile
PATCH/plate-id/embedding-profiles/profile-idUpdate profile
DELETE/plate-id/embedding-profiles/profile-idDelete profile

Defaults endpoints

MethodEndpointDescription
GET/plate-id/embedding-defaultsRead defaults
PUT/plate-id/embedding-defaultsSet defaults

Utility and discovery

MethodEndpointDescription
POST/plate-id/embeddings/runRun embedding test without touching Chroma
GET/plate-id/embedding-providersSupported providers
GET`/plate-id/embedding-models?provider=openaiopenrouter`

Profile shape

{
  "name": "default-openai-small",
  "provider": "openai",
  "model": "text-embedding-3-small",
  "dimensions": 1536,
  "api_key_mode": "stored"
}

Rules:

  • provider must be openai or openrouter
  • custom endpoints are not supported
  • secrets are write-only and never returned
  • api_key_mode:
    • stored: service stores encrypted secret
    • header: caller must send X-Embedding-Api-Key

Defaults shape

{
  "default_profile_id": "prof_default",
  "fallback_to_header_provider": false
}

On this page