DeepSeek - 完全なAPIリファレンス
- OpenAI SDK形式でDeepSeekモデルを呼び出し
- 同期処理モード、リアルタイムレスポンス
deepseek-chat(一般会話)とdeepseek-reasoner(深層推論)モデルに対応- テキストチャット:シングルまたはマルチターンのコンテキスト会話
- システムプロンプト:AIの役割と動作をカスタマイズ
- ストリーミング:SSEストリーミング出力対応
- ツール呼び出し:Function Calling対応
認証
##すべてのAPIにBearer Token認証が必要です## **APIキーの取得:** [APIキー管理ページ](https://starmagic.ai/app/api-keys)にアクセスしてAPIキーを取得してください **リクエストヘッダーに追加:** ``` Authorization: Bearer YOUR_API_KEY ```
Authorization: Bearer YOUR_API_KEYリクエストボディ
application/jsonチャットモデル名 - `deepseek-chat`:一般会話モデル - `deepseek-reasoner`:深層推論モデル、数学、コーディング、複雑な論理推論に優れる **注意**:`deepseek-reasoner`は`temperature`、`top_p`、`tools`、`tool_choice`、`response_format`パラメータに対応していません。これらを渡すとアップストリームで拒否されます
"deepseek-chat"会話メッセージリスト、マルチターン会話に対応 異なるロールには異なるフィールド構造があります、対応するロールを選択して確認してください
[
null
]思考モード制御(ベータ) **詳細**: - `deepseek-reasoner` モデルの深い思考機能を制御します - 有効にすると、モデルは応答前に深い推論を行います
{
"type": "enabled"
}繰り返しコンテンツを減らすための頻度ペナルティパラメータ **詳細**: - 正の値は生成テキスト内の頻度に基づいてトークンにペナルティを与えます - 値が高いほど既存のコンテンツを繰り返す可能性が低くなります - デフォルト:0(ペナルティなし)
0生成する最大トークン数 **詳細**: - この制限に達するとモデルは生成を停止します - 設定されていない場合、モデルが生成長を決定します
4096新しいトピックを促すプレゼンスペナルティパラメータ **詳細**: - 正の値はテキストに出現したかどうかに基づいてトークンにペナルティを与えます - 高い値は新しいトピックの議論を促します - デフォルト:0(ペナルティなし)
0レスポンスフォーマットを指定 **詳細**: - `{"type": "json_object"}` に設定すると JSON モードが有効になります - JSON モードでは、モデルは有効な JSON コンテンツを出力します
{
"type": "text"
}停止シーケンス。モデルはこれらの文字列に遭遇すると生成を停止します **詳細**: - 単一の文字列または文字列の配列が可能 - 最大16個の停止シーケンス
レスポンスをストリーミングするかどうか - `true`: SSE(Server-Sent Events)でストリーミング、リアルタイムでチャンク単位でコンテンツを返却 - `false`: 完全なレスポンスを待ってから返却
falseストリーミングレスポンスオプション `stream=true` の場合のみ有効
{
"include_usage": true
}サンプリング温度、出力のランダム性を制御 **詳細**: - 低い値(例: 0.2): より決定論的で集中した出力 - 高い値(例: 1.5): よりランダムで創造的な出力 - デフォルト: 1
1Nucleus Samplingパラメータ **詳細**: - 累積確率が閾値に達するトークンからのサンプリングを制御 - 例えば、0.9は累積確率が90%に達するトークンからサンプリングすることを意味します - デフォルト: 1.0(すべてのトークンを考慮) **ヒント**: temperatureとtop_pの両方を同時に調整しないでください
1Function Calling 用のツール定義リスト **詳細**: - 最大128個のツール定義 - 各ツールには名前、説明、パラメータスキーマが必要です
[
{
"type": "function",
"function": {
"name": "string",
"description": "string",
"parameters": {},
"strict": false
}
}
]ツール呼び出しの動作を制御 **オプション**: - `none`:ツールを呼び出さない - `auto`:モデルがツールを呼び出すかどうかを判断 - `required`:モデルに1つ以上のツールの呼び出しを強制 **デフォルト**:ツール未提供時は`none`、ツール提供時は`auto`
トークンのログ確率を返すかどうか **詳細**: - `true` に設定すると、レスポンスに各トークンのログ確率情報が含まれます
false最も可能性の高い上位Nトークンのログ確率を返す **詳細**: - `logprobs`を`true`に設定する必要があります - 範囲: `[0, 20]`
0レスポンス
application/jsonレスポンスボディ
チャット補完の一意の識別子
"930c60df-bf64-41c9-a88e-3ec75f81e00e"使用された実際のモデル名
"deepseek-chat"レスポンスタイプ
"chat.completion"作成タイムスタンプ
1770617860チャット補完選択肢のリスト
[
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! I'm DeepSeek, a powerful AI assistant. I excel at general conversation, code generation, mathematical reasoning and many other tasks.",
"reasoning_content": "Let me analyze this problem...",
"tool_calls": [
{
"id": null,
"type": null,
"function": null
}
]
},
"finish_reason": "stop"
}
]トークン使用統計
{
"prompt_tokens": 16,
"completion_tokens": 10,
"total_tokens": 26,
"prompt_cache_hit_tokens": 0,
"prompt_cache_miss_tokens": 16
}システムフィンガープリント識別子
"fp_eaab8d114b_prod0820_fp8_kvcache"
