Base URL 和认证
首先,将你的 OpenAI 兼容客户端指向 Mimo API 的 Base URL。使用 Google 或电子邮件注册后,你将立即获得 API 密钥。将此密钥传入标准的 Authorization 头。模型标识符为 uncensored,它运行着一个开放权重模型,针对合法成人内容的拒绝率进行了优化。
与订阅服务不同,计费通过加密货币预付。错误不消耗额度。你可以通过列出模型或发送简单的文本提示来验证连接。请妥善保管密钥;每个账户一个密钥,生成新密钥时将替换旧密钥。
标准聊天补全接口
向聊天补全接口发送标准的 POST 请求。将模型设置为 uncensored,并按要求的数组格式提供消息。API 根据你的提示词返回文本输出。你可以调整 temperature 或 top_p 等参数来控制创造性。
curl https://api.mimoapi.top/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'此接口处理文本输入和文本输出的交互。它不支持嵌入、图像或微调。如果需要这些功能,必须使用其他服务。上下文窗口允许提示词和补全总共 100,000 个 token。
Python SDK 集成
使用官方 OpenAI Python 库与 API 交互。覆盖 Base URL 以指向 Mimo API 接口。这允许你使用用于 GPT-4 或其他模型的相同 SDK 方法。在客户端配置中设置 API 密钥和目标模型。
from openai import OpenAI
client = OpenAI(base_url="https://api.mimoapi.top/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)这种方法确保你的代码保持可移植性。如果更换提供商,只需更改 Base URL 和密钥。Python SDK 自动处理序列化和重试。你还可以设置 seed 以获得确定性输出。
Node SDK 集成
安装 OpenAI Node.js 包并配置 Base URL。在配置对象中传递 API 密钥。客户端会将请求路由到无审查模型接口。这适用于 CommonJS 和 ES 模块导入。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mimoapi.top/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Node 开发者可以使用与其他 OpenAI 兼容服务相同的异步模式。SDK 处理流解析和 JSON 编码。你可以设置 max_tokens 来控制输出长度,如果未指定则默认为 2,048。
流式响应 (SSE)
通过在请求中设置 stream: true 启用流式输出。API 返回包含部分 token 的服务器发送事件 (SSE)。这允许你向用户逐步显示输出。Token 使用统计信息出现在流的最后一个块中。
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)流式输出降低了长响应的感知延迟。你必须在客户端代码中处理流事件。API 不保证流式传输期间的确切 token 计数,但最后一个块包含准确的使用数据。这有助于计费透明。
速率限制、错误和 JSON 模式
API 对每个密钥实施每分钟 300 次请求的限制,并允许 8 个并发请求。如果超过此限制,你将收到 429 错误。401 错误表示密钥无效或已过期。预付额度仅按实际 token 用量计费;错误和拒绝免费。
对于结构化输出,使用 JSON 模式,将 response_format 设置为 json_object。这强制模型返回有效的 JSON。这对于函数调用或数据提取很有用。上下文窗口支持每次请求最多 32,000 个 token 的输出。