DeepSeek API 生产指南

为什么无审查对生产环境很重要

生产环境通常需要不会根据主观内容策略拒绝有效请求的模型。标准模型可能会因广泛的安全过滤器而拒绝复杂的角色扮演、利基技术查询或争议性话题。无限制 LLM 基于概率处理这些输入，确保在各种用例下输出一致。

这种方法对于期望模型遵循特定角色指令或生成不受限制创意内容的应用至关重要。它消除了聊天机器人或内容生成工具中因突然拒绝而打断用户流程的不可预测性。

然而，如果需要，您必须实施自己的审核，因为模型不会为您过滤内容。这使您可以完全控制特定上下文（无论是私人聊天还是面向公众的应用程序）中什么是可接受的。

理解令牌成本和限制

Token 计费将输入和输出成本分开，这意味着您为发送的内容与模型生成的内容支付不同的费用。输入 token 通常比输出 token 便宜，因此优化提示结构可以降低整体费用。了解这种拆分有助于您为高容量应用准确预算。

Token 类型	每 1M Token 的成本	备注
输入	$0.15	为请求中发送的每个 token 收费
输出	$0.50	为响应中生成的每个 token 收费

错误和拒绝不消耗信用额，这保护您无需为失败的请求付费。此定价模式透明，无隐藏费用或订阅层级，允许您根据实际消耗扩展使用情况。

优化上下文窗口

100,000 token 的上下文窗口允许您在单个请求中包含大量历史记录、文档或系统指令。这种容量支持需要长期记忆或详细上下文而无需频繁调用 API 的复杂应用。然而，较大的上下文会增加延迟和 token 成本，因此您必须在细节与效率之间取得平衡。

为了优化，请在提示中优先考虑最近和关键的信息。使用截断策略移除较早、相关性较低的消息，同时保留核心上下文。这确保模型接收最重要的数据，同时不超过每次请求 16,000 个 token 的输出限制。

密切监控令牌用量以避免意外费用。如果您的应用需要超过 100,000 的上下文，请考虑将数据拆分为多个请求，或使用检索增强生成 (RAG) 方法动态获取相关信息。

处理流式响应

流式响应允许您向用户发送部分结果，从而改善感知性能。这是通过使用服务器发送事件（SSE）实现的，SSE 会在模型生成数据时以数据块形式交付数据。这为用户等待长响应时创造了更流畅的体验。

通过在 API 请求中设置适当的标头来实现流式传输。流中的最后一个数据块包含总令牌使用情况，您可以将其记录用于计费和数据分析。这种方法对于期望实时反馈的聊天界面至关重要。

通过为流连接实现重试逻辑优雅地处理网络中断。确保您的客户端代码能够处理部分 token 并增量渲染它们，而不会破坏用户体验。

函数调用和 JSON 模式

函数调用使模型能够输出可由您的应用程序以编程方式执行的结构化数据。这对于从文本中提取数据、触发操作或生成结构化响应等任务非常有用。JSON 模式确保输出符合特定架构，从而减少解析错误。

清晰地定义你的函数模式，包括参数类型和描述。模型将使用这些描述来确定何时以及如何调用函数。此功能将聊天机器人转变为能够执行特定任务的交互式代理。

在执行函数之前在您的端验证输出。虽然模型力求准确，但可能会出现意外的边缘情况。使用 JSON 模式可降低生成格式错误响应的可能性，使您的应用程序更加健壮。

错误处理和重试

API 请求可能因网络问题、速率限制或模型错误而失败。实施强大的错误处理可确保你的应用程序在不利条件下保持可靠。区分可以重试的临时错误和需要用户干预的永久错误。

使用指数退避进行重试，以避免在高负载期间压垮服务器。限制重试次数以防止无限循环。记录足够详细的错误日志以便后续诊断，包括请求 ID 和错误代码。

通过监控响应头中的配额信息来处理速率限制。如果您达到每分钟 300 次请求的限制，请暂停并在短暂延迟后重试。这确保您在保持服务连续性的同时保持在允许的限制内。

安全最佳实践

通过将 API 密钥安全地存储在环境变量或密钥管理器中来保护您的 API 密钥。避免在源代码中硬编码密钥，尤其是如果您公开发布代码的话。对所有 API 请求使用 HTTPS 以加密传输中的数据。

如可能，请限制 API 密钥的权限。定期轮换密钥以最小化潜在泄露的影响。监控使用模式，以发现可能表明未经授权访问或滥用的异常。

在将用户输入发送给模型之前进行清理，以防止注入攻击。虽然模型是 uncensored 的，但仍可能受到恶意提示的影响。实现您自己的验证逻辑，以确保输入数据符合应用程序的要求。

从其他提供商迁移

如果您使用 OpenAI 兼容的 API，从其他 LLM 提供商迁移非常简单。大多数 SDK 允许您更改基础 URL 和 API 密钥以指向您的新提供商。这意味着您可以在不重写整个应用程序逻辑的情况下切换模型。

迁移后请彻底测试您的应用以确保兼容性。不同模型在输出格式或行为上可能存在细微差异。如有必要，请调整提示词以应对这些差异。

利用新提供商定价的透明度来优化您的成本。将您之前提供商的 token 成本与新提供商进行比较，以确保您获得更优惠的价格。此次迁移可以带来显著的节省并提升应用性能。

上线的最终清单

在发布您的应用程序之前，请确保已解决集成的所有关键方面。回顾您的错误处理、流式传输实现和安全措施，以保证流畅的用户体验。

• 验证 API 密钥安全性和存储
• 测试错误处理和重试逻辑
• 优化上下文窗口使用效率
• 实现流式传输以获取实时反馈
• 监控 token 使用情况和成本

对应用程序在负载下的性能进行最终审查。确保错误消息清晰且对用户有帮助。通过这些步骤，你的应用程序已准备好提供可靠、高质量的结果。