每一个 AI 模型，
一个通用代币

概述

mvajih 提供一套统一的 AI 模型 API 网关，兼容 OpenAI 接口协议。开发者只需将 baseURL 指向 mvajih 的网关地址，并使用 mvajih 颁发的 API Key，即可调用平台上所有支持的 AI 模型。

核心特性：

• 统一接口：所有模型使用相同的 API 格式，无需学习多套接口规范。
• 通用代币：一次充值，在所有模型上通用，按 Token 计费。
• 智能路由：通过 x-mvajih-model 头指定模型，或启用自动路由。
• 全链路观测：提供用量统计、调用日志、成本分析等可观测性能力。

认证与鉴权

mvajih 使用 API Key 进行身份认证。所有 API 请求必须在 HTTP Header 中携带有效的 API Key。

# 请求头示例
Authorization: Bearer mv_sk_xxxxxxxxxxxxxxxxxxxxxxxx

API Key 类型：

• 主账号 Key：拥有完整权限，可管理子账号、查看所有用量。
• 子账号 Key：受配额与权限限制，适用于团队协作与项目隔离。

你可以在 mvajih 控制台的 "API Key 管理" 页面创建、吊销和设置 Key 的权限与配额。

API 接口

mvajih 提供与 OpenAI 兼容的 Chat Completions API 接口。

接口地址：

https://api.mvajih.cn/v1/chat/completions

请求参数：

参数	类型	必填	说明
model	string	是	模型名称，如 gpt-4-turbo、claude-3.5-sonnet。可使用 auto 启用智能路由。
messages	array	是	对话消息列表，格式与 OpenAI 一致。
temperature	number	否	采样温度，0-2，默认 1.0。
max_tokens	integer	否	最大生成 Token 数。
stream	boolean	否	是否启用流式输出，默认 false。

请求示例：

curl https://api.mvajih.cn/v1/chat/completions \
  -H "Authorization: Bearer mv_sk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4-turbo",
    "messages": [
      {"role": "user", "content": "Hello, world!"}
    ]
  }'

响应格式：与 OpenAI API 完全兼容，包含 id、choices、usage 等字段。

模型列表

mvajih 支持以下主流模型（持续更新中）：

模型名称	提供商	类型	模型 ID
GPT-4 Turbo	OpenAI	语言	gpt-4-turbo
GPT-4o	OpenAI	语言	gpt-4o
Claude 3.5 Sonnet	Anthropic	语言	claude-3.5-sonnet
Claude 3 Opus	Anthropic	语言	claude-3-opus
DeepSeek V3	DeepSeek	语言	deepseek-v3
DeepSeek R1	DeepSeek	语言	deepseek-r1
Gemini Pro	Google	多模态	gemini-pro
通义千问 Max	阿里云	语言	qwen-max
智谱 GLM-4	智谱 AI	语言	glm-4
可灵 Kling	快手	视频	kling
DALL-E 3	OpenAI	图像	dall-e-3
... 更多模型请参考控制台

智能路由

mvajih 提供智能路由能力。当你在请求中指定 model: "auto" 时，路由引擎会根据以下维度自动选择最优模型：

• 任务类型：根据输入内容自动识别任务类型（对话、推理、翻译、代码等）。
• 质量评分：基于社区评测与内部测试，为每个模型维护实时质量分数。
• 成本优化：在保证质量的前提下，优先选择性价比最高的模型。
• 延迟要求：根据你的 SLA 需求，平衡响应速度与模型能力。

你也可以通过 x-mvajih-routing 头传递路由偏好：

# 偏好低成本
x-mvajih-routing: cost-first

# 偏好高质量
x-mvajih-routing: quality-first

# 偏好低延迟
x-mvajih-routing: speed-first

错误码

mvajih API 使用标准的 HTTP 状态码与错误响应格式：

状态码	错误类型	说明
200	—	请求成功
400	bad_request	请求参数错误
401	unauthorized	API Key 无效或已过期
403	forbidden	权限不足或配额已用完
404	not_found	模型不存在
429	rate_limited	请求过于频繁，请稍后重试
500	internal_error	服务内部错误

错误响应示例：

{
  "error": {
    "type": "unauthorized",
    "message": "Invalid API Key provided."
  }
}

SDK

mvajih 官方提供以下语言的 SDK，方便开发者快速集成：

• Python: pip install mvajih
• JavaScript/TypeScript: npm install mvajih
• Go: go get github.com/mvajih/mvajih-go
• Java: 通过 Maven 引入 com.mvajih:mvajih-sdk

SDK 使用示例（Python）：

from mvajih import Mvajih

client = Mvajih(api_key="mv_sk_xxxxxxxx")

response = client.chat.completions.create(
    model="gpt-4-turbo",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)