Agent Skills › decolua/9router › 9router-embeddings

9router-embeddings

GitHub

通过9Router统一接口调用OpenAI、Gemini等多模型生成文本向量，支持RAG和语义搜索。提供批量处理及多提供商适配，兼容OpenAI格式。

skills/9router-embeddings/SKILL.md decolua/9router

Trigger Scenarios

用户需要生成文本向量或嵌入表示构建检索增强生成（RAG）系统执行语义相似度搜索需要将文本转换为数值向量

Install

npx skills add decolua/9router --skill 9router-embeddings -g -y

More Options

Use without installing

npx skills use decolua/9router@9router-embeddings

指定 Agent (Claude Code)

npx skills add decolua/9router --skill 9router-embeddings -a claude-code -g -y

安装 repo 全部 skill

npx skills add decolua/9router --all -g -y

预览 repo 内 skill

npx skills add decolua/9router --list

SKILL.md

Frontmatter

{
    "name": "9router-embeddings",
    "description": "Generate vector embeddings via 9Router \/v1\/embeddings using OpenAI \/ Gemini \/ Mistral \/ Voyage \/ Nvidia \/ GitHub embedding models for RAG, semantic search, similarity. Use when the user wants embeddings, vectors, RAG, semantic search, or to embed text."
}

9Router — Embeddings

Requires NINEROUTER_URL (and NINEROUTER_KEY if auth enabled). See https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router/SKILL.md for setup.

Discover

curl $NINEROUTER_URL/v1/models/embedding | jq '.data[].id'
# Per-model dimensions
curl "$NINEROUTER_URL/v1/models/info?id=openai/text-embedding-3-small"

Endpoint

POST $NINEROUTER_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

curl -X POST $NINEROUTER_URL/v1/embeddings \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/text-embedding-3-small","input":["hello","world"]}'

JS:

const r = await fetch(`${process.env.NINEROUTER_URL}/v1/embeddings`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${process.env.NINEROUTER_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

{ "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