Mistral AI API：快速入门指南

基础 URL 和认证

配置客户端的第一步是指向我们的基础设施。将标准的 OpenAI 基础 URL 替换为 HTTPS://api.apimistralai.com/v1，并将你的唯一 API 密钥注入授权头。这个简单的交换将所有请求重定向到我们的无审查模型，同时保持你现有的集成逻辑不变。

• 基础 URL：HTTPS://api.apimistralai.com/v1
• 认证：通过 Authorization 页眉

确保您的密钥在测试连接之前在账户仪表板中处于活动状态。

首次请求

发送标准聊天补全请求以验证连通性和模型响应。以下 curl 命令针对 uncensored 模型使用基本提示。

这确认了端点可达，并返回未经标准内容过滤器过滤的文本。

Copycurl https://api.apimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python list comprehension"}]
  }'

如果响应包含文本，则您的集成已成功路由至我们的无审查推理层。

Python SDK 集成

使用官方 OpenAI Python 库与我们的 API 交互，而无需修改核心请求结构。使用新的 base URL 和您的 API 密钥初始化客户端，然后调用 chat.completions.create.

这种方法允许您保留所有现有的 Python 逻辑，同时获得无审查模型的功能。

Copyfrom openai import OpenAI

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

响应对象的行为与标准 OpenAI 响应完全相同，使 Python 开发者的迁移变得无缝。

Node SDK 集成

对于 JavaScript 或 TypeScript 环境，请使用自定义基础 URL 初始化 OpenAI 包。设置 apiKey 和 baseURL 调用前的属性 chat.completions.create.

这确保了您的 Node.js 应用将请求路由至我们的 uncensored 端点，同时保持与标准 SDK 模式的兼容性。

Copyimport OpenAI from "openai";

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

响应结构与 OpenAI 标准保持一致，允许轻松集成到现有的 Node.js 工作流中。

通过 SSE 实现流式响应

通过将 stream: true 在您的请求中。API 返回服务器发送事件（SSE）流，允许您处理生成的令牌。

这降低了用户的感知延迟，并在长完成期间提供即时反馈。

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)

解析 SSE 数据流以增量显示令牌。最后一个块包含请求的总令牌使用情况。

限制、错误和上下文

根据严格的速率限制监控使用情况并优雅地处理常见的 HTTP 错误。您允许每分钟 300 个请求和每个密钥 8 个并发请求。

401 错误表示缺少或无效的 API 密钥，而 402 错误表示预存余额已耗尽。429 状态码表示您已超过每分钟 300 次请求的限制。

您的上下文窗口总计支持 100,000 个令牌，每次请求的最大输出为 16,000 个令牌。错误和拒绝不消耗额度，确保您只为实际生成的内容付费。