✨ Geeknow 向量嵌入 API

本 API 通过 LiteLLM 代理为 AI 智能体与开发者提供 3 个向量嵌入模型。 所有接口均返回 兼容 OpenAI 格式 的向量（4096 维）。

🎉 免费额度 · 每日 1 万次 3 个模型 4096 维
🎉 免费试用 — 已预置管理员演示 Key。可在下方「账号认证」区注册获取你自己的 免费 API Key，每日 1 万次请求额度。

⚡ 核心特性

🚀
高速
LiteLLM 代理
📦
多模型
3 个嵌入模型
🔑
免费 API Key
每日 1 万次
⏳
限流保护
Redis 计数

🌐 服务地址

https://geeknow.geevec.com/embedding_model

🔑 账号与认证

API Key 通过 注册账号 获取。每个账号仅绑定 唯一一个 API Key，账号信息持久化保存。 已有账号可直接 登录 取回你的 Key。所有 Embedding 接口需在请求头携带 X-API-Key。

💡 说明 — 每个账号绑定 唯一 API Key，永久有效，含每日 10,000 次 免费额度。登录接口 POST /api/v1/auth/login 可随时取回你的 Key；用量查询 GET /api/v1/keys/{key}/usage 不消耗额度。

📊 用量与每日限额

项目说明
免费额度每个 Key 每日 10,000 次请求
鉴权方式请求头 X-API-Key
计数存储Redis 计数（内存回退）
重置时间每日零点（Asia/Shanghai）
超出限制HTTP 429 + X-RateLimit-* 响应头

🧠 可用嵌入模型

🌐
通用嵌入
geevec-embeddings-general
4096 维 · 8192 tokens · 每分钟 120 次
语义搜索分类问答
💻
代码嵌入
geevec-embeddings-coding
4096 维 · 40960 tokens · 每分钟 120 次
代码搜索缺陷检测技术文档
🧠
推理嵌入
geevec-embeddings-reasoning
4096 维 · 40960 tokens · 每分钟 120 次
深度推理逻辑检索学术

📡 API 接口

所有嵌入接口使用同一服务地址，参数以 JSON 形式放在请求体中。

🎯 指定模型嵌入 — 接口 1

POST/api/v1/embedding/specific/{model_name}

通过 URL 路径直接调用指定嵌入模型，请求体只需 input，需携带 X-API-Key 请求头。

Path 参数

参数类型必填说明
model_namestringYes可选值：geevec-embeddings-general、-coding、-reasoning

Body 参数

参数类型必填说明
inputstring[]Yes待嵌入的文本数组（至少 1 条）

可用路径

🌐 geevec-embeddings-general 💻 geevec-embeddings-coding 🧠 geevec-embeddings-reasoning

示例

curl -X POST "https://geeknow.geevec.com/embedding_model/api/v1/embedding/specific/geevec-embeddings-general" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{"input":["Hello world","AI is transforming software engineering"]}'
import requests
url = "https://geeknow.geevec.com/embedding_model/api/v1/embedding/specific/geevec-embeddings-general"
resp = requests.post(
    url,
    headers={"X-API-Key": "YOUR_KEY"},
    json={"input": ["Hello world"]}
)
data = resp.json()
print(data["data"][0]["embedding"][:5])
const url = "https://geeknow.geevec.com/embedding_model/api/v1/embedding/specific/geevec-embeddings-general";
const resp = await fetch(url, {
  method: "POST",
  headers: {"Content-Type": "application/json", "X-API-Key": "YOUR_KEY"},
  body: JSON.stringify({input: ["Hello world"]})
});
const data = await resp.json();
console.log(data.data[0].embedding.slice(0, 5));

▶ 试一试

📋 模型列表

POST/api/v1/embedding/models

返回全部可用嵌入模型及其元数据（维度、最大 token、适用场景）。无需 API Key。

响应： {count: 3, data: [{name, display_name, dimensions, max_input_tokens, use_cases}, ...]}

示例

curl -X POST "https://geeknow.geevec.com/embedding_model/api/v1/embedding/models"
import requests
url = "https://geeknow.geevec.com/embedding_model/api/v1/embedding/models"
resp = requests.post(url)
data = resp.json()
print(data["count"], [m["name"] for m in data["data"]])
const resp = await fetch("https://geeknow.geevec.com/embedding_model/api/v1/embedding/models", {
  method: "POST"
});
const data = await resp.json();
console.log(data.count, data.data.map(m => m.name));

▶ 试一试

无需 API Key，点击即可获取完整模型列表。

🔑 创建 API Key

POST/api/v1/keys

创建免费 API Key，每日 1 万次请求。密钥永久有效（不过期），存储于 Redis。

参数类型必填说明
namestringNo密钥备注（默认 "free-user"）

Example Response

{
  "api_key": "gk-a1b2c3d4e5f6...",
  "name": "free-user",
  "created": "2026-07-15T04:00:00Z",
  "message": "Free tier: 10,000 requests/day"
}

▶ 试一试

📈 查询用量

GET/api/v1/keys/{key}/usage

查询指定 API Key 今日调用次数。该接口不消耗每日额度。

示例

curl https://geeknow.geevec.com/embedding_model/api/v1/keys/YOUR_KEY/usage

Example Response

{
  "api_key_hint": "gk-a1b2c3d4...wxyz",
  "today": "2026-07-15",
  "requests_today": 42,
  "daily_limit": 10000,
  "remaining": 9958,
  "reset_at": "2026-07-15T23:59:59+08:00"
}

▶ 试一试

❌ 吊销 API Key

DELETE/api/v1/keys/{key}

吊销已有 API Key，吊销后立即无法鉴权。

示例

curl -X DELETE https://geeknow.geevec.com/embedding_model/api/v1/keys/YOUR_KEY

▶ 试一试

⚠ 警告 —— 此操作不可撤销，吊销后立即无法鉴权。

⚠ 错误处理

HTTP 状态含义典型提示
200成功请求处理成功
400请求参数错误参数无效或模型不存在
401未授权缺少 X-API-Key 请求头
403禁止访问API Key 无效或已吊销
404未找到API Key 不存在
429请求过多Daily limit (10,000) exceeded — resets at midnight
502网关错误LiteLLM 服务不可达
504网关超时LiteLLM 服务超时

⏳ 限流策略

每个 API Key 限制为 每日 1 万次免费请求，每日零点（Asia/Shanghai 时区）重置。

限流响应头

响应头示例说明
X-RateLimit-Limit10000每日请求上限
X-RateLimit-Remaining9942今日剩余请求数
X-RateLimit-Reset1752681600下次重置的 Unix 时间戳（仅 429 时返回）
⚠ When exceeded — The API returns HTTP 429 with the detail message "Today's free quota (10,000 requests) has been exhausted. Resets at midnight."

🎮 调试台

通过实时请求测试接口，每次调用消耗 1 次每日额度。

当前接口： POST /api/v1/embedding/general  — 在下方选择不同接口
每一行作为一条独立的待嵌入文本