中文简体

Mistral API 入门指南：快速上手教程

2024-12-31

Mistral API 概述

Mistral API 采用与 OpenAI 兼容的 API 格式，这意味着您可以通过简单的配置修改，使用 OpenAI SDK 或任何与 OpenAI API 兼容的软件来访问 Mistral API。本指南将帮助您快速开始使用 Mistral API。

基本配置参数

主要配置参数包括：

base_url: https://api.Mistral.com
- 为保持与 OpenAI 兼容，您也可以使用 https://api.Mistral.com/v1
- 注意：此处的 v1 与模型版本无关
api_key: 需要申请 API 密钥
model: 使用 Mistral-chat 即可调用最新的 Mistral-V3 模型

API 调用示例

使用 curl 调用

curl https://api.Mistral.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <Mistral API Key>" \
  -d '{
        "model": "Mistral-chat",
        "messages": [
          {"role": "system", "content": "You are a helpful assistant."},
          {"role": "user", "content": "Hello!"}
        ],
        "stream": false
      }'

使用 Python SDK

from openai import OpenAI

client = OpenAI(api_key="<Mistral API Key>", base_url="https://api.Mistral.com")

response = client.chat.completions.create(
    model="Mistral-chat",
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "Hello"},
    ],
    stream=False
)

print(response.choices[0].message.content)

使用 Node.js SDK

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://api.Mistral.com",
  apiKey: "<Mistral API Key>",
});

async function main() {
  const completion = await openai.chat.completions.create({
    messages: [{ role: "system", content: "You are a helpful assistant." }],
    model: "Mistral-chat",
  });

  console.log(completion.choices[0].message.content);
}

main();

重要说明

在开始使用前，请确保已经：
- 申请了 Mistral API 密钥
- 安装了相应的 SDK（如使用 Python 需要 pip install openai，使用 Node.js 需要 npm install openai）
流式输出：
- 默认为非流式输出
- 可以通过设置 stream=true 启用流式输出
- 流式输出适合需要实时响应的场景
模型说明：
- Mistral-chat 模型已全面升级为 Mistral-V3
- 接口保持不变，无需修改现有代码
- 通过指定 model='Mistral-chat' 即可使用最新版本

后续步骤

完成基本配置后，您可以：

探索更多高级 API 参数
实现流式输出功能
集成到您的应用程序中
优化 API 调用效率

现在，您可以开始使用 Mistral API 构建您的 AI 应用了！