DeepSeek practical guide
DeepSeek日本語ガイド:使い方・料金・API・安全確認
DeepSeekの使い方から、APIの料金、モデルの選び方、他のAIとの比較、安全に使うための確認までを、公式の資料で確かめた日付つきでまとめています。迷ったら、下の「目的から探す」から入ってください。
いま確認できている公式情報(2026年11月11日)
| 項目 | 内容 |
|---|---|
| 現行の主力モデル | DeepSeek-V4.1-Flash-1017(2026年10月17日に更新)。API名は deepseek-flash |
| API料金の例 | deepseek-flash:入力(キャッシュなし)100万トークン$0.15・出力$0.60(通常時間)。ピーク時間は2倍 |
| ピーク時間(日本時間) | 平日の10:00〜13:00と15:00〜19:00 |
| コンテキスト長 | 1M(約100万トークン) |
目的から探す
API・開発者向けの詳しいガイド
公式のAPI Docsの個別のページを、手順と上限の数字つきで日本語に整理したものです。
初めての方は、この順番で
- DeepSeekとはで、できること・現行モデル・3つの入口を知る。
- 安全に使うための注意点で、入れてはいけない情報を決める。
- 使い方の5つの要素で、最初の質問を書いて試す。
- 用途に合うページ(文章・要約・コード・調べもの)に進む。APIで使うならAPIの始め方へ。
最近の更新
- APIの個別機能(JSON出力・ツール呼び出し・キャッシュ・画像入力・Search/Fetch・補完・更新履歴)を、公式ドキュメントで確認して8ページ追加しました。
- サイト全体を見直しました。似た内容の約100ページを主要なページにまとめ、料金・モデル・API・エラー・開発ツール・計算ツールのページを公式資料で確認して新しく作りました。
- アダルトモードの有無のページを、DeepSeek利用規約の原文で確認して更新しました。
公式の更新の年表とニュースは更新情報にあります。
このガイドの確認のしかた
機能・料金・規約は、DeepSeekの公式ドキュメント(API Docs)、利用規約、プライバシーポリシーで確かめ、確認した日付を各ページに書いています。公式に書かれていないことは、確定した情報として扱いません。詳しくはdeepseek.tokyoについてをご覧ください。
よくある質問
このサイトはDeepSeekの公式サイトですか?
いいえ。DeepSeekの公式サイトではなく、日本語で使い方や料金、注意点を整理するガイドです。公式の情報はDeepSeek API Docsで確認できます。
情報はいつ確認したものですか?
各ページの上に確認した日付を書いています。2026年11月11日に公式資料で確認した内容が中心です。
APIを始めるときの接続設定
DeepSeek APIは、OpenAI形式とAnthropic形式に対応しています。公式ガイドでは、対応するSDKやソフトウェアの設定を変更して接続する方法を案内しています。
OpenAI形式の接続先は https://api.deepseek.com、Anthropic形式は https://api.deepseek.com/anthropic です。
利用にはAPIキーが必要です。公式ガイドのAPIキーへのリンクから取得し、例に沿って環境変数 DEEPSEEK_API_KEY に設定します。
モデル名の例は deepseek-flash と deepseek-v4-pro です。公式例では、モデル名とメッセージを指定してチャットAPIを呼び出します。
応答を順に受け取る場合は stream を true に設定します。公式ページには、curl・Python・Node.jsの呼び出し例が掲載されています。
出典:DeepSeek『Your First API Call』(2026年11月14日確認)
会話を続けるときの履歴の渡し方
公式ガイドでは、/chat/completions をステートレスなAPIと説明しています。このAPIでは、サーバーが前の要求の文脈を記録して会話を引き継ぐ方式ではありません。
そのため、通常の複数回の会話では、これまでのやり取りをつなげ、要求のたびにチャットAPIへ渡します。次の質問だけを送る例とは、メッセージの構成が異なります。
公式の例では、最初に利用者の質問を送信し、返ってきたモデルの回答を messages の末尾に追加します。続いて新しい質問を追加し、再びAPIを呼び出します。
2回目に送る履歴の順番は、最初の質問、モデルの回答、次の質問です。利用者の発言は user、モデルの回答は assistant として扱う例が示されています。
ウェブツールやモデルのコンテンツ安全機能を使う要求では、履歴の渡し方が異なると案内されています。該当する場合は、公式のウェブツールの会話ガイドも参照します。
→ くわしく出典:DeepSeek『Multi-round Conversation』(2026年11月14日確認)
JSON形式で回答を受け取るための設定
DeepSeekのJSON Outputは、回答をJSON文字列として受け取るための機能です。公式ガイドでは、形式の指定、指示文の書き方、回答の長さに関する設定を案内しています。
有効にするには、response_format の type を json_object に設定します。システムまたは利用者の指示文には、json という語を含めます。
また、期待するJSON形式の例を指示文に示すことが案内されています。公式のサンプルは、質問と回答をそれぞれの項目に分けて出力する構成です。
max_tokens は、JSON文字列が途中で切れないように設定します。公式例では、返された文字列をPythonの json.loads で解析しています。
回答がJSONとして認識できない場合、APIはその内容を空白に置き換えると説明されています。空白だけの応答を扱う処理や、指示文の変更についても案内があります。
→ くわしく出典:DeepSeek『JSON Output』(2026年11月14日確認)
キャッシュの利用状況を読み取る
コンテキストキャッシュは、公式資料によると全利用者で初期状態から有効です。過去の要求と重なる先頭部分について、保存済みのキャッシュを再利用する仕組みです。
再利用には、保存された先頭部分の単位と完全に一致する必要があります。要求の区切り、複数の要求に共通する先頭部分、長い文章の一定間隔などで保存されます。
利用状況は応答の usage で調べられます。prompt_cache_hit_tokens はキャッシュに一致したトークン数を表します。
一方、prompt_cache_miss_tokens は一致しなかったトークン数です。キャッシュは先頭部分を再利用するもので、回答そのものは計算によって生成されます。
出典:DeepSeek『Context Caching』(2026年11月14日確認)
APIエラーはコードごとに原因を分ける
公式のエラー一覧では、401はAPIキーによる認証の失敗、402は残高不足と説明されています。401ではキーを、402ではアカウントの残高を調べる対応が案内されています。
400は要求本文の形式、422はパラメータの問題です。どちらも、返されたエラーメッセージの説明に沿って要求を修正するよう案内されています。
429は要求の送信が速すぎる場合や、同時実行数・毎秒の要求数の上限を超えた場合です。公式資料では、送信のペースを調整し、制限の説明を参照する対応を示しています。
500はサーバー側の問題、503はアクセス集中による過負荷です。いずれも少し待ってから再試行する案内があり、500が続く場合は問い合わせるよう説明されています。
→ くわしく出典:DeepSeek『Error Codes』(2026年11月14日確認)
文字数とトークン数の違いを確認する
2026年11月15日に確認した公式資料では、トークンはモデルが自然言語の文章を扱うための基本単位で、APIの課金にも使われると説明されています。文字や単語に相当する単位ですが、文字数と同じ値になるとは限りません。
公式資料にある換算の目安は、英語の1文字が約0.3トークン、中国語の1文字が約0.6トークンです。ただし、モデルごとに文章の区切り方が異なるため、換算比率も変わるとされています。
実際に処理されたトークン数は、モデルが返す利用量の情報で確認します。公式ページでは、手元でトークン数を計算するためのトークナイザーのサンプルも配布されています。文字数による目安と、APIから返る利用量は分けて確認できます。
出典:DeepSeek『Token & Token Usage』(2026年11月15日確認)
ツール呼び出しでアプリが担当する処理
2026年11月15日に確認した公式ガイドでは、ツール呼び出しを使うと、モデルが外部のツールを呼び出せると説明しています。天気を尋ねる例では、呼び出す関数の名前、説明、受け取るパラメータを定義してAPIに渡しています。
モデルが返すのは、関数の名前や引数を含む呼び出し情報です。公式ガイドでは、モデル自身が個々の関数を実行するわけではなく、関数の処理は利用者側で用意する必要があると明記しています。
公式例の流れは、質問を送る、モデルから関数の呼び出しを受け取る、利用者側で関数を実行する、その結果をモデルに返す、という順番です。その後、モデルが自然な文章の回答を返します。コード例では、ツールの結果に対応する呼び出しIDを添え、会話のメッセージに追加して再びAPIを呼び出しています。
出典:DeepSeek『Tool Calls』(2026年11月15日確認)