API 文档

OpenAI 兼容契约的接入导览。字段级权威定义见 OpenAPI 3.1; Agent 可读说明见 llms.txt。

接入地址与认证

所有中转端点走统一前缀与鉴权:请求头 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 /mcpMCP 服务(JSON-RPC 2.0 over Streamable HTTP,Bearer 同密钥)

可用模型与实时价格以 公开定价页为准;密钥能调用哪些模型由其绑定商品的授权范围决定。

错误与重试

错误响应使用 OpenAI 兼容信封 {"error": {"message", "type", "code"}};每个响应(含错误)都带 X-Request-Id 响应头,报障时提供该值可在控制台逐层还原这次调用。限流按 Key 级 TPM/RPM 口径返回 429;上游异常由多通道路由自动切换重试,业务侧收到的是最终结果。

工具与生态

示例:Python (openai SDK)

quickstart.py
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)