API 文档

认证与基础 URL

首先将客户端指向正确的基础 URL。我们接受标准的 OpenAI 请求头以实现兼容性。您的 API 密钥作为 Bearer 令牌放入 Authorization 请求头中。直接从环境变量中传递它，以避免硬编码密钥。此设置适用于任何支持 OpenAI 协议的库。

首次请求

发送一个简单的聊天补全以验证连接性。使用模型 ID "uncensored" 进行文本生成。该端点返回包含 choices 和 usage 指标的标准 JSON。如果收到 401，请检查您的密钥格式。402 表示预付费余额不足。此快速测试确认您的集成已准备好处理生产流量。

Copycurl https://api.mistralbaseurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List installed python packages with versions"}]
  }'

Python SDK 集成

配置 OpenAI Python 包以使用我们的 base URL。显式设置 API 密钥和模型名称。将您的消息作为具有 role 和 content 键的字典列表传递。响应对象在 choices[0].message.content 中包含生成的文本。优雅地处理异常，以捕获执行期间的网络或速率限制错误。

Copyfrom openai import OpenAI

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

Node.js SDK 设置

使用您的基础 URL 和密钥初始化 OpenAI 客户端。定义包含 user 和 assistant 角色的 messages 数组。调用 chat.completions.create 并使用 uncensored 模型。响应将在第一个 choice 中提供生成的文本。在 Node 应用中，此模式适用于同步和异步调用。

Copyimport OpenAI from "openai";

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

流式响应

通过将 stream 设置为 true 来启用流式传输。API 在生成数据时发送数据块。每个数据块包含您可以追加到缓冲区的增量文本。这种方法降低了长输出的感知延迟。在最后一个数据块中监控令牌使用情况以准确跟踪计费。

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。您可以每分钟发送 300 次请求。同时运行的请求仅限 8 个。请求体超过 8MB 将失败。利用这些限制来设计您的重试逻辑。429 等错误表示触发了速率限制。拒绝请求不会消耗信用额度。