Mistral La Plateforme 免费额度申请：Experiment 层全模型开放，含代码模型调用

Mistral 的接口与 OpenAI 的对话补全格式高度兼容，base_url 形态为 https://api.mistral.ai/v1，只需替换地址和 Key，原有的 OpenAI SDK 代码基本可以直接复用。先把 Key 写进环境变量，避免硬编码到代码里：

export MISTRAL_API_KEY="控制台 API Keys 页面生成的 Key"

获取可用模型名

模型名会随版本更新，最稳妥的方式是直接查询模型列表接口，在返回结果里取 id 字段。常用模型包括 mistral-large-latest（旗舰通用）、mistral-small-latest（低成本）、codestral-latest（代码补全）、open-mistral-nemo（轻量开源版）。

curl https://api.mistral.ai/v1/models \
  -H "Authorization: Bearer $MISTRAL_API_KEY"

一次对话补全调用

下面的 curl 请求可以直接运行，请求体使用 messages 数组承载多轮上下文：

curl https://api.mistral.ai/v1/chat/completions \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-small-latest",
    "messages": [
      {"role": "system", "content": "你是一名后端工程师，回答尽量简短。"},
      {"role": "user", "content": "用一句话解释什么是向量数据库。"}
    ],
    "temperature": 0.7,
    "max_tokens": 256,
    "stream": false
  }'

关键参数含义如下：

• model：必填，填模型列表接口返回的 id，写错会直接报模型不存在。
• messages：必填，按 system、user、assistant 顺序组织多轮对话，越靠后的消息权重越高。
• temperature：采样随机度，取值 0 到 1，写代码、做抽取建议 0.05 到 0.2，创意写作可放到 0.7 以上。
• max_tokens：本次回复的最大生成长度，免费层建议控制在几百以内，避免单次就把额度打光。
• top_p：与 temperature 二选一调整即可，同时改动容易让输出不可控。
• stream：设为 true 时以 SSE 方式流式返回，适合做打字机效果，需在客户端逐块解析 data: 行。

用 OpenAI SDK 复用

Python 侧只要改 base_url 即可，SDK 与参数名保持不变：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MISTRAL_API_KEY"],
    base_url="https://api.mistral.ai/v1",
)

resp = client.chat.completions.create(
    model="mistral-large-latest",
    messages=[{"role": "user", "content": "写一个 Python 快速排序函数"}],
    temperature=0.2,
    max_tokens=512,
)
print(resp.choices[0].message.content)

额度耗尽与限流的排查顺序

免费层的典型故障都能从状态码看出来：返回 401 表示 Key 无效；返回 422 或 400 多为参数或模型名写错；返回 429 表示触发限速或免费配额已用尽；返回 402 则是需要升级付费。按下面顺序排查最省时间：

1. 先单独请求模型列表接口，能返回数据说明网络与 Key 都正常，问题在请求体。
2. 遇到 401 时检查 Key 是否复制完整、前后是否多了空格或换行，以及该 Key 是否已被删除。
3. 遇到 429 时看响应头里的重试等待时间，用指数退避重试，并把并发降到 1 到 2 路；免费层对每分钟请求数和 token 数都有约束，并发调高必然撞限速。
4. 确认控制台用量页是否已接近本期上限，若已用尽，只能等配额周期重置或升级付费方案，没有旁路可用。
5. 排除本地问题：代理或 CDN 改写请求头导致鉴权失败时，用 curl 直连对照一次即可定位。
6. 最后再检查模型名是否已下线，代码里的写死模型建议改为从模型列表接口动态读取，避免版本更新后整批调用失败。

上线前请务必确认业务数据的敏感级别。免费层要求开启数据用于训练，任何涉及源码、密钥和用户隐私的请求都不应走这条线路。