9router-chat

通过9Router网关调用LLM，支持OpenAI和Anthropic格式。用于聊天、代码生成及文本摘要，具备流式传输与多提供商自动降级能力。

用户希望进行对话或提问需要生成代码片段要求总结文本内容执行自定义Prompt

skills/9router-chat/SKILL.md

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

SKILL.md

Frontmatter

{
    "name": "9router-chat",
    "description": "Chat \/ code generation via 9Router using OpenAI \/v1\/chat\/completions or Anthropic \/v1\/messages format with streaming + auto-fallback combos. Use when the user wants to ask an LLM, generate code, summarize text, or run prompts through 9Router."
}

9Router — Chat

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.

Endpoints

POST $NINEROUTER_URL/v1/chat/completions — OpenAI format
POST $NINEROUTER_URL/v1/messages — Anthropic format

Discover

curl $NINEROUTER_URL/v1/models | jq '.data[].id'
# Per-model metadata (contextWindow, params)
curl "$NINEROUTER_URL/v1/models/info?id=openai/gpt-4o"

Combos (e.g. vip, mycodex) auto-fallback through multiple providers.

OpenAI format

curl -X POST $NINEROUTER_URL/v1/chat/completions \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/gpt-5","messages":[{"role":"user","content":"Hi"}],"stream":false}'

JS (OpenAI SDK):

import OpenAI from "openai";
const client = new OpenAI({ baseURL: `${process.env.NINEROUTER_URL}/v1`, apiKey: process.env.NINEROUTER_KEY });
const res = await client.chat.completions.create({
  model: "openai/gpt-5",
  messages: [{ role: "user", content: "Hi" }],
  stream: true,
});
for await (const chunk of res) process.stdout.write(chunk.choices[0]?.delta?.content || "");

Anthropic format

curl -X POST $NINEROUTER_URL/v1/messages \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"cc/claude-opus-4-7","max_tokens":1024,"messages":[{"role":"user","content":"Hi"}]}'

Response shape

OpenAI (/v1/chat/completions):

{ "id": "chatcmpl-...", "object": "chat.completion", "model": "openai/gpt-5",
  "choices": [{ "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" }],
  "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } }

Streaming (stream:true) emits SSE: data: {choices:[{delta:{content:"..."}}]}\n\n ... data: [DONE]\n\n.

Anthropic (/v1/messages):

{ "id": "msg_...", "type": "message", "role": "assistant", "model": "cc/claude-opus-4-7",
  "content": [{ "type": "text", "text": "Hello!" }],
  "stop_reason": "end_turn", "usage": { "input_tokens": 8, "output_tokens": 2 } }

9router-embeddings

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

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

skills/9router-embeddings/SKILL.md

View Skill ›

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

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

Batch (input as array) is faster; some providers cap batch size.

9router-image

通过9Router统一接口调用多种AI模型（如DALL-E、FLUX、Gemini等）生成图像。支持文本转图片及参数配置，适用于创建、绘制或渲染图片的需求。

用户要求生成图片用户希望创作图像用户提及画图或绘图文本转图像请求

skills/9router-image/SKILL.md

View Skill ›

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

SKILL.md

Frontmatter

{
    "name": "9router-image",
    "description": "Generate images via 9Router \/v1\/images\/generations using OpenAI \/ Gemini Imagen \/ DALL-E \/ FLUX \/ MiniMax \/ SDWebUI \/ ComfyUI \/ Codex models. Use when the user wants to create, generate, draw, or render an image, picture, or text-to-image (txt2img)."
}

9Router — Image Generation

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/image | jq '.data[].id'
# Per-model params/options (size enum, quality enum, capabilities like edit)
curl "$NINEROUTER_URL/v1/models/info?id=openai/dall-e-3"

Endpoint

POST $NINEROUTER_URL/v1/images/generations

Field	Required	Notes
`model`	yes	from `/v1/models/image`
`prompt`	yes	image description
`n`	no	count (provider-dependent)
`size`	no	`1024x1024`, `1792x1024`, ...
`quality`	no	`standard` / `hd` (OpenAI)
`response_format`	no	`url` (default) or `b64_json`

Add query ?response_format=binary to receive raw image bytes (handy for saving file).

Examples

Save to file (binary):

curl -X POST "$NINEROUTER_URL/v1/images/generations?response_format=binary" \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini/gemini-3-pro-image-preview","prompt":"watercolor mountains at sunrise","size":"1024x1024"}' \
  --output out.png

JS (URL response):

const r = await fetch(`${process.env.NINEROUTER_URL}/v1/images/generations`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${process.env.NINEROUTER_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ model: "gemini/gemini-3-pro-image-preview", prompt: "neon city", size: "1024x1024" }),
});
const { data } = await r.json();
console.log(data[0].url || data[0].b64_json.slice(0, 40));

Response shape

JSON (default response_format=url):

{ "created": 1735000000, "data": [{ "url": "https://..." }] }

response_format=b64_json:

{ "created": 1735000000, "data": [{ "b64_json": "iVBORw0KGgo..." }] }

Query ?response_format=binary returns raw image bytes (Content-Type image/png or image/jpeg).

Provider quirks

Common fields above work everywhere. These add/override:

Provider	Extra/changed fields	Notes
`openai`, `minimax`, `openrouter`, `recraft`	`quality`, `style`, `response_format`	Standard OpenAI shape
`gemini` (nano-banana)	—	Only `prompt`; ignores `size`/`n`
`codex` (gpt-5.4-image)	`image`, `images[]`, `image_detail`, `output_format`, `background`	SSE stream; ChatGPT Plus/Pro required
`huggingface`	—	Only `prompt`; returns single image
`nanobanana`	`image`, `images[]` (edit mode)	`size` → aspect ratio; async polling
`fal-ai`	`image` (img2img)	`n` → `num_images`; `size` → ratio; async
`stability-ai`	`style` (preset), `output_format`	`size` → `aspect_ratio`
`black-forest-labs` (FLUX)	`image` (ref)	`size` → exact `width`/`height`; async
`runwayml`	`image` (ref)	`size` → ratio; async; video models exist
`sdwebui`, `comfyui`	—	Localhost noAuth (`:7860` / `:8188`)

9router-stt

通过9Router统一接口调用OpenAI Whisper、Groq、Gemini等模型，将音频文件转换为文本。支持多种格式输出及字幕生成，适用于语音转写和字幕提取场景。

用户需要将音频文件转换为文字用户需要为视频或音频生成字幕

skills/9router-stt/SKILL.md

View Skill ›

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

SKILL.md

Frontmatter

{
    "name": "9router-stt",
    "description": "Speech-to-text via 9Router \/v1\/audio\/transcriptions using OpenAI Whisper \/ Groq \/ Gemini \/ Deepgram \/ AssemblyAI \/ NVIDIA \/ HuggingFace models. Use when the user wants to transcribe audio, convert speech to text, or get subtitles from audio files."
}

9Router — Speech-to-Text

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/stt | jq '.data[].id'
# Per-model params (language, response_format, prompt, temperature support)
curl "$NINEROUTER_URL/v1/models/info?id=openai/whisper-1"

model = STT model ID (e.g. openai/whisper-1, groq/whisper-large-v3, deepgram/nova-3, gemini/gemini-2.5-flash).

Endpoint

POST $NINEROUTER_URL/v1/audio/transcriptions (OpenAI Whisper compatible, multipart/form-data)

Field	Required	Notes
`model`	yes	from `/v1/models/stt`
`file`	yes	audio file (mp3, wav, m4a, webm, ogg, flac)
`language`	no	ISO-639-1 (e.g. `en`, `vi`)
`prompt`	no	hint text to guide transcription
`response_format`	no	`json` (default) / `text` / `verbose_json` / `srt` / `vtt`
`temperature`	no	0–1

Examples

curl -X POST "$NINEROUTER_URL/v1/audio/transcriptions" \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -F "model=openai/whisper-1" \
  -F "file=@audio.mp3" \
  -F "language=vi"

JS (Node):

import { createReadStream } from "node:fs";
const form = new FormData();
form.append("model", "groq/whisper-large-v3-turbo");
form.append("file", new Blob([await (await import("node:fs/promises")).readFile("audio.mp3")]), "audio.mp3");
const r = await fetch(`${process.env.NINEROUTER_URL}/v1/audio/transcriptions`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${process.env.NINEROUTER_KEY}` },
  body: form,
});
const { text } = await r.json();
console.log(text);

Response shape

Default (response_format=json):

{ "text": "Xin chào, đây là bản ghi âm." }

verbose_json adds language, duration, segments[] with timestamps. srt / vtt return subtitle text.

Provider quirks

Provider	`model` format	Notes
`openai`	`whisper-1`, `gpt-4o-transcribe`, `gpt-4o-mini-transcribe`	Native OpenAI shape
`groq`	`whisper-large-v3`, `whisper-large-v3-turbo`, `distil-whisper-large-v3-en`	Fastest; OpenAI shape
`gemini`	`gemini-2.5-flash`, `gemini-2.5-pro`, `gemini-2.5-flash-lite`	Server converts to `generateContent` with audio inline
`deepgram`	`nova-3`, `nova-2`, `whisper-large`	Token auth; server adapts response
`assemblyai`	`universal-3-pro`, `universal-2`	Async upload+poll handled server-side
`nvidia`	`nvidia/parakeet-ctc-1.1b-asr`	NIM endpoint
`huggingface`	`openai/whisper-large-v3`, `openai/whisper-small`	HF Inference API

9router-tts

通过9Router统一接口调用OpenAI、ElevenLabs等TTS服务，将文本转换为语音。支持查询模型与声音列表，生成MP3或Base64音频，适用于旁白、朗读及语音合成场景。

用户要求将文本转换为语音需要生成音频文件或旁白请求朗读内容

skills/9router-tts/SKILL.md

View Skill ›

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

SKILL.md

Frontmatter

{
    "name": "9router-tts",
    "description": "Text-to-speech via 9Router \/v1\/audio\/speech using OpenAI \/ ElevenLabs \/ Deepgram \/ Edge TTS \/ Google TTS \/ Hyperbolic \/ Inworld voices. Use when the user wants to convert text to speech, generate audio, voiceover, narrate, or read text aloud."
}

9Router — Text-to-Speech

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

# 1) List models
curl $NINEROUTER_URL/v1/models/tts | jq '.data[].id'
# 2) Per-model metadata (params, voicesUrl if voice-by-id)
curl "$NINEROUTER_URL/v1/models/info?id=el/eleven_multilingual_v2"
# 3) List voices (elevenlabs, edge-tts, deepgram, inworld, local-device). Optional ?lang=vi
curl "$NINEROUTER_URL/v1/audio/voices?provider=edge-tts&lang=vi" | jq '.data[].model'

model field in /v1/audio/speech = voice ID directly (e.g. edge-tts/vi-VN-HoaiMyNeural, el/<voice_id>, or openai/tts-1 model+default voice).

Endpoint

POST $NINEROUTER_URL/v1/audio/speech

Field	Required	Notes
`model`	yes	voice ID from `/v1/models/tts`
`input`	yes	text to speak

Query ?response_format=mp3 (default, raw bytes) or ?response_format=json ({audio: base64, format}).

Examples

Save MP3:

curl -X POST "$NINEROUTER_URL/v1/audio/speech" \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/tts-1","input":"Hello world"}' \
  --output speech.mp3

JS (save file):

import { writeFile } from "node:fs/promises";
const r = await fetch(`${process.env.NINEROUTER_URL}/v1/audio/speech`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${process.env.NINEROUTER_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ model: "el/eleven_multilingual_v2", input: "Xin chào" }),
});
await writeFile("speech.mp3", Buffer.from(await r.arrayBuffer()));

Response shape

Default → raw audio bytes (Content-Type audio/mp3).

?response_format=json:

{ "audio": "SUQzBAAAA...", "format": "mp3" }

Provider quirks (model format)

Provider	`model` format	Notes
`openai`	`tts-1/alloy` (model/voice) or just voice	Default model `gpt-4o-mini-tts`
`elevenlabs`	`<model_id>/<voice_id>` or `<voice_id>`	Default model `eleven_flash_v2_5`; list voices in Dashboard
`openrouter`	`openai/gpt-4o-mini-tts/alloy`	Streamed via chat-completions audio modality
`edge-tts`	voice id e.g. `vi-VN-HoaiMyNeural`	noAuth; default `vi-VN-HoaiMyNeural`
`google-tts`	language code e.g. `en`, `vi`	noAuth
`local-device`	OS voice name (`say -v ?` / SAPI)	noAuth; needs `ffmpeg`
`deepgram`	`aura-asteria-en` etc	Token auth
`nvidia`, `inworld`, `cartesia`, `playht`	`model/voice`	Provider-specific auth header
`coqui`, `tortoise`	speaker / voice id	Localhost noAuth
`hyperbolic`	model id	Body = `{text}` only

9router-web-fetch

通过9Router接口调用Firecrawl、Jina等引擎，将指定URL内容抓取并转换为Markdown、文本或HTML格式。适用于网页抓取、文章阅读及URL内容提取场景。

用户要求抓取网页内容用户希望将URL转换为Markdown或纯文本用户需要读取在线文章详情

skills/9router-web-fetch/SKILL.md

View Skill ›

npx skills add decolua/9router --skill 9router-web-fetch -g -y

SKILL.md

Frontmatter

{
    "name": "9router-web-fetch",
    "description": "Fetch URL → markdown \/ text \/ HTML via 9Router \/v1\/web\/fetch using Firecrawl \/ Jina Reader \/ Tavily Extract \/ Exa Contents. Use when the user wants to scrape a webpage, extract URL content, read article, or convert a URL to markdown."
}

9Router — Web Fetch

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/web | jq '.data[] | select(.kind=="webFetch") | .id'
# Per-provider params
curl "$NINEROUTER_URL/v1/models/info?id=firecrawl/fetch"

IDs end in /fetch (e.g. firecrawl/fetch, jina/fetch). fetch-combo chains providers with auto-fallback.

Endpoint

POST $NINEROUTER_URL/v1/web/fetch

Field	Required	Notes
`model` (or `provider`)	yes	from `/v1/models/web` (e.g. `firecrawl` or `jina-reader`)
`url`	yes	URL to extract
`format`	no	`markdown` (default) / `text` / `html`
`max_characters`	no	truncate output

Examples

Jina Reader

curl -X POST $NINEROUTER_URL/v1/web/fetch \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"jina-reader","url":"https://9router.com","format":"markdown"}'

Exa

curl -X POST $NINEROUTER_URL/v1/web/fetch \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"exa","url":"https://example.com","format":"markdown","max_characters":0}'

Firecrawl

curl -X POST $NINEROUTER_URL/v1/web/fetch \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"firecrawl","url":"https://example.com","format":"markdown","max_characters":0}'

Tavily

curl -X POST $NINEROUTER_URL/v1/web/fetch \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"tavily","url":"https://example.com","format":"markdown","max_characters":0}'

JS:

const r = await fetch(`${process.env.NINEROUTER_URL}/v1/web/fetch`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${process.env.NINEROUTER_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ model: "fetch-combo", url: "https://example.com", format: "markdown", max_characters: 5000 }),
});
const { data } = await r.json();
console.log(data.title, data.content.length);

Response shape

{
  "provider": "jina-reader",
  "url": "...",
  "title": "...",
  "content": { "format": "markdown", "text": "...", "length": 1234 },
  "metadata": { "author": null, "published_at": null, "language": null },
  "usage": { "fetch_cost_usd": 0 },
  "metrics": { "response_time_ms": 850, "upstream_latency_ms": 700 }
}

Provider quirks

Provider	Auth	Best for
`firecrawl`	Bearer	JS-rendered pages, `format=markdown/html`
`jina-reader`	Bearer (optional)	Free tier (~1M chars/mo); fastest plain markdown
`tavily`	Bearer	Bulk extract; returns `raw_content`
`exa`	`x-api-key`	Pre-indexed pages; fast text extraction

9router-web-search

通过9Router统一接口调用Tavily、Brave等搜索引擎进行网页搜索。支持自定义查询参数与结果过滤，返回结构化搜索结果及元数据，适用于信息检索、文章查找等场景。

用户需要搜索网络信息用户想要查找特定文章或资料用户希望查询搜索引擎获取最新数据

skills/9router-web-search/SKILL.md

View Skill ›

npx skills add decolua/9router --skill 9router-web-search -g -y

SKILL.md

Frontmatter

{
    "name": "9router-web-search",
    "description": "Web search via 9Router \/v1\/search using Tavily \/ Exa \/ Brave \/ Serper \/ SearXNG \/ Google PSE \/ Linkup \/ SearchAPI \/ You.com \/ Perplexity. Use when the user wants to search the web, look up information, find articles, or query a search engine."
}

9Router — Web Search

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/web | jq '.data[] | select(.kind=="webSearch") | .id'
# Per-provider params (searchTypes, maxResults, required options like cx for google-pse)
curl "$NINEROUTER_URL/v1/models/info?id=tavily/search"

IDs end in /search (e.g. tavily/search). Combos (owned_by:"combo") chain providers with auto-fallback.

Endpoint

POST $NINEROUTER_URL/v1/search

Field	Required	Notes
`model` (or `provider`)	yes	from `/v1/models/web` (e.g. `tavily` or `brave`)
`query`	yes	search query
`max_results`	no	default 5
`search_type`	no	`web` (default) / `news`
`country`, `language`, `time_range`, `domain_filter`	no	provider-dependent

Examples

curl -X POST $NINEROUTER_URL/v1/search \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"tavily","query":"9Router open source","max_results":5}'

JS:

const r = await fetch(`${process.env.NINEROUTER_URL}/v1/search`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${process.env.NINEROUTER_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ model: "search-combo", query: "latest LLM benchmarks", max_results: 10 }),
});
console.log(await r.json());

Response shape

{
  "provider": "tavily",
  "query": "9Router open source",
  "results": [
    {
      "title": "...", "url": "https://...", "display_url": "github.com/...",
      "snippet": "...", "position": 1, "score": 0.92,
      "published_at": null, "favicon_url": null, "content": null,
      "metadata": { "author": null, "language": null, "source_type": null, "image_url": null },
      "citation": { "provider": "tavily", "retrieved_at": "2026-...", "rank": 1 }
    }
  ],
  "answer": null,
  "usage": { "queries_used": 1, "search_cost_usd": 0.008 },
  "metrics": { "response_time_ms": 850, "upstream_latency_ms": 700, "total_results_available": 12 },
  "errors": []
}

Provider quirks

All accept query + max_results. Optional fields vary:

Provider	Supports	Required extras
`tavily`	country, domain_filter, news topic	—
`exa`	domain_filter (incl/excl), news category	—
`brave-search`	country, language	—
`serper`	country, language, news endpoint	—
`perplexity`	country, language, domain_filter	—
`linkup`	domain_filter, time_range	`depth: fast/standard/deep` (option)
`google-pse`	country, language, time_range, offset	`cx` required (providerOptions)
`searchapi`	country, language, pagination	—
`youcom`	country, language, time_range, domain_filter, full_page	—
`searxng`	language, time_range	Self-hosted, noAuth

Provider IS the model — "provider":"tavily" ≡ "model":"tavily".

9router

9Router 是本地/远程 AI 网关，提供 OpenAI 兼容接口。支持聊天、图像、TTS、嵌入、搜索等功能。通过设置环境变量即可使用，自动回退多提供商，简化 AI 集成开发。

用户提及 9Router 用户提及 NINEROUTER_URL 用户希望无需编写提供商样板代码即可使用 AI

skills/9router/SKILL.md

View Skill ›

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

SKILL.md

Frontmatter

{
    "name": "9router",
    "description": "Entry point for 9Router — local\/remote AI gateway with OpenAI-compatible REST for chat, image, TTS, embeddings, web search, web fetch. Use when the user mentions 9Router, NINEROUTER_URL, or wants AI without writing provider boilerplate. This skill covers setup + indexes capability skills; fetch the relevant capability SKILL.md from the URLs below when needed."
}

9Router

Local/remote AI gateway exposing OpenAI-compatible REST. One key, many providers, auto-fallback.

Setup

export NINEROUTER_URL="http://localhost:20128"      # or VPS / tunnel URL
export NINEROUTER_KEY="sk-..."                      # from Dashboard → Keys (only if requireApiKey=true)

All requests: ${NINEROUTER_URL}/v1/... with header Authorization: Bearer ${NINEROUTER_KEY} (omit if auth disabled).

Verify: curl $NINEROUTER_URL/api/health → {"ok":true}

Discover models

curl $NINEROUTER_URL/v1/models                  # chat/LLM (default)
curl $NINEROUTER_URL/v1/models/image            # image-gen
curl $NINEROUTER_URL/v1/models/tts              # text-to-speech
curl $NINEROUTER_URL/v1/models/embedding        # embeddings
curl $NINEROUTER_URL/v1/models/web              # web search + fetch (entries have `kind` field)
curl $NINEROUTER_URL/v1/models/stt              # speech-to-text
curl $NINEROUTER_URL/v1/models/image-to-text    # vision

Use data[].id as model field in requests. Combos appear with owned_by:"combo".

Response shape:

{ "object": "list", "data": [
  { "id": "openai/gpt-5", "object": "model", "owned_by": "openai", "created": 1735000000 },
  { "id": "tavily/search", "object": "model", "kind": "webSearch", "owned_by": "tavily", "created": 1735000000 }
]}

Capability skills

When the user needs a specific capability, fetch that skill's SKILL.md from its raw URL:

Capability	Raw URL
Chat / code-gen	https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-chat/SKILL.md
Image generation	https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-image/SKILL.md
Text-to-speech	https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-tts/SKILL.md
Speech-to-text	https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-stt/SKILL.md
Embeddings	https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-embeddings/SKILL.md
Web search	https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-web-search/SKILL.md
Web fetch (URL → markdown)	https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-web-fetch/SKILL.md

Errors

401 → set/refresh NINEROUTER_KEY (Dashboard → Keys)
400 Invalid model format → check model exists in /v1/models/<kind>
503 All accounts unavailable → wait retry-after or add another provider account

decolua/9router

decolua/9router

Install All Skills

Skills in Collection (8)

9Router — Chat

Endpoints

Discover

OpenAI format

Anthropic format

Response shape

9Router — Embeddings

Discover

Endpoint

Examples

Response shape

Provider quirks

9Router — Image Generation

Discover

Endpoint

Examples

Response shape

Provider quirks

9Router — Speech-to-Text

Discover

Endpoint

Examples

Response shape

Provider quirks

9Router — Text-to-Speech

Discover

Endpoint

Examples

Response shape

Provider quirks (model format)

9Router — Web Fetch

Discover

Endpoint

Examples

Jina Reader

Exa

Firecrawl

Tavily

Response shape

Provider quirks

9Router — Web Search

Discover

Endpoint

Examples

Response shape

Provider quirks

9Router

Setup

Discover models

Capability skills

Errors

文库