状态检测
状态检测

代码示例

本页放「怎么用」的常见片段（初始化、批量、维度、Rerank 的调用方式等）。每个接口的参数/返回结构与完整多语言示例请看：

SDK 初始化（OpenAI Compatible）

SDK 调用与 OpenAI 官方一致，只需要把 base_url（或 baseURL）改为 https://router.tumuer.me/v1，并填入控制台生成的 api_key。

Python
JavaScript
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://router.tumuer.me/v1",
    api_key=os.environ["OPENAI_API_KEY"],  # 在控制台生成
)

Embeddings：常见用法

批量向量化（一次请求多条 input）

Python（openai SDK）
JavaScript（openai SDK）
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://router.tumuer.me/v1",
    api_key=os.environ["OPENAI_API_KEY"],
)

response = client.embeddings.create(
    model="Qwen/Qwen3-Embedding-4B",
    input=["第一段文本", "第二段文本"],
    encoding_format="float",
)

print("count:", len(response.data))
print("dim:", len(response.data[0].embedding))

指定输出维度（仅部分模型支持）

Python（openai SDK）
JavaScript（openai SDK）
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://router.tumuer.me/v1",
    api_key=os.environ["OPENAI_API_KEY"],
)

response = client.embeddings.create(
    model="Qwen/Qwen3-Embedding-4B",
    input="这是一段需要转换成向量的文本",
    encoding_format="float",
    dimensions=1024,
)

print("dim:", len(response.data[0].embedding))

多模态 Embedding（图像 URL / data URL）

jina-clip-v1 / jina-clip-v2 / Qwen3-VL-Embedding-* / nvidia/nv-dinov2 可通过 /embeddings 调用。推荐传可访问的图片 URL，或 data:image/...;base64,... 字符串。

Python（requests）
JavaScript（fetch）
cURL
import os
import requests

url = "https://router.tumuer.me/v1/embeddings"
headers = {
    "Authorization": f"Bearer {os.environ['OPENAI_API_KEY']}",
    "Content-Type": "application/json",
}

payload = {
    "model": "jina-clip-v2",
    "input": "https://example.com/cat.png",
}

resp = requests.post(url, headers=headers, json=payload, timeout=60)
resp.raise_for_status()
data = resp.json()

print("dim:", len(data["data"][0]["embedding"]))

更多字段说明与多语言示例见 创建嵌入请求。

Rerank：常见用法

/rerank 不是 OpenAI 标准端点；如果你仍想复用 OpenAI SDK 的鉴权与 baseURL 配置，可以用 SDK 的“自定义请求”能力直接 POST /rerank（完整示例见 创建重排序请求）。

Python（openai SDK，自定义请求）
JavaScript（openai SDK，自定义请求）
from openai import OpenAI
import httpx
import os

client = OpenAI(
    base_url="https://router.tumuer.me/v1",
    api_key=os.environ["OPENAI_API_KEY"],
)

resp = client.post(
    "/rerank",
    cast_to=httpx.Response,
    body={
        "model": "Pro/BAAI/bge-reranker-v2-m3",
        "query": "Apple",
        "documents": ["apple", "banana", "fruit", "vegetable"],
        "top_n": 10,
        "return_documents": False,
    },
)

resp.raise_for_status()
print(resp.json())

Cohere Rerank（cohere/rerank-v3.5）

Python（openai SDK，自定义请求）
JavaScript（openai SDK，自定义请求）
from openai import OpenAI
import httpx
import os

client = OpenAI(
    base_url="https://router.tumuer.me/v1",
    api_key=os.environ["OPENAI_API_KEY"],
)

resp = client.post(
    "/rerank",
    cast_to=httpx.Response,
    body={
        "model": "cohere/rerank-v3.5",
        "query": "Apple",
        "documents": ["apple", "banana", "fruit", "vegetable"],
        "top_n": 2,
        "return_documents": True,
    },
)

resp.raise_for_status()
print(resp.json())

提示：jina-reranker-m0、Qwen3-VL-Reranker-* 的 supported_endpoint_types 为 rerank-multimodal，当前站点公开 API 暂未开放独立 rerank-multimodal 路由。

更多字段说明与多语言示例见 创建重排序请求。

ON THIS PAGE