Mistral API 集成指南

为什么要从标准 Mistral API 切换？

开发者常遇到打断其工作流程的内容过滤器。标准 API 会拒绝特定主题。我们的无审查模型直接回答。你保留对输出的完全控制权。

标准的 Mistral API 是可靠的。它提供流行的模型。但是，它应用自己的审核层。您可能会看到对创意写作或成人主题的拒绝。我们的 API 移除了这些障碍。它运行一个经过调整以减少限制的开源权重模型。您将获得相同的兼容 OpenAI 的端点。

成本是另一个因素。标准计划通常将您锁定在订阅中。我们使用预付费信用系统。您只为使用的部分付费。错误不会消耗您的 token。这种透明度有助于您准确预算。

迁移很简单。您现有的代码可以运行。您只需更改基础 URL。无需复杂的重写。这种灵活性适合希望进行无审查生成而无需管理本地模型的开发人员。

步骤 1：获取你的 API 密钥

首先在我们的平台上创建一个账户。您可以使用 Google 登录，也可以使用电子邮件和密码。不需要电话号码。这可以保护您的身份隐私。

登录后，请导航至仪表板。立即生成您的 API 密钥。该密钥仅显示一次。复制并安全存储。每次请求都需要用到它。

您自动获得试用额度。新账户获得 $0.50，有效期为 7 天。这让您在投入资金之前可以测试集成。

您的密钥有特定限制。您每分钟可发起 300 次请求。同时运行的请求仅限 8 个。每个密钥均与您的账户唯一绑定。如果您生成新密钥，旧密钥将停止工作。这确保了您信用额度的安全访问。

步骤 2：配置你的 Base URL

基础 URL 是最重要的更改。将您的 SDK 指向我们的端点。使用标准的 OpenAI 格式。这确保与您现有库的兼容性。

将 base URL 设置为 HTTPS://api.mistralbaseurl.com/v1。此路径镜像了主要提供商的结构。您的代码将正确识别端点。您不需要新的驱动程序或客户端。

更新代码中的 API 密钥变量。用新的密钥替换旧的提供商密钥。确保密钥字符串正确。拼写错误会导致立即出现身份验证错误。

通过简单的 ping 测试连接。请求可用模型列表。您应该看到我们的无审查模型列出。这确认您的配置正确。您现在可以发送提示词了。

步骤 3：实现聊天补全

向聊天补全端点发送 POST 请求。使用模型 ID "uncensored"。这将触发我们特定的大型语言模型。它处理您的输入并生成文本。

将您的消息构建为数组。包括 system、user 和 assistant 角色。模型会密切遵循这些指令。您可以设置 temperature 和 top_p 等参数。这些控制输出的创造性。

上下文窗口为 100,000 个 token。这支持长文档处理。您可以在单次请求中传入大量上下文。模型能在长序列中保持连贯性。这对于代码分析或摘要非常有用。

最大输出为 16,000 个 Token。如果您未设置 max_tokens，则限制为 2,048。根据您的需求调整此参数。较长的响应需要更多额度。请相应地规划您的 Token 预算。

处理流式传输和令牌

流式传输改善用户体验。它生成令牌时发送令牌。这降低了感知延迟。在 SDK 设置中启用流式传输。

我们使用服务器发送事件 (SSE)。流提供文本块。每个数据块包含响应的一部分。您可以实时显示令牌。

Token 用量在最后一个数据块中报告。这确保了计费的准确性。您能看到确切的消耗量。错误不会向您收费。拒绝请求免费。这能保护您的预算免受无效请求的影响。

定期监控您的信用余额。您可以随时通过加密货币充值。信用永不过期。这允许您暂停使用而无需惩罚。您可以无限期保留余额。

函数调用与 JSON 模式

我们的 API 支持结构化输出。您可以强制启用 JSON 模式。将 response_format 设置为 json_object。模型仅返回有效的 JSON。这对于集成至关重要。

函数调用运行顺畅。在请求中定义您的工具。模型识别应使用哪个工具。它正确传递参数。您可以在代码中解析结果。

将 tool_choice 设置为 auto 或特定值。这让你可以控制行为。该模型在需要时会优先使用工具。这增强了复杂工作流中的可靠性。

使用这些功能进行数据提取。自动化表单或 API 调用。uncensored 模型很好地处理边缘情况。它不会拒绝复杂的查询。这使其适合生产任务。

常见错误：404 和 422 详解

错误通常表示配置问题。404 Not Found 错误很常见。这意味着端点错误。请仔细检查您的基础 URL。确保路径中包含 /v1。

422 不可处理实体错误发生。这通常由无效的 JSON 引起。请检查请求体结构。确保所有必填字段均已包含。验证模型 ID 是否正确。

速率限制返回 429 错误。您超过了每分钟 300 次请求。稍作等待后再重试。在代码中实现指数退避。这可以防止使 API 过载。

检查您的 API 密钥有效性。确保它未过期。如果重新生成，密钥会自动替换。为每个请求使用正确的密钥。这可以最大限度地减少停机时间。

成本对比：Mistral 与我们的 Uncensored API

我们的定价简单明了。您每百万个输入令牌支付 $0.15。输出令牌每百万个成本为 $0.50。这是透明且可预测的。

标准 API 通常收费更高。它们包含平台费用。我们的模型在我们的服务器上运行。您直接为计算付费。这降低了基础成本。

错误免费。您不为失败的请求付费。这在调试时节省费用。您只为有效的输出付费。

充值从 20 美元开始。您使用加密货币支付。提供额外赠送的信用额度。充值 50 美元可获得 5% 的额外奖励。充值 100 美元可获得 10% 的额外奖励。充值 200 美元可获得 15% 的额外奖励。这奖励了更高的使用量。

顺利迁移最终检查清单

验证 base URL 是否正确。更新环境中的 API 密钥。使用简单提示进行测试。如果需要，确保流式传输正常工作。

检查您的速率限制处理。为 429 错误实现重试。监控您的 token 使用情况。根据需要调整 max_tokens。

启用 JSON 模式以进行结构化数据。使用您的工具测试函数调用。确保模型正确响应。验证输出格式是否符合您的预期。

调整您的参数。设置 temperature 以控制创造性。使用 top_p 增加多样性。这些设置影响输出质量。通过实验找到最佳平衡点。除 URL 和密钥外，您的代码应保持不变。