FlagshipRouter — Embeddings
Requires FLAGSHIPROUTER_URL (and FLAGSHIPROUTER_KEY if auth enabled). See https://raw.githubusercontent.com/theRizwan/FlagshipRouter/refs/heads/main/skills/flagshiprouter/SKILL.md for setup.
Discover
bashcurl $FLAGSHIPROUTER_URL/v1/models/embedding | jq '.data[].id' # Per-model dimensions curl "$FLAGSHIPROUTER_URL/v1/models/info?id=openai/text-embedding-3-small"
Endpoint
POST $FLAGSHIPROUTER_URL/v1/embeddings
| Field | Required | Notes |
|---|---|---|
model | yes | from /v1/models/embedding |
input | yes | string OR array of strings |
encoding_format | no | float (default) / base64 |
dimensions | no | OpenAI v3 only |
Examples
bashcurl -X POST $FLAGSHIPROUTER_URL/v1/embeddings \ -H "Authorization: Bearer $FLAGSHIPROUTER_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"openai/text-embedding-3-small","input":["hello","world"]}'
JS:
jsconst r = await fetch(`${process.env.FLAGSHIPROUTER_URL}/v1/embeddings`, { method: "POST", headers: { "Authorization": `Bearer ${process.env.FLAGSHIPROUTER_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify({ model: "gemini/text-embedding-004", input: "RAG chunk text" }), }); const { data } = await r.json(); console.log(data[0].embedding.length); // dimension
Response shape
json{ "object": "list", "model": "openai/text-embedding-3-small", "data": [ { "object": "embedding", "index": 0, "embedding": [0.0123, -0.045, ...] }, { "object": "embedding", "index": 1, "embedding": [...] } ], "usage": { "prompt_tokens": 5, "total_tokens": 5 } }
Provider quirks
| Provider | Notes |
|---|---|
openai, openrouter, mistral, voyage-ai, fireworks, together, nebius, github, nvidia, jina-ai | Native OpenAI shape — dimensions works only on OpenAI v3 (text-embedding-3-*) |
gemini, google_ai_studio | Server auto-converts to embedContent/batchEmbedContents — send OpenAI shape |
openai-compatible-*, custom-embedding-* | Custom baseUrl from credentials |
Batch (input as array) is faster; some providers cap batch size.


