motief/docs/embeddings.md

Embeddings

This project uses QWEN embeddings. The model used is qwen/qwen3-embedding-4b via OpenRouter-compatible API providers.

API key preference

• Preferred environment variable: OPENROUTER_API_KEY
• Fallback: OPENAI_API_KEY

When the application needs to compute embeddings it will prefer the OpenRouter API key (OPENROUTER_API_KEY). If that is not set, it will fall back to using OPENAI_API_KEY where supported by the client libraries.

Example environment variables

OPENROUTER_API_KEY=or-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# or fallback
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Notes

• QWEN embedding models may be provided through OpenRouter or other proxies that expose the same API surface. Ensure your provider supports the qwen/qwen3-embedding-4b embedding model.
• Using OpenRouter is recommended to access QWEN embeddings when you don't have native access through OpenAI-compatible endpoints.