DeepSeek APIとは何か、チャットUIと何が違う？
APIでできることと、向いている用途
室谷代表取締役DeepSeek のAPI、まず押さえておきたいのは「チャット画面の裏側をそのまま使う」イメージだということなんですよね。人がブラウザで話す代わりに、プログラムから投げて答えを受け取る。
だから画面はありません。
だから画面はありません。
テキトー教師DotAI 認定講師そこ、最初に詰まりやすいところで。「チャットで使ってるのにAPIキーって何？」となるんですよ。
同じモデルでも入口が別で、向いてる用途も変わってきます。
同じモデルでも入口が別で、向いてる用途も変わってきます。
室谷代表取締役向いてるのは、決まった処理を大量に回すとか、自社のツールに組み込むとか。手で1件ずつ聞くより、夜間にまとめて流したほうが圧倒的に速いんですよね。
テキトー教師DotAI 認定講師逆に、たまに長文を1本書いてもらうくらいならチャット画面で十分です。毎回の作業を仕組みにしたい人がAPIに来る、という切り分けでいいと思います。
チャットUIとAPIは残高が別管理、課金の仕組みも別
室谷代表取締役で、ここが一番の落とし穴なんですけど、チャット画面とAPIは残高が完全に別なんですよ。
テキトー教師DotAI 認定講師そうなんです。チャットは無料で使えて、APIは従量課金。
同じ会社のサービスなのに、財布が別々になっているんですよね。
同じ会社のサービスなのに、財布が別々になっているんですよね。
室谷代表取締役APIを使うにはプラットフォーム側で「Top up」から残高をチャージする必要がある。課金はチャージ済みの残高か、付与された残高から引かれて、両方あるときは付与分が先に消える順番なんです。
テキトー教師DotAI 認定講師この「チャットとAPIは別物」という構図、ChatGPTでも同じなので、そっちで一度整理しておくと飲み込みが早いですよ。詳しくはChatGPT PlusとAPIの違いとは？料金・キー取得・使い分けを徹底解説で解説しています。
送信データは中国のサーバーで処理される点の注意
テキトー教師DotAI 認定講師あと、これは技術の話とは別に必ず触れておきたいところで。DeepSeek は中国企業が運営していて、送ったデータは中国のサーバーで処理される、と国内の有識者が繰り返し指摘しているんですよ。
室谷代表取締役コスト管理の立場だと、安さだけで即導入とは言えない部分ですね。業務データや個人情報を流すなら、社内のセキュリティ基準に照らして可否を判断する必要がある。
テキトー教師DotAI 認定講師個人が試すぶんには気軽でいいんですが、会社のデータを扱うなら法務や情シスを挟む前提で考えたほうが安全です。実際に使っている人からも、そこを先に確認したという声が出ています。
室谷代表取締役判断材料が欲しいなら、公式のプライバシーポリシーを読むところからですかね。規約の細かい話はここで断定せず、原文を見てもらうのが確実です。
DeepSeek APIキーの取得手順と、最初にかかるお金
platform.deepseek.comに登録して、API Keysから発行する
DeepSeek APIキーの取得手順
- 01platform.deepseek.com にアクセスチャット用の chat.deepseek.com とは別サイト
- 02メールアドレスなどで登録してログインログインも残高もチャット側とは別管理
- 03左メニューの「API Keys」を開く
- 04「Create new secret key」からキーを発行キー自体はものの数分で出る
- 05発行直後に表示される文字列をコピーキーは一度しか表示されない
- 06パスワード管理ツールなど安全な場所に控える
- 07コードからは環境変数経由で読み込むファイルに直書きしない
platform.deepseek.comにアクセスする- メールアドレスなどで登録してログインする
- 左メニューの「API Keys」を開く
- 「Create new secret key」からキーを発行する
室谷代表取締役キー自体はものの数分で出ます。ただ、チャットを触ってた人がそのままの感覚で来ると「え、別サイト？」ってなるんですよね。
テキトー教師DotAI 認定講師そこなんですよ。chat.deepseek.com と platform.deepseek.com はログインも残高も別で、チャット側が無料で使えても、API側は従量課金という前提になります。
室谷代表取締役コスト管理の立場だと、そこは最初に線を引いておきたいところです。同じ会社のサービスでも、財布が2つあるイメージで見ておくほうが安全です。
発行したキーは一度しか表示されない——控え方と環境変数
- 発行直後に表示される文字列をコピーする
- パスワード管理ツールなど安全な場所に控える
- コードからは環境変数経由で読み込む（ファイルに直書きしない）
テキトー教師DotAI 認定講師ここ、初めて触る人が一番やりがちなんですけど、画面を閉じた後にキーを探しても、もう二度と表示されないんですよ。発行のその瞬間しかチャンスがありません。
室谷代表取締役で、控えたキーをそのままソースに貼っちゃうパターンも多い。リポジトリに上がった時点で終わりなので、環境変数に逃がすのが基本ですね。
テキトー教師DotAI 認定講師Top upでのチャージと、付与残高が先に消えるルール
室谷代表取締役APIを使うには「Top up」から残高をチャージする必要があるんですよ。ここ、クレジットカードを登録したら終わり、みたいな感覚で来ると詰まります。
テキトー教師DotAI 認定講師引き当ての順番も決まっていて、チャージした分と付与された分の両方があるときは、付与された残高から先に消費されるんですよ。公式のDeduction Rulesにそう書かれています。
室谷代表取締役付与分が先に消えるということは、自分で入れた分は後ろに残るわけです。内訳を分けて見ないと「あれ、減ってないな」って混乱するので、そこは覚えておきたいところですね。
最初にいくら入れるか、無料で試せる範囲
テキトー教師DotAI 認定講師「最初にいくら入れればいいですか」というのは本当によく出る話で、いきなり大きく入れる必要はないんですよ。小さく始めて、どのくらい減るかを見るのが安全です。
室谷代表取締役最小限で始めて、実際の消費量を見てから足す。この順番が一番失敗しないんですよね。
相場を先に決めるより、実測を先に取るほうが精度が高いです。
相場を先に決めるより、実測を先に取るほうが精度が高いです。
テキトー教師DotAI 認定講師無料で試せるかどうかは、アカウントに付与残高があるかどうか次第なんですよ。付与分があればそこから先に消費されるので、まずはその有無を確認するのが早いです。
室谷代表取締役ひとつ注意で、DeepSeekはトップページとクイックスタートの料金ページで数字が一致していないんですよね。いくらかかるかを判断するときは、料金ページの数字を見る前提で考えたほうがいいです。
動く最小コード——OpenAI SDKの中身を差し替えるだけ
base_urlとキーを差し替えるだけのPythonコード
室谷代表取締役キーが手に入ったら、次は実際に叩く番ですけど。ここ、拍子抜けするくらい簡単なんですよ。
OpenAI SDKをそのまま使って、clientの作り方をちょっと変えるだけなので。
OpenAI SDKをそのまま使って、clientの作り方をちょっと変えるだけなので。
テキトー教師DotAI 認定講師そうなんです。base_urlに公式のエンドポイントを渡して、キーを自分のものに差し替える。
動く最小の形はこれだけです。環境変数から読む形にしておくと事故が減ります。
ChatGPT APIとの違いから確認したい人はChatGPT APIの使い方完全ガイドもどうぞ。
動く最小の形はこれだけです。環境変数から読む形にしておくと事故が減ります。
ChatGPT APIとの違いから確認したい人はChatGPT APIの使い方完全ガイドもどうぞ。
python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_DEEPSEEK_API_KEY",
base_url="https://api.deepseek.com",
)
res = client.chat.completions.create(
model="deepseek-flash",
messages=[{"role": "user", "content": "こんにちは"}],
)
print(res.choices[0].message.content)書き換える場所はキー、base_url、それと model の3つだけ。ただ、既存コードをそのまま流用する人ほど model の行を忘れるんですよね。
curlで一度叩いてみる
テキトー教師DotAI 認定講師SDKを入れる前に、curlで一回通しておくのも手です。通信とキーのどちらで詰まっているのかを切り分けられますから。
bash
curl https://api.deepseek.com/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-d '{"model":"deepseek-flash","messages":[{"role":"user","content":"ping"}]}'順番としてはこれが正解ですね。SDK側の設定ミスとキーの誤りが同時に起きると、切り分けに時間を取られる。
パスが /chat/completions のままなので、OpenAI形式だと言うのも飲み込みやすいです。
パスが /chat/completions のままなので、OpenAI形式だと言うのも飲み込みやすいです。
旧モデル名のまま動かしているコードに注意
室谷代表取締役で、ここが今日いちばん言いたいところなんですけど。ネット上のサンプル、deepseek-chat や deepseek-reasoner のままのものが結構残ってるんですよ。
テキトー教師DotAI 認定講師実際に使っている人からも聞くのはそのあたりで、この2つは廃止予定とされた名称で、今のクイックスタートには出てこないんです。動かないか、意図しない結果になる前提で見たほうがいいです。
室谷代表取締役現行は deepseek-flash と deepseek-v4-pro の2つだけ。拾ってきたコードが動かないときは、まず model の行を疑う。
コピペで試す人ほど引っかかりやすいので、ここは最初に潰しておきたいですね。
コピペで試す人ほど引っかかりやすいので、ここは最初に潰しておきたいですね。
ストリーミングとusageの受け取り方
テキトー教師DotAI 認定講師チャットっぽく出したいなら stream を true にするんですが、そのときに使用量も受け取りたいなら stream_options を一緒に渡します。
python
stream = client.chat.completions.create(
model="deepseek-flash",
messages=[{"role": "user", "content": "自己紹介して"}],
stream=True,
stream_options={"include_usage": True},
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
if chunk.usage:
print(chunk.usage)トークン数が見えないまま流し続けるのがいちばん怖いので、ここは最初から入れておくべきです。あとで請求を見て驚く、という事態を避けられますから。
テキトー教師DotAI 認定講師思考モードの有効・無効や reasoning_effort の指定でトークンの出方も変わりますから、usageを見ながら調整するのが結局いちばん早いですよ。
現行モデルは2つ、flashとv4-proはどう使い分ける？
deepseek-flashは何に向くモデルか
室谷代表取締役まず現行モデルを整理すると、deepseek-flashとdeepseek-v4-proの2つなんですよね。flashの実体はV4.1-Flashで、552BのMoE。
2026年9月10日に出たもので、今のクイックスタートもこれが軸になっています。
2026年9月10日に出たもので、今のクイックスタートもこれが軸になっています。
テキトー教師DotAI 認定講師この辺、初めて触る人がまず引っかかるところで。名前だけ見ると「flash=軽量版」と思われがちなんですけど、中身はフラッグシップ相当なんですよね。
室谷代表取締役呼び名がややこしいんですよ。deepseek-chatやdeepseek-reasonerは今は推奨されていない名称で、最新のドキュメントには登場しない。
deepseek-v4-flashのような古い指定はflashに寄せられて、課金もflash扱いになります。
deepseek-v4-flashのような古い指定はflashに寄せられて、課金もflash扱いになります。
テキトー教師DotAI 認定講師昔のコードをそのまま動かしている人は、モデル名だけ差し替えればいい、と。実際に使っている人からも「動いたけど名前が違う」という声はよく出ます。
deepseek-v4-proの位置づけと、今指定しても実体はFlashになる話
deepseek-flash と deepseek-v4-pro の使い分け
deepseek-flash
- 実体は V4.1-Flash(552B MoE)
- 2026年9月10日リリース
- クイックスタートの軸
- 旧指定 deepseek-v4-flash も flash に寄せられ、課金も flash 扱い
- 今の実質的な推奨モデル
deepseek-v4-pro
- 今あえて指定する意味は薄い
- 2026年9月14日以降、リクエストは全て V4.1-Flash にルーティング
- 課金も flash 料金
- V4.1-Pro が出るまでこの扱いが続くと公式に明記
- コード上 v4-pro のままでも中身と請求は flash
室谷代表取締役で、もう一方のdeepseek-v4-proなんですけど。これ、今あえて指定する意味がかなり薄いんですよ。
テキトー教師DotAI 認定講師え、そうなんですか。
室谷代表取締役2026年9月14日以降、v4-pro宛のリクエストは全部V4.1-Flashにルーティングされて、課金もflash料金なんです。公式のニュースにも、V4.1-Proが出るまでこの扱いが続くと明記されています。
テキトー教師DotAI 認定講師指定しても実体はflash、と。つまり今のところ、わざわざv4-proと書く理由がほぼないんですよね。
コード上はv4-proのままでも、中身と請求はflash側なんです。
コード上はv4-proのままでも、中身と請求はflash側なんです。
thinkingモードとreasoning_effortの選び方
室谷代表取締役実務で効いてくるのはモデル選びよりこっちで、thinkingの切り替えとreasoning_effortの調整なんですよ。thinkingはデフォルトで有効、reasoning_effortはnone・low・high・maxの4段階で、デフォルトはhighです。
テキトー教師DotAI 認定講師noneにすると思考そのものがオフになる、と。裏を返せば何も指定しなければ常に重いほうで走るわけで、そこを知らずに使っているケースは珍しくないんですよ。
室谷代表取締役要約や分類みたいな軽いタスクでhighのままだと、待ち時間もトークンも無駄に膨らみます。コスト管理の立場だと、まずここを用途別に落とすのが一番効くんですよね。
テキトー教師DotAI 認定講師たしかに。軽い処理はnoneかlow、じっくり考えてほしいときだけhigh以上、という切り分けが現実的です。
max_tokensとresponse_formatの注意点
室谷代表取締役あとはmax_tokensとresponse_format。max_tokensは1から384Kまでで、思考なしだとデフォルト8K、思考ありだと64K。
reasoning_effort=maxのときは128Kまで上がります。
reasoning_effort=maxのときは128Kまで上がります。
テキトー教師DotAI 認定講師デフォルト値が思考の有無で変わるので、明示しないと出力が途中で切れることがあるんですよ。
室谷代表取締役response_formatでjson_objectを指定すればJSON出力は保証されるんですけど、プロンプト側でもJSONで返すよう明示しないと、切れるまで空白を吐き続けることがあるらしいので、そこはセットで押さえておきたいところです。
テキトー教師DotAI 認定講師この2つ、片方だけ設定して片方忘れる人がけっこういるんですよね。まずはflashで小さく試して、thinkingとreasoning_effortを用途ごとに決めてから本番に広げるのが堅い進め方です。
料金はいくら？ピーク・オフピークとキャッシュの効き方
100万トークン単位の単価とピーク時間帯の考え方
室谷代表取締役DeepSeek の API、料金が100万トークン単位で出てるんですよ。しかもピークとオフピークで単価が倍違う。
オフピークはピークの半額なんですよね。
オフピークはピークの半額なんですよね。
テキトー教師DotAI 認定講師たしかに、最初に戸惑うのがそこです。「同じリクエストなのに時間帯で値段が変わるの？」って。
ピークはUTCで平日の01:00-04:00と06:00-10:00、中国の祝日を除く、という区切りなんですよ。
ピークはUTCで平日の01:00-04:00と06:00-10:00、中国の祝日を除く、という区切りなんですよ。
室谷代表取締役UTCなので日本時間に直すと午前10時から13時、午後3時から19時にあたる。夜に回していたバッチを少しずらすだけで単価が半分になるので、原価を見る立場だと真っ先に確認する数字なんですよね。
テキトー教師DotAI 認定講師現場感覚で言うと、まとめて流す処理は時間帯をずらすだけで効きます。リアルタイム性が要るものだけピーク側に置く、という切り分けが現実的ですね。
キャッシュヒットで入力コストがどこまで下がるか
テキトー教師DotAI 認定講師同じ会話を続けるとき、毎回全部の入力を読み直しているわけじゃないんですよ。前回と同じ部分はキャッシュに当たって、入力の単価が桁で変わります。
室谷代表取締役flash だと、入力のキャッシュミスがオフピークで $0.15、キャッシュヒットなら $0.003。同じ100万トークンでも50倍近く違うんですよね。
プロンプトの先頭を毎回同じに保つだけで、原価の構造が変わります。
プロンプトの先頭を毎回同じに保つだけで、原価の構造が変わります。
テキトー教師DotAI 認定講師だから、共通の指示や長い資料は先頭に固定しておく。順番をコロコロ入れ替えるとヒットしなくなって、じわじわ効いてくるタイプの失敗なんですよ。
室谷代表取締役これ、ROI で見ると地味に一番デカいんですよ。安いモデルに切り替えるより、キャッシュの設計を直す方が効くケースが多い。
deepseek-v4-proの表示料金と実際の課金のズレ
室谷代表取締役ここが一番ややこしいんですけど、v4-pro のページには入力のキャッシュミスがオフピーク $0.66、出力 $1.98 と書いてある。でも今 v4-pro を指定しても実体は Flash にルーティングされて、課金も Flash の料金なんですよね。
テキトー教師DotAI 認定講師そこ、混乱する人が多いんですよ。表には高い方の数字が残っているのに、実際に払うのは Flash の料金。
公式の告知にルーティングの話が書かれていて、V4.1-Pro が出るまで続く、という扱いなんです。
公式の告知にルーティングの話が書かれていて、V4.1-Pro が出るまで続く、という扱いなんです。
室谷代表取締役だから「高いから v4-pro はやめておこう」という判断も、今は意味が薄い。とはいえ将来戻る前提で、コード側はモデル名を差し替えられるようにしておく。
経営的にはそこが保険なんですよ。
経営的にはそこが保険なんですよ。
テキトー教師DotAI 認定講師なるほど。今の請求額だけ見て「安いからこのままでいい」と固定しちゃうと、戻ったときに単価が跳ねる、と。
公式トップページの数字だけを信じない、確認すべき料金ページ
テキトー教師DotAI 認定講師ここが今日いちばん伝えたいところで。DeepSeek のマーケティング用のトップページと、クイックスタートの料金ページで、数字が一致していないんですよ。
室谷代表取締役そうなんですよね。トップページ側はピーク・オフピークの区別すら無い表記で、金額も違う。
片方は更新が追いついていない可能性が高い。実務では api-docs.deepseek.com/quick_start/pricing を見る、これだけは徹底した方がいい。
片方は更新が追いついていない可能性が高い。実務では api-docs.deepseek.com/quick_start/pricing を見る、これだけは徹底した方がいい。
テキトー教師DotAI 認定講師初めて触る人は、検索して上に出てきたページの数字をそのまま信じがちなんですよ。課金は残高から引かれるので、まずそこだけ押さえておけば事故りません。
室谷代表取締役あと、付与された残高とチャージした残高が両方あると、付与分から先に消える。チャージ分が減っていないから大丈夫、と思い込むと見え方がずれるので、そこも注意なんですよね。
エラーが出たときの対処——401・402・429の読み方
400・401・422はリクエストとキーを見直す
室谷代表取締役エラーコードって、番号ごとに打ち手がだいたい決まってるんですよね。400と401と422は、まず自分の送り方を疑う番号です。
キーが違うか、リクエストの形が崩れてるか、そのどちらか。
キーが違うか、リクエストの形が崩れてるか、そのどちらか。
テキトー教師DotAI 認定講師この辺、初めて触る人が最初に詰まりやすいところで。401は特に誤解が多くて、チャット画面にログインできてるから大丈夫だと思い込んでるとハマります。
APIはplatform側で別にキーを発行する必要がありますから。
APIはplatform側で別にキーを発行する必要がありますから。
室谷代表取締役そう、チャットUIとAPIはキーも残高も別管理なんですよ。401が出たら、まず発行したキーを環境変数に入れ直すところから確認する。
開発ツールに組み込んで使ってる場合は、そっちの設定画面のキー欄ですね。Cursorでキー設定につまずくパターンはCursor APIキーの完全ガイドにまとまってます。
開発ツールに組み込んで使ってる場合は、そっちの設定画面のキー欄ですね。Cursorでキー設定につまずくパターンはCursor APIキーの完全ガイドにまとまってます。
テキトー教師DotAI 認定講師400と422は、modelの指定が抜けてたり、messagesの形が違ってたり、そういうのが多いです。自分でコードを変えてなくても、パラメータの書き方が更新されてることはあるので、公式リファレンスと見比べるのが一番早いですね。
402は残高不足、Top upでチャージする
室谷代表取締役402は分かりやすくて、残高が足りてないだけです。チャージがゼロだと、キーが正しくても全部402で返ってきます。
テキトー教師DotAI 認定講師そこが一番びっくりされるやつで。チャット画面は無料で使えてたのに、APIだけ急に止まる。
中身が別物だから当然なんですけど、画面上は繋がって見えるんですよ。
中身が別物だから当然なんですけど、画面上は繋がって見えるんですよ。
室谷代表取締役だから本番に載せる前に、Top upで先にチャージしておく。開発中に止まるなら笑い話で済みますけど、サービスが動いてる最中に残高切れで止まるのは普通に事故なので。
コスト管理の立場で言えば、残高は常に余裕を持って見ておくのが定石です。
コスト管理の立場で言えば、残高は常に余裕を持って見ておくのが定石です。
429はレート制限、同時接続数の上限とuser_idの使い方
室谷代表取締役429はレート制限。同時接続数の上限が決まっていて、flashは2500、v4-proは500。
これがキーごとじゃなくアカウント単位で数えられるんですよね。
これがキーごとじゃなくアカウント単位で数えられるんですよね。
テキトー教師DotAI 認定講師キーを分ければ逃げられると思ってる人は多いです。実際はアカウント全体で集計されるので、複数キーで並列に投げても同じ枠を取り合う形になります。
室谷代表取締役なので並列で回すときはuser_idを入れておく。利用者ごとにスケジューリングやKVCacheを切り分けられるので、どこで詰まってるかも追いやすくなる。
テキトー教師DotAI 認定講師あと地味なのが、投げたのに返事が来ない時間です。推論が始まるまで空行が流れ続けて、10分進まないと接続が切れます。
無反応に見えるときはそこなので、まず送信間隔を広げるのが先ですね。
無反応に見えるときはそこなので、まず送信間隔を広げるのが先ですね。
500・503は時間を置いて再試行する
室谷代表取締役500と503は自分のせいじゃない番号です。500はサーバー側のエラー、503は過負荷。
ここでリトライを無限に回すと、今度は自分が429を作る側に回ります。
ここでリトライを無限に回すと、今度は自分が429を作る側に回ります。
テキトー教師DotAI 認定講師切り分けは、400番台は自分側、500番台は向こう側、と覚えると早いです。500番台が出たら少し待ってから再試行、それでも続くなら公式のアナウンスを確認する流れでいいと思います。
室谷代表取締役失敗しても止まらない作りにしておくのが大事で。エラーコードごとに分岐を書いておくだけで、運用で慌てる回数がぐっと減りますから。
他のLLM APIと比べて何が違う？OpenAI・Claude・Geminiとの比較
価格と性能のバランスで見たときの立ち位置
室谷代表取締役他社のAPIと横に並べて見るときに、最初に引っかかるのが単価が時間帯で動く点なんですよ。ピークとオフピークがあって、オフピークは半額。
同じリクエストでも投げる時刻で請求が変わるんですよね。
同じリクエストでも投げる時刻で請求が変わるんですよね。
テキトー教師DotAI 認定講師そこ、初めて触る人がまず戸惑うところですね。OpenAIやClaude、Geminiの料金表に慣れていると「時間帯」という軸があること自体が想定外なので。
検証中はオフピークに寄せるだけで体感がけっこう変わります。
検証中はオフピークに寄せるだけで体感がけっこう変わります。
室谷代表取締役あと厄介なのが、v4-pro を指定しても今は Flash に流れて、課金も Flash 料金になる点で。名前で選んだつもりが中身が違う状態が続いてるんですよ。
導入を見積もる立場からすると、ここは読み違えると数字がずれる。
導入を見積もる立場からすると、ここは読み違えると数字がずれる。
テキトー教師DotAI 認定講師だから料金はクイックスタートの料金ページで確認する。トップページの数字だけを信じない、が合言葉ですね。
OpenAI SDKからの移行で書き換える場所
室谷代表取締役乗り換えコストの話で言うと、OpenAI SDKで書いたコードは base_url とAPIキーの2箇所を差し替えるだけで繋がります。エンドポイントは /chat/completions で、そこは同じなんですよ。
テキトー教師DotAI 認定講師実務で最初に詰まるのがモデル名のところです。model に渡すのは deepseek-flash か deepseek-v4-pro。
変え忘れると認証エラーやパラメータ不正で止まります。
変え忘れると認証エラーやパラメータ不正で止まります。
室谷代表取締役あと地味に効くのが response_format でJSON出力を保証する指定ですね。これ、プロンプト側でもJSONで返すよう明示しないと出力が崩れることがある。
既存のプロンプトをそのまま持ってくると、ここで転びます。思考の既定も有効なので、thinking や reasoning_effort の意味も別物として見たほうがいい。
既存のプロンプトをそのまま持ってくると、ここで転びます。思考の既定も有効なので、thinking や reasoning_effort の意味も別物として見たほうがいい。
テキトー教師DotAI 認定講師Anthropic形式のエンドポイントを使う場面
室谷代表取締役逆にAnthropic SDKで書いてる人向けに、https://api.deepseek.com/anthropic という形式のエンドポイントも用意されてるんですよ。base_urlをそっちに向けるだけで、Anthropicのクライアントからそのまま叩ける。
テキトー教師DotAI 認定講師ここは使い分けが分かりにくいところで。OpenAI形式とAnthropic形式のどちらを使うかは、既に持っているコードがどっちのクライアントで書かれているかで決めるのが素直です。
両方を覚える必要はないですね。
両方を覚える必要はないですね。
室谷代表取締役構造で見ると、SDKの互換レイヤーを自前で抱えずに済むのが大きい。乗り換えのたびにラッパーを書き直す運用は、長い目で見ると一番高くつくんですよね。
テキトー教師DotAI 認定講師既存コードを壊さずに試せるので、まず小さい処理を一つ流してみる、という進め方が現実的ですね。
LangChainなどフレームワーク経由で呼び出す
室谷代表取締役フレームワーク経由の話も触れておくと、OpenAI互換のエンドポイントなので、接続先を指定できるタイプのツールなら base_url を差し替える方向で検討できます。個別の対応状況は各ツールのドキュメントを見る必要がありますけど。
テキトー教師DotAI 認定講師実際に使っている人からもよく出る話で、フレームワーク側がプロバイダごとの書き分けを要求してくるかどうかで手間が変わります。OpenAIのクライアントを前提にした作りなら、変更点はかなり少なく済みますね。
室谷代表取締役そこで効いてくるのが、モデル名をどこに書くかです。設定ファイルに切り出しておけば、後で Flash と v4-pro を入れ替えるときにコードを触らずに済む。
テキトー教師DotAI 認定講師あとは料金とレートの前提が変わるので、フレームワーク側のリトライ設定も一緒に見直しておくと安全です。429が返ったときの挙動はツールの設定次第なので。
Claude Codeなどコーディングエージェントのバックエンドに使う
DeepSeek Harnessとは何か、プレビュー提供の位置づけ
室谷代表取締役DeepSeekがエージェント向けのハーネスをプレビューで出してるんですよ。自分でコードを書かなくても、普段使ってるコーディングエージェントの頭をDeepSeekに差し替えられる。
テキトー教師DotAI 認定講師この話、最初は半信半疑でした。受け側のエージェントが対応してないと成立しないですもんね。
室谷代表取締役そこが公式サポートで、Claude Code、GitHub Copilot、OpenCodeあたりがDeepSeek APIをバックエンドとして使える前提になってる。業界構造で見ると、モデルとエージェントの間に汎用の接続口ができた、という話なんですよね。
テキトー教師DotAI 認定講師特定のモデルありきでツールを選ばなくて済むようになる、と。まだプレビューなので仕様が動く余地はありますが、方向性としては大きいです。
Claude Code・GitHub Copilot・OpenCodeから使う
コーディングエージェントのバックエンドをDeepSeekに切り替える手順
- 01APIキーを渡すエージェント側にDeepSeekのAPIキーを設定する
- 02接続先を変更OpenAI形式は https://api.deepseek.com、Anthropic形式は https://api.deepseek.com/anthropic を指定
- 03モデル名を指定使用するモデル名を指定する
切り替えで触るのは、大きく3点です。
- エージェント側にAPIキーを渡す
- 接続先をDeepSeekのエンドポイントに変える（OpenAI形式は
https://api.deepseek.com、Anthropic形式はhttps://api.deepseek.com/anthropic） - 使うモデル名を指定する
テキトー教師DotAI 認定講師つまずきやすいのは、キーを入れたのに動かない、というパターンで。チャットUIとAPIは残高が別管理なので、API側のチャージが要るというところで止まる人がいます。
室谷代表取締役あとは、キーを何本作っても同時接続の枠はアカウント単位で合算なんですよ。チームで並走させる前提だと、そこが先に効いてくる。
エージェント運用は単価より設計の話になりがちです。
エージェント運用は単価より設計の話になりがちです。
テキトー教師DotAI 認定講師権限を分けたいからキーを分ける、という発想だと少しズレるんですね。
室谷代表取締役エージェント用途で気をつける料金とレート制限
室谷代表取締役エージェントは人間が1回打つ比じゃない回数でリクエストを出すので、見るべきは単価より同時接続の上限なんです。flashで2500、v4-proで500。
アカウント単位の合算で、キーを増やしても枠は増えない。
アカウント単位の合算で、キーを増やしても枠は増えない。
テキトー教師DotAI 認定講師超えると429が返ってくる、と。エラーコードの読み方は前の章で触れたとおりですが、エージェントだとこれが日常的に出やすいんですよ。
室谷代表取締役user_idを渡しておくと、利用者ごとにスケジューリングやキャッシュが分かれる。多人数で回すなら入れておく価値がある。
それと、応答が始まらないまま10分経つと接続が切られるので、長く考えさせる設計だとそこも効いてきます。
それと、応答が始まらないまま10分経つと接続が切られるので、長く考えさせる設計だとそこも効いてきます。
テキトー教師DotAI 認定講師料金のほうも、v4-proを指定しても今はFlashに流れてFlash料金で課金されるんでしたよね。名前だけ見て高いと判断する人が出そうで、先に知っておきたいところです。
よくある質問
Q1. 日本語の文章生成でも実用レベル？
室谷代表取締役日本語の生成、実際に触ってる感じだと要約もメールの下書きもそのまま出せるレベルですよ。昔の「英語モデルは日本語がたどたどしい」というイメージのままだと、けっこう拍子抜けすると思います。
テキトー教師DotAI 認定講師そこはよく聞かれますね。ただ、固有名詞や社内の用語が絡むと途端に怪しくなるので、プロンプト側で用語を渡しておくか、出てきたものを人が確認する前提にしたほうが安全です。
室谷代表取締役そうそう。文章のうまさより、用語の揺れをどう潰すかのほうが運用では効いてくるんですよ。
Q2. APIキーをうっかり公開してしまったら？
テキトー教師DotAI 認定講師初めて触る人が一番やりがちなのが、キーをコードに直接書いてそのまま外に出してしまうパターンです。気づいた時点でそのキーは無効化して、新しく発行し直す。
順番としてはこれが先ですね。
順番としてはこれが先ですね。
室谷代表取締役あと、無効化しただけで終わらせないほうがいいです。使用量や残高を一度確認しておくと、変な使われ方をしてないかを判断できますから。
テキトー教師DotAI 認定講師環境変数に逃がす、リポジトリには上げない。この2つを最初に習慣にしちゃうのが、結局いちばん安上がりです。
室谷代表取締役キー管理って開発の速度には直接効かないんですけど、事故ったときの損害は桁が違いますからね。
Q3. 応答の速さは気にしたほうがいい？
テキトー教師DotAI 認定講師レイテンシは、初めて触る人がまず気にするポイントですけど、用途で許容度がまるで違うんですよ。チャットの裏側なら数秒でも気にならない。
リアルタイムの補完に使うなら、体感で厳しくなります。
リアルタイムの補完に使うなら、体感で厳しくなります。
室谷代表取締役あれは数字を見るより、自分のプロンプトで一度計ってみるのが早いですよ。長い入力を渡すほど当然遅くなるので、設計で吸収するか割り切るかの判断になります。
テキトー教師DotAI 認定講師そうそう。速さそのものより、遅いときにユーザーへどう見せるかのほうが、体験には効いてきますから。
Q4. 本番に組み込むときの注意点は？
室谷代表取締役本番で一番効くのは、失敗したときの逃げ道を用意しておくことですね。APIが落ちた、遅い、料金が想定を超えた。
どれが起きてもサービスが止まらない形にしておく。
どれが起きてもサービスが止まらない形にしておく。
テキトー教師DotAI 認定講師あと開発用と本番用でキーを分けておく。これだけで、事故ったときの被害範囲が全然違ってきます。
室谷代表取締役コスト管理の立場で言うと、残高や使用量を定期的に見る仕組みを最初に入れておくと後が楽です。請求が来てから気づくのが、いちばんもったいない。
テキトー教師DotAI 認定講師ログを残しておくのも同じ理由ですね。エラーが出たときに原因を追えるかどうかで、復旧の速さが変わります。
Q5. 入力したデータは学習に使われたりしない？
テキトー教師DotAI 認定講師ここは推測で語るのが一番危ないところで、公式のポリシーを確認するのが確実です。APIとチャットUIで扱いが違う、というのは他のサービスでもよくある話なので。
室谷代表取締役そうですね。顧客データを扱うなら、規約を読むところまでをセットアップの一部にしたほうがいい。
コストより先に決める話です。
コストより先に決める話です。
テキトー教師DotAI 認定講師初めての段階で確認しておくのが、結局いちばん安いんですよね。
まとめ
室谷代表取締役DeepSeek APIの入り口は、思ってるより低いですよ。キーを取って、OpenAI向けに書いたコードの接続先を差し替える。
まずはそこまでを今日やってみるのがいいと思います。
まずはそこまでを今日やってみるのがいいと思います。
テキトー教師DotAI 認定講師そうですね。動いたあとに、モデルの使い分けと料金の見方を少しずつ合わせていく。
最初から全部を決めようとすると、たぶん手が止まります。
最初から全部を決めようとすると、たぶん手が止まります。
室谷代表取締役小さく試して、効果が見えた用途から本番に寄せていく。コストの読みも、そのほうが正確になりますから。
テキトー教師DotAI 認定講師最初は安いほうのモデルで作って、物足りなくなったところだけ上げる。この順番なら無駄な出費も抑えられます。
室谷代表取締役あとはエラーコードに慣れておくと、運用に入ってから慌てずに済みます。切り分けの型が頭に入っているだけで、対応の速さが変わってきますよ。
