快速入门：连接您的客户端

前提条件与 SDK 安装

为您的语言安装官方 SDK，以自动处理身份验证和请求序列化。您需要有效的 API 密钥，并在客户端环境中配置基础 URL。我们的服务接受 temperature 和 top_p 等标准参数，无需自定义标头。

确保您的环境变量在运行任何脚本之前安全地保存了您的 token。SDK 版本必须是最新的，以正确支持流式传输和 JSON 模式功能。文本生成不需要额外的驱动程序。

配置基础 URL 和密钥

将您的客户端指向我们的特定基础 URL，通过我们的 uncensored 基础设施路由请求。使用标头 Authorization: Bearer YOUR_KEY 对每次调用进行身份验证。此设置对于本地测试或生产部署脚本均适用。

用我们的主机替换默认的 OpenAI 端点，以避免与其他提供商混淆。保持密钥保密，不要将其暴露在公共存储库中。配置在轮换密钥之前保持静态。

发送您的第一个请求

执行标准聊天补全调用以验证连接和响应格式。发送简单提示以确认模型返回文本且无拒绝。此测试确保您的密钥有足够的预存信用用于使用。

Copycurl https://api.keyapiminimax.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a JSON object with keys id and name"}]
  }'

检查响应以获取内容和令牌使用详情。如果收到 401 错误，请验证您的密钥格式。402 错误表示您需要充值积分余额。

处理流式响应

启用流式传输以实时接收生成的令牌。这降低了用户等待长输出时的感知延迟。最后一个数据块包含最终的令牌计数以确保计费准确。

Copystream = 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)

在客户端代码中优雅地处理部分响应。在流关闭或发生错误之前缓冲内容。流式传输支持所有标准参数，包括温度调整。

Python SDK 集成

使用 Python 库以最小的样板代码管理请求。使用您的 base URL 和密钥初始化客户端即可立即使用。这种方法简化了错误处理和响应解析。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.keyapiminimax.com/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)

直接从响应对象访问生成的内容。检查错误并适当处理速率限制。SDK 支持同步和异步工作流。

Node SDK 和限制

使用官方 JavaScript SDK 将 Node.js 应用程序集成。设置基础 URL 以确保请求到达我们的无审查端点。监控您的使用情况以保持在速率限制内。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.keyapiminimax.com/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);

每个密钥每分钟可发起 300 次请求，并发数为 8。每个请求体必须小于 8 MB。上下文窗口总共支持 100,000 个 token。错误和拒绝不消耗额度，但成功输出会消耗额度。请妥善保管密钥，必要时请轮换。

理解 Token 使用

计费基于提示词和补全中使用的实际 Token。输入 Token 每百万 $0.15，输出 Token 每百万 $0.50。预存额度覆盖所有用量，无月度费用。

错误和拒绝均免费，因此您只需为成功的响应付费。流式传输的最后一个块包含令牌计数。请监控您的仪表板以跟踪支出，避免信用额度耗尽。使用 USDT 或 USDC 充值即可即时获取额度。