接入地址与认证
所有中转端点走统一前缀与鉴权:请求头 Authorization: Bearer <你的 API Key>,与 OpenAI 完全一致。密钥在控制台「API Keys」页创建,仅明文回显一次。
| 入口 | 地址 | 说明 |
|---|---|---|
| API 主入口 | https://mizarapi.com/v1 | 推荐写入 SDK 的 base_url,链路最短 |
| 控制台域 | https://app.mizarapi.com/v1 | 与主入口等价,同库同鉴权 |
端点清单
| 端点 | 能力 |
|---|---|
| POST /v1/chat/completions | 对话补全(含流式 SSE、多模态图片输入、缓存计量) |
| POST /v1/embeddings | 向量嵌入 |
| POST /v1/images/generations | 图像生成(含 Midjourney 系模型原生能力) |
| /v1/videos | 异步视频生成(提交 / 查询 / 内容获取) |
| POST /v1/moderations | 内容审核 |
| POST /v1/rerank | 重排序 |
| GET /v1/models | 当前密钥可用模型列表(按商品授权过滤) |
| POST /v1/cost-estimate | 提交前费用预估(不计费不落账) |
| /v1beta/* | Gemini 原生协议轨(generateContent 等原样透传) |
| /mj/* | Midjourney 原生轨(submit / task fetch / url refresh) |
| POST /mcp | MCP 服务(JSON-RPC 2.0 over Streamable HTTP,Bearer 同密钥) |
可用模型与实时价格以 公开定价页为准;密钥能调用哪些模型由其绑定商品的授权范围决定。
错误与重试
错误响应使用 OpenAI 兼容信封 {"error": {"message", "type", "code"}};每个响应(含错误)都带 X-Request-Id 响应头,报障时提供该值可在控制台逐层还原这次调用。限流按 Key 级 TPM/RPM 口径返回 429;上游异常由多通道路由自动切换重试,业务侧收到的是最终结果。
工具与生态
- 文档中心 — 控制台内完整接入指南与最佳实践
- 试用台 — 登录后免 Key 在线调试端点
- llms.txt — 给 AI Agent 的站点说明(含 MCP 用法)
- openapi.json — OpenAPI 3.1 完整契约
示例:Python (openai SDK)
from openai import OpenAI
client = OpenAI(
api_key="sk-...",
base_url="https://mizarapi.com/v1",
)
resp = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "你好,开阳"}],
)
print(resp.choices[0].message.content)