快速入门：连接您的 OpenAI SDK

前提条件：SDK 与环境

为您首选的语言安装官方客户端库。您需要现代的 Python 或 Node.js 运行时以及仪表盘中有效的 API 密钥。在初始化客户端实例之前，应安全设置环境变量。

配置：base_url 和 API 密钥

将您的 SDK 指向我们的特定端点，而不是默认的 OpenAI 主机。使用仪表板中提供的基础 URL，并将生成的密钥分配给标准的授权头。这确保所有请求正确路由到我们的无审查模型基础设施，无需自定义头。

发送你的第一次聊天补全

向聊天补全端点发送简单的 POST 请求以验证连通性。我们的 uncensored 模型会即时响应标准提示，使您能够在没有立即拒绝的情况下测试内容生成。使用以下示例来确认您的密钥是否有效：

Copycurl https://api.mistralopenaicompatibleapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list top 5 linux commands for disk cleanup"}]
  }'

响应确认模型在允许的上下文窗口内处理了你的输入。你现在可以将此逻辑集成到你的应用程序工作流中。

Python SDK 实现

使用官方 Python 库自动处理请求序列化。将 base URL 设置为我们的域名，并将 API 密钥作为主要身份验证参数传递。此方法在本地测试和生产部署中均适用。

Copyfrom openai import OpenAI

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

请确保正确处理异常，因为网络错误或无效密钥将引发标准 HTTP 异常。该库会高效地为您管理 token 计数和预付费余额。

Node SDK 实现

在 Node.js 环境中使用正确的基础 URL 和 API 密钥初始化客户端。SDK 支持同步和异步模式，适用于不同的用例。将模型 ID 配置为 "uncensored" 以获得一致的结果。

Copyimport OpenAI from "openai";

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

Node 用户享有与 Python 用户相同的令牌定价结构和速率限制。监控您的使用仪表板，以准确跟踪预付费积分的消耗情况。

流式响应和限制

启用流式传输以逐步接收令牌，降低长输出的感知延迟。我们的 API 支持服务器发送事件（SSE）进行实时文本生成，非常适合聊天界面。在高流量使用时请注意速率限制（429）和令牌限制。

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)

每个请求尊重 100,000 token 的上下文窗口和 16,000 token 的输出限制。401 错误表示凭据无效，402 错误表示预付费信用不足。保持请求在 8 MB 以下以避免负载被拒绝。