DeepSeek APIの運用チェックリスト

エンドポイントの構成とベースURL

最初のステップは、クライアントを正しいベースURLに向けることです。標準のOpenAI互換構造を使用するため、既存のSDKは大幅なリファクタリングなしで動作します。設定 base_url に https://api.deepseekunrestricted.com/v1 認証ヘッダーにAPIキーを設定します。この設定により、 /v1/chat/completions 文書化されたとおりに動作します。ルーティングロジックを書き直す必要はありません。

• ベースURL： https://api.deepseekunrestricted.com/v1
• Authヘッダー: Authorization: Bearer YOUR_API_KEY
• モデルID: uncensored

この設定により、後で拡張する際に異なるモデル間を切り替えることができますが、現時点では単一のuncensoredモデルに限定してください。エンドポイントはテキスト入力・テキスト出力の操作向けに設計されています。temperatureやtop_pなどの標準パラメータをサポートします。複数の場所にURLをハードコードしないよう、設定を一元化してください。これにより、APIバージョン更新時のメンテナンスオーバーヘッドを削減できます。

トークン計算とコスト見積もり

コスト見積もりは、入力トークンと出力トークンを別々に追跡することで行います。価格体系はシンプルです：入力トークンは1Mあたり$0.15、出力トークンは1Mあたり$0.50です。エラーや拒否はクレジットを消費しないため、正常に処理された分のみにお支払いいただきます。この前払いモデルにより、予算を厳密に管理できます。より大きな金額のチャージにはボーナス付きで暗号通貨でもチャージ可能です。

• 入力コスト：1Mトークンあたり$0.15
• 出力コスト：1Mトークンあたり$0.50
• 返金：なし、クレジットは期限切れしない

常に usage レスポンス内のフィールド。支出を正確に追跡するために使用します。大きなバッチを送信する前にコストを見積もるためにローカルカウンターを実装してください。これにより、プリペイド残高の予期せぬ枯渇を防ぐことができます。クレジットは期限切れにならないため、価格が有利なときにチャージできることを覚えておいてください。ボーナスティアを使用して、購入力を最大化してください。$100のチャージで10%の追加クレジットが得られ、実質的なトークン単価が引き下げられます。

ストリーミングレスポンスの効率的な処理

ストリーミングレスポンスはコンテンツを増分的に配信することでユーザーエクスペリエンスを改善します。リアルタイムのトークン配信のためにServer-Sent Events (SSE)をサポートしています。各チャンクには部分的なテキストとメタデータが含まれます。これらのチャンクを解析してUIを滑らかに更新してください。最終チャンクにはリクエストの総トークン使用量が含まれます。

• streamをtrueに設定してストリーミングを有効にする stream: true
• 部分的な更新のためにSSE形式を解析します
• 最後のチャンクから使用データを抽出します

ネットワークの中断を適切に処理してください。必要に応じて失敗したチャンクを再試行してください。パーサーはデータ以外のイベントを無視してください。このアプローチにより、長い出力の知覚レイテンシが削減されます。また、モデルがテキストを生成する進行状況をユーザーに表示することも可能です。レンダリング前にトークンを集約するバッファを実装してください。これにより、動的なインターフェースでのちらつきを防ぎます。最後のチャンク受信後は、リソースを解放するためにストリーム接続を必ず閉じてください。

レート制限と並列処理の管理

レート制限は、すべてのユーザーに対して安定したパフォーマンスを確保するために適用されます。各APIキーは1分あたり300リクエストまで、同時に最大8つのリクエストまでが許可されます。これらの制限を超えると、429エラーが発生します。指数バックオフを実装して、リトライを効果的に処理してください。

• 制限: キーごとに1分あたり300リクエスト
• 並列リクエスト: 同時に最大 8 リクエスト
• 本文のサイズ: 最大8 MB

並列数の上限に達しないようにリクエストキューを監視してください。セマフォまたはスレッドプールを使用して並列リクエストを管理してください。レート制限エラーをログに記録してパターンを特定してください。より高いスループットが必要な場合は、追加のキーの生成を検討してくださいが、各アカウントには有効なキーが1つだけ制限されています。負荷を分散させるためにキーを戦略的にローテーションしてください。これにより、重要なタスクがバックグラウンドジョブによってブロックされないことを保証します。

エラー処理とリトライロジック

堅牢なエラー処理により、API呼び出し中にアプリケーションがクラッシュするのを防ぎます。成功または失敗を示すために標準のHTTPステータスコードを返します。4xxエラーは通常、無効なキーや不正なリクエストなど、クライアント側の問題を意味します。5xxエラーは、自己解決する可能性があるサーバー側の問題を示します。

• 4xx：クライアントエラー（リクエストを確認）
• 5xx: サーバーエラー（バックオフでリトライ）
• 429：レートリミット超過（待機して再試行）

一時的なエラーに対して指数関数的バックオフ付きのリトライメカニズムを実装します。4xxエラーはレート制限に関連する場合を除き再試行しないでください。デバッグのためにエラー詳細をログに記録してください。サポートチームを支援するためにリクエストIDをログに含めてください。これにより、問題の迅速な診断に役立ちます。ネットワークタイムアウトはHTTPエラーとは別に処理してください。トークンが処理されていない場合、失敗したリクエストはトークン残高を消費すべきではありません。

構造化データ出力のためのJSONモード

JSONモードにより、モデルは構造化されたデータを期待する他のシステムとの統合にとって重要な有効なJSON構造を出力します。設定 response_format パラメータを {"type": "json_object"}これはモデルにJSON構文則の遵守を強制します。

• 設定 response_format に json_object
• JSONパーサーで出力を検証します
• スキーマ違反を適切に処理します

JSONモードは整合性を向上させますが、スキーマ準拠を保証するものではありません。常に出力を期待されるスキーマに対して検証してください。出力が無効な場合は、より厳格なプロンプトでリクエストを再試行してください。これにより、後処理の必要性が減少します。データ抽出や設定生成などのタスクにこの機能を使用してください。これにより、ダウンストリームシステムが予測可能な入力を確実に受け取ります。エッジケースを処理するためにJSON解析ロジックを十分にテストしてください。

関数呼び出しとツールの使用

関数呼び出しによりモデルはユーザー入力に基づいて特定のアクションを実行できます。 tools パラメータ。モデルはプレーンテキストの代わりに関数呼び出しオブジェクトを返します。アプリケーションは関数を実行し、その結果をモデルに返します。

• 関数を tools 配列
• 関数呼び出しのレスポンスを解析します
• 会話を続けるために結果を返す

データベースクエリやウェブ検索などの複雑なワークフローを可能にします。関数の定義を明確かつ詳細に記述してください。モデルはこれらの定義に基づいて適切なツールを選択します。モデルが未定義の関数を呼び出した場合の処理を行ってください。これにより、実行ロジックでのエラーを防げます。関数呼び出しを使用してLLMの機能を拡張します。これは言語生成とアクション実行のギャップを埋めます。

コンテキストウィンドウの管理

コンテキストウィンドウは、モデルが一度に処理できるテキストの量を決定します。当APIは100,000トークンのコンテキストウィンドウをサポートしています。これにはプロンプトと補完の両方が含まれます。リクエストごとに最大16,000トークンの出力制限に注意してください。これを超えると、モデルは応答を切り捨てます。

• コンテキストウィンドウ：100,000トークン
• 最大出力：16,000トークン
• デフォルトの最大出力: 2,048トークン

長いドキュメントにはスライディングウィンドウまたは要約戦略を実装します。これにより、コンテキストを制限内に保ちつつ、重要な情報を保持します。プロンプト内のトークン数を監視してオーバーフローを防いでください。切り捨ては不完全なレスポンスにつながる可能性があります。使用 max_tokens 出力の長さを制御するパラメータ。これによりコストとレスポンス時間を管理できます。モデルの推論に十分な余地を確保するため、トークン予算を慎重に計画してください。

セキュリティとキーローテーション

APIを生産システムに公開する際にはセキュリティが最も重要です。環境変数を使用してAPIキーを保存してください。ソースコードにハードコードしないでください。定期的にキーをローテーションして、露出リスクを最小限に抑えてください。ダッシュボードを通じてキーのローテーションをサポートしています。

• 環境変数にキーを保存
• 定期的にキーを回転させる
• 異常な利用状況を監視する。

APIの利用状況を追跡し、異常なアクティビティを検知するためにロギングを実装します。大量のリクエストに対してアラートを設定してください。これにより、不正利用や攻撃の可能性を特定できます。セキュリティパッチの恩恵を受けるために、SDKのバージョンを最新に保ってください。すべてのAPI通信にはHTTPSを使用してください。これにより、転送中のデータが暗号化され、保護されます。API利用状況の定期的な監査は、セキュリティの健全性を維持するのに役立ちます。