分五步创建密钥
要获取此服务的Mimo API 密钥，请按照以下步骤操作。此处无需银行卡或电话验证。
- 注册。 使用 Google，或使用邮箱地址和密码注册。
- 打开密钥页面。 注册后，前往API 密钥页面。你的密钥将显示在该页面。
- 领取试用。 新用户可以在该页面一键领取 $0.50试用额度。该额度有效期 7 天，无需银行卡，每人限领一次。
- 复制密钥 并将其存储在安全的地方，例如密码管理器或环境变量中。
- 发送测试请求 使用下一节中的 curl 命令。
该服务是一个托管的、兼容 OpenAI 的文本 API。它运行来自独立供应商的一个开放权重模型，针对合法成人用途进行了调整，可提供无内容拒绝的回答。它不是任何模型供应商的官方 API。你的密钥适用于该单一模型，其模型 ID 为uncensored，基础 URL 为https://api.mimoapi.top/v1。
用一个请求测试密钥
在将密钥接入应用之前，请在终端中执行测试。如果在此处失败，问题出在密钥或账户上，你无需在自己的代码中搜索。
export LLM_API_KEY="paste-your-key-here"
curl -i https://api.mimoapi.top/v1/chat/completions \
-H "Authorization: Bearer $LLM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write one sentence about keys."}],
"max_tokens": 60
}'良好的结果是返回200状态码以及包含choices数组的 JSON 响应体。响应头包含X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests 和X-RateLimit-Limit-Concurrency。余额响应头是查看请求成本的快捷方式：运行两次并比较。如果只想确认密钥而不花费任何额度，请使用相同的请求头调用GET /v1/models。
使用官方 OpenAI 包在 Python 中发起相同请求：
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.mimoapi.top/v1",
api_key=os.environ["LLM_API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write one sentence about keys."}],
max_tokens=60,
)
print(resp.choices[0].message.content)试用密钥能做什么和不能做什么
试用额度用于测试，而非生产环境。试用密钥允许 2 个并发请求和每分钟 60 个请求，有效期 7 天。完整密钥（在充值后获得）允许 8 个并发请求和每分钟 300 个请求。两者共享相同的模型、相同的 100,000 token 上下文窗口和相同的功能：SSE 流式输出、函数调用、JSON 模式和通常的采样参数。
$0.50能跑多少？输入 token 每 100 万 $0.15，输出 token 每 100 万 $0.50。一次请求包含 1,000 个输入 token 和 300 个输出 token，输入费用为 1,000 x 0.15 / 1,000,000 = $0.00015，输出费用为 300 x 0.50 / 1,000,000 = $0.00015，总计 $0.0003。试用额度可覆盖约 1,666 次该规模的请求（0.50 / 0.0003）。这足以测试提示词、构建原型并尝试流式输出或工具。
使用试用额度进行测量。选择你的应用最常发送的五个提示词，每个运行几次，并记录余额变化。一周结束时，你将获得每个请求的实际成本，并了解模型在你数据上的表现。失败或被拒绝的请求不扣费。
保持密钥私密
API 密钥也是一种会花钱的密码。任何拥有它的人都可以使用你的余额发起请求。几条规则可防止大部分泄露：
- 使用环境变量，而非源文件。 使用
os.environ或process.env读取密钥。对于本地工作，将.env文件列入.gitignore即可。 - 仅服务端。 不要从浏览器 JavaScript 或移动应用调用 API，因为任何人都可以从页面或应用包中读取密钥。在你的前端和 API 之间放置一个小服务器。
- 每个密钥一个位置。 将密钥保存在一个密钥库中，并从此处复制到每个部署中，这样你始终知道它在哪里。
- 不要在聊天、工单或截图中包含密钥。 寻求帮助时，分享响应中的
X-Request-Id，而不是密钥。 - 怀疑泄露时立即更换。 如果你认为密钥已泄露，请停止使用并联系支持团队进行更换。
同时监控X-Balance-USD 响应头。如果应用空闲时余额下降，这是他人正在使用你密钥的第一个迹象。
超越试用：充值并付费
试用额度用完后，请充值。任何 $20至 $500的整数金额均可。奖金会自动添加：充值 $50获得 5% 奖金，充值 $100获得 10% 奖金，充值 $200获得 15% 奖金。因此，充值 $100可获得 $110额度，充值 $200可获得 $230额度。你可以使用加密货币（TRC20 上的 USDT、Base 链上的 USDC）支付。
没有订阅制。你根据余额按 token 付费，且额度永不过期，适合流量不均的项目。完整价格列表见定价页面。通过 API 发送的提示词不会用于训练。
合理的初次充值金额为 $20。按本页面前面使用的聊天大小请求计算（每次 $0.0003），这可以覆盖约 66,000 次请求。几天后检查你的平均成本并进行调整。
密钥无法工作的故障排除
大多数密钥问题都有简单的原因。
- 立即出现认证错误。 复制时丢失或添加了字符。查找前导或尾随空格，或换行符。检查请求头是否为
Authorization: Bearer后接密钥。 - curl 可用，但应用不行。 应用可能没有读取环境变量。打印其看到的值的前四个字符，而不是整个密钥。
- 未找到。 基础 URL 不正确。它必须是
https://api.mimoapi.top/v1，位于api子域名下。快速入门 提供了按客户端分类的列表。 - HTTP 429。 代码
concurrency表示同时请求过多；rate_limited表示每分钟请求过多。试用密钥更容易达到此限制（同时 2 个，每分钟 60 个）。带有Retry-After: 5的 429 表示短暂过载；等待五秒。 - 试用额度缺失。 试用额度需在密钥页面点击领取，每人限领一次。7 天后过期。
如果以上方法均无效，请从失败的响应中收集X-Request-Id 值并联系支持团队。该 ID 允许在不发送密钥的情况下追踪问题。
首先构建什么
拥有有效的密钥后，选择一个使用你后续所需功能的小项目。命令行聊天循环可帮助你理解消息历史。返回带有 response_format 的 JSON 对象的脚本可帮助你掌握结构化输出。模型可调用的函数可帮助你掌握工具使用。每个项目耗时不到一小时，且均可在试用额度下运行。如果你正在将此服务与其他托管模型进行比较，Mistral API 替代方案 中的对比列出了在做出决定之前值得询问的问题。
保持使用合法且面向成人。该模型经过调整，可提供无内容拒绝的回答，这是小说、角色扮演和研究的功能，但这并不意味着可以打破规则：涉及未成年人的性内容始终不允许。
