# DeepSeek v4 API DeepSeek を基盤とする DeepSeek v4 LLM モデルの完全な API リファレンス。 ## モデルのアップデート ### DeepSeek v4 Pro 0813 - Flaq AI は DeepSeek v4 Pro を DeepSeek 公式の `deepseek-v4-pro-0813` リリースに更新しました。 - 公式版にアクセスするには、以下の `0813` モデル ID を使用してください。 - 元の Pro モデル ID は利用できません。 | バリエーション | 0813 モデル ID | 利用できないモデル ID | |---------|---------------|----------------------| | テキストからテキスト | `deepseek-v4-pro-text-to-text-0813` | `deepseek-v4-pro-text-to-text` | | Web 検索 | `deepseek-v4-pro-web-search-0813` | `deepseek-v4-pro-web-search` | ### DeepSeek v4 Flash 0731 - Flaq AI は DeepSeek v4 Flash を DeepSeek 公式の `deepseek-v4-flash-0731` リリースに更新しました。 - 更新版にアクセスするには、以下の `0731` モデル ID を使用してください。 - 元の Flash モデル ID は利用できません。 | バリエーション | 0731 モデル ID | 利用できないモデル ID | |---------|---------------|----------------------| | テキストからテキスト | `deepseek-v4-flash-text-to-text-0731` | `deepseek-v4-flash-text-to-text` | | Web 検索 | `deepseek-v4-flash-web-search-0731` | `deepseek-v4-flash-web-search` | ## モデルバリエーション この API は 4 つの DeepSeek v4 モデルバリエーションをサポートします: | モデル | ID | 説明 | |-------|----|-------------| | **DeepSeek v4 Pro Text to Text** | `deepseek-v4-pro-text-to-text-0813` | 高品質なテキスト推論とライティング | | **DeepSeek v4 Flash Text to Text** | `deepseek-v4-flash-text-to-text-0731` | より高速で低コストなテキスト生成 | | **DeepSeek v4 Pro Web Search** | `deepseek-v4-pro-web-search-0813` | DeepSeek v4 Pro の推論による Web 対応の回答 | | **DeepSeek v4 Flash Web Search** | `deepseek-v4-flash-web-search-0731` | DeepSeek v4 Flash によるより高速な Web 対応の回答 | ## クイック比較 | 機能 | Pro Text to Text | Flash Text to Text | Pro Web Search | Flash Web Search | |---------|------------------|------------|----------------|------------------| | テキスト入力 | 必須 ✅ | 必須 ✅ | 必須 ✅ | 必須 ✅ | | 画像入力 | 未対応 ❌ | 未対応 ❌ | 未対応 ❌ | 未対応 ❌ | | ファイル入力 | 未対応 ❌ | 未対応 ❌ | 未対応 ❌ | 未対応 ❌ | | Web 検索 | 未対応 ❌ | 未対応 ❌ | 有効 ✅ | 有効 ✅ | | ストリーミングレスポンス | SSE | SSE | SSE | SSE | | `max_tokens` | 任意 | 任意 | 任意 | 任意 | | `top_p` | 任意 | 任意 | 任意 | 任意 | | `top_k` | 任意 | 任意 | 任意 | 任意 | ## DeepSeek v4 Pro Text to Text ### エンドポイント ```http POST /api/v1/chat/completions ``` ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | |-----------|------|-------------| | `model` | string | `"deepseek-v4-pro-text-to-text-0813"` である必要があります | | `messages` | array | 順序付きのテキスト専用メッセージ。`system`、`user`、`assistant` ロールをサポートします。メッセージ構造は LLM API を参照してください。 | | `stream` | boolean | SSE の場合は `true`、単一の JSON レスポンスの場合は `false`。 | #### メッセージ対応 | フィールド | テキスト | ファイル | 画像 | |-------|------|------|-------| | `messages` | 必須 ✅ | 未対応 ❌ | 未対応 ❌ | #### 任意 | パラメータ | 型 | 範囲 | 説明 | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | 最大出力トークン数。 | | `top_p` | number | `0.0` - `1.0` | 候補トークンの累積確率質量を制限します。 | | `top_k` | integer | `0` - `100` | 候補トークン数を制限します。 | ### リクエスト例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-pro-text-to-text-0813', messages: [ { role: 'user', content: 'Hello' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Flash Text to Text ### エンドポイント ```http POST /api/v1/chat/completions ``` ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | |-----------|------|-------------| | `model` | string | `"deepseek-v4-flash-text-to-text-0731"` である必要があります | | `messages` | array | 順序付きのテキスト専用メッセージ。`system`、`user`、`assistant` ロールをサポートします。メッセージ構造は LLM API を参照してください。 | | `stream` | boolean | SSE の場合は `true`、単一の JSON レスポンスの場合は `false`。 | #### メッセージ対応 | フィールド | テキスト | ファイル | 画像 | |-------|------|------|-------| | `messages` | 必須 ✅ | 未対応 ❌ | 未対応 ❌ | #### 任意 | パラメータ | 型 | 範囲 | 説明 | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | 最大出力トークン数。 | | `top_p` | number | `0.0` - `1.0` | 候補トークンの累積確率質量を制限します。 | | `top_k` | integer | `0` - `100` | 候補トークン数を制限します。 | ### リクエスト例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'application/json', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-flash-text-to-text-0731', messages: [ { role: 'user', content: 'Write a four-line modern poem about a programmer drinking coffee.' } ], stream: false, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Pro Web Search ### エンドポイント ```http POST /api/v1/chat/completions ``` ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | |-----------|------|-------------| | `model` | string | `"deepseek-v4-pro-web-search-0813"` である必要があります | | `messages` | array | 順序付きのテキスト専用メッセージ。`system`、`user`、`assistant` ロールをサポートします。メッセージ構造は LLM API を参照してください。 | | `stream` | boolean | SSE の場合は `true`、単一の JSON レスポンスの場合は `false`。 | #### メッセージ対応 | フィールド | テキスト | ファイル | 画像 | |-------|------|------|-------| | `messages` | 必須 ✅ | 未対応 ❌ | 未対応 ❌ | #### 任意 | パラメータ | 型 | 範囲 | 説明 | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | 最大出力トークン数。 | | `top_p` | number | `0.0` - `1.0` | 候補トークンの累積確率質量を制限します。 | | `top_k` | integer | `0` - `100` | 候補トークン数を制限します。 | ### リクエスト例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-pro-web-search-0813', messages: [ { role: 'user', content: 'What date is it today?' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Flash Web Search ### エンドポイント ```http POST /api/v1/chat/completions ``` ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | |-----------|------|-------------| | `model` | string | `"deepseek-v4-flash-web-search-0731"` である必要があります | | `messages` | array | 順序付きのテキスト専用メッセージ。`system`、`user`、`assistant` ロールをサポートします。メッセージ構造は LLM API を参照してください。 | | `stream` | boolean | SSE の場合は `true`、単一の JSON レスポンスの場合は `false`。 | #### メッセージ対応 | フィールド | テキスト | ファイル | 画像 | |-------|------|------|-------| | `messages` | 必須 ✅ | 未対応 ❌ | 未対応 ❌ | #### 任意 | パラメータ | 型 | 範囲 | 説明 | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | 最大出力トークン数。 | | `top_p` | number | `0.0` - `1.0` | 候補トークンの累積確率質量を制限します。 | | `top_k` | integer | `0` - `100` | 候補トークン数を制限します。 | ### リクエスト例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-flash-web-search-0731', messages: [ { role: 'user', content: 'What date is it today?' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## レスポンス形式 DeepSeek V4 LLM モデルは OpenAI 互換の補完レスポンスを返します。`stream: true` の場合、レスポンスは Server-Sent Events(SSE)となり、`stream: false` の場合は単一の JSON オブジェクトとなります。 ### エラーレスポンス ```json { "error": { "code": "1001", "param": null, "message": "Authorization is empty", "type": "invalid_request_error" } } ``` ## ベストプラクティス 1. **適切なバリエーションを選ぶ:** より高品質な推論には Pro モデルを、低レイテンシかつ低コストのワークロードには Flash モデルを使用します。 2. **最新情報には Web Search を使う:** 回答が最新のオンライン情報に依存する場合は、Pro または Flash Web Search を選択します。 3. **サンプリングパラメータを慎重に調整する:** `top_p` と `top_k` はすべての DeepSeek v4 バリエーションでサポートされ、出力の多様性を変えられます。 4. **サポートされる入力だけを送信する:** どの DeepSeek v4 ルートにもファイルまたは画像パートを送信しないでください。 5. **Accept を stream モードに合わせる:** ストリーミングリクエストには `Accept: text/event-stream`、非ストリーミングリクエストには `Accept: application/json` を使用します。