ハウツー記事

豆包(Doubao)API導入ガイド:エンドポイントIDの発行から初回リクエストまで

豆包APIはOpenAI互換で叩けるが、最初の関門は登録とエンドポイントIDの発行にある。火山引擎でのアカウント作成、モデル開通、APIキー発行、Pythonからの初回呼び出し、料金を抑える運用までを順を追って解説する。

佐藤健太佐藤健太
人気度:1,180
豆包(Doubao)API導入ガイド:エンドポイントIDの発行から初回リクエストまで

豆包(Doubao)のAPIはOpenAI互換で、Anthropic互換のSDKからそのまま叩ける。だが最初の関門はコードではなく、火山引擎(Volcano Engine)のコンソールでエンドポイントIDを発行する手順だ。この記事は、登録から最初の1リクエストが返るまでを順番にたどる。

豆包APIとは何か、誰が使うのか

豆包は、TikTokを運営するByteDance(バイトダンス)が開発した大規模言語モデルのファミリーだ。提供元は同社のクラウド事業である火山引擎で、開発者向けの入口は「火山方舟(Ark)」というAPIプラットフォームになる。

日本から見ると少し分かりにくい位置づけだ。豆包という名前は中国本土のコンシューマー向けチャットサービスを指すが、APIとして叩くモデル群は doubao-seed 系として提供されている。2026年9月時点で、チャット用のモデルは12種類、画像生成の seedream 系と動画生成の seedance 系を合わせて19のSKUが稼働している。

使うのは、おもに次のような場面だ。

  • 大量のテキスト処理を安く回したい開発者。出力の価格はGPT系より1桁安い水準のモデルがある
  • 中国本土のユーザー向けにサービスを作る場合。海外モデルは中国国内で使えないため、豆包が事実上の選択肢になる
  • 画像・動画の生成パイプラインを1つのAPIにまとめたいチーム

逆に、日本語の込み入った文章を1本だけ仕上げたいといった用途なら、APIを叩くより公式アプリを使ったほうが早い。この記事はAPI経由で自分のアプリに組み込む人向けだ。

登録前に知っておくべき2つの関門

最初に結論を書く。豆包APIには、ほかのAIサービスにはない前提条件が2つある。これを知らずに申し込むと、途中で止まる。

ひとつ目は、APIキーだけでは呼べないことだ。豆包では、使いたいモデルごとに「エンドポイント(接入点)」という接続口を作り、そのIDを指定してリクエストを送る方式をとる。OpenAIのように1つのキーで好きなモデル名を書けば済む、という設計ではない。

ふたつ目は、火山引擎の直接契約が中国本土の電話番号と実名認証を前提にしている点だ。中国本土に法人や居住実体がない開発者にとって、ここが最も高い壁になる。回避策として、OpenAI互換のアグリゲーター経由で豆包を呼ぶルートも存在する。価格は正規の定価とほぼ同じ水準に揃えられているが、中国国内の本人確認を通さずに試せる。

どちらのルートを選ぶかは、自分の事業体が中国本土にあるかどうかで決めてよい。日本法人や個人事業なら、まずアグリゲーターで挙動を確かめ、本番移行を検討する段階で直接契約を判断する流れが現実的だ。

ステップ1:火山引擎のアカウントを作る

ここからは直接契約ルートの手順を書く。アグリゲーターを使う場合は、この段階を飛ばして提供元のキー発行画面に進んでよい。

  1. ブラウザで火山引擎のコンソール(console.volcengine.com)を開く。
  2. 右上の「注册」からアカウントを作成する。携帯番号か、企業向けの登録経路を選べる。
  3. 中国本土の携帯番号を登録し、SMSで届くコードを入力して認証を済ませる。
  4. 実名認証(实名认证)の画面に進む。個人は身分証、法人は営業許可証の情報を登録する。
  5. ログイン後、製品一覧から「火山方舟(Ark)」を検索して開く。

この時点でアカウントはできているが、モデルはまだ有効になっていない。次に進む。

ステップ2:モデルを有効化してエンドポイントIDを発行する

豆包のAPIを呼ぶ鍵は、このエンドポイントIDだ。ここを飛ばすと、キーを持っていてもリクエストは弾かれる。

  1. 火山方舟の画面で「模型广场(モデル広場)」を開く。
  2. 使いたいモデルを選ぶ。迷ったら doubao-seed-1.6-flash を選ぶ。安く、256Kのコンテキストを持つ。すでに開通済みのモデルはそのまま選べる。
  3. 「开通(開通)」を押す。言語モデルは初回開通でモデルごとに50万トークンが無料で付く。
  4. 左メニューの「在线推理(オンライン推論)」から「创建接入点(エンドポイントを作成)」を開く。
  5. 開通したモデルを選び、任意の名前を付けて作成する。
  6. 作成後に表示されるエンドポイントID(ep- で始まる文字列)を控える。これがコードに書く識別子になる。

エンドポイントIDは、モデル名の代わりにリクエストへ渡す値だ。あとでモデルを差し替えたいときは、新しいエンドポイントを作ってIDを入れ替えるだけでよい。設定を書き換えて再デプロイする必要はない。

続けてAPIキーを発行する。

  1. コンソールの「API Key 管理」を開く。
  2. 「创建 API Key(APIキーを作成)」を押し、名前を付ける。
  3. 表示されたキーをコピーする。この画面は一度閉じると再表示できない。
  4. キーは環境変数に保存する。コードに直接書き込まない。

ステップ3:最初のリクエストを送る

豆包のAPIはOpenAI互換なので、既存のSDKを向き先だけ変えて使える。ここではPythonで最小の呼び出しを書く。

  1. ターミナルでSDKを入れる。pip install openai で足りる。
  2. キーとエンドポイントIDを環境変数に置く。
  3. 次のコードで、APIの向き先を火山方舟のエンドポイントに変える。
python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ARK_API_KEY"],
    base_url="https://ark.cn-beijing.volces.com/api/v3",
)

resp = client.chat.completions.create(
    model=os.environ["ARK_ENDPOINT_ID"],
    messages=[
        {"role": "user", "content": "日本語で120字程度に要約してください。"},
    ],
)
print(resp.choices[0].message.content)
  1. 実行する。最初のレスポンスが返れば、接続は成立している。

base_url に指定したアドレスが、OpenAI SDKの通信先を丸ごと差し替える。model に渡しているのはモデル名ではなくエンドポイントIDだ。ここを間違えると model not found で弾かれるので、最初につまずきやすい。

料金の考え方と安く抑えるコツ

料金はトークン単位で課金される。2026年9月時点の主なモデルの価格は次のとおり。開発者向けの集計値では、doubao-seed-1.6-flash が入力100万トークンあたり0.022ドル、出力で0.219ドルという水準になっている。旗艦の doubao-seed-2.0-pro は入力0.514ドル、出力2.57ドルで、出力だけで比べると10倍以上の差がつく。

ここで効くのが、安いモデルを既定にして、必要なときだけ高いモデルへ上げる運用だ。大量の分類や下書きは doubao-seed-1.6-flash で回し、視覚入力や長い文脈、エージェント的なコーディングが必要な場面だけ上位モデルに切り替える。すべてを旗艦モデルで処理する場合と、9対1の割合で振り分ける場合では、月の請求額が6倍以上変わってくる。

古い doubao-1.5 系は安いが、コンテキストが32Kで止まる。長い文書やコードベースを扱う今どきの用途には足りないので、新規の構築では選ばないほうがよい。

つまずきやすい点

エンドポイントIDの未指定が最も多い。キーは正しいのに model にモデル名を書いてしまい、エラーで止まる例が目立つ。APIキーとエンドポイントIDは別物だと覚えておく。

次に、中国本土の電話番号がない場合。この時点で直接契約は選択肢から外れる。アグリゲーター経由なら同じモデルをOpenAI互換のまま呼べるので、まずそちらで動かし、必要になった段階で直接契約を検討すればよい。

ストリーミングやツール呼び出しを使う場合は、モデルによって対応状況が違う。doubao-seed-1.6 系と 2.0 系はビジョン、ツール呼び出し、JSON出力、思考モードに対応するが、1.5 系は対応が限られる。機能を前提にモデルを選ぶときは、開通前に対応表を確認する。

まとめ

豆包APIは、OpenAI互換のおかげでコード側の乗り換えコストが低い。本当の山場は接続前の準備、つまりアカウント登録、モデルの開通、エンドポイントIDの発行にある。ここさえ越えれば、あとは既存のOpenAI SDKの向き先を変えるだけで動く。

まずは doubao-seed-1.6-flash で1リクエストを返すところまで進め、動いたら用途に合わせてモデルを足していく。価格とコンテキストの一覧は、契約前に必ず現在のコンソールで確認してほしい。数字は改定されるので、記事の値は出発点として扱っておくといい。

このニュースを共有

出典

関連AIニュース

Claude Codeのmodsとは何か:TypeScriptでエージェントを書き換えるプラグイン
ハウツー記事

Claude Codeのmodsとは何か:TypeScriptでエージェントを書き換えるプラグイン

AnthropicがClaude Codeに「mods(モッズ)」を追加した。Claude Codeの中で動くJavaScript/TypeScriptのプラグインで、ツール呼び出しから画面の描画まで手を入れられる。拡張の自由度と、それに伴う権限の広がりが同時にやってきた。

人気度:880
Grok Team Botsの設定方法、文脈・プラグイン・Slack
ハウツー記事

Grok Team Botsの設定方法、文脈・プラグイン・Slack

Grok Team Botsは、チーム全員が1つの共有AIエージェントで働ける仕組みだ。設定の勘所は文脈、プラグイン、認証情報、メモリの4つ。この記事では各項目の選び方を順にたどる。初日のうちに役立つBotにして、二度と開かれないデモで終わらせないための手引きだ。

人気度:1,020
GrokのNSFWコンテンツ設定:表示方法と変更手順
ハウツー記事

GrokのNSFWコンテンツ設定:表示方法と変更手順

Grokのセンシティブコンテンツ設定について、項目の名称、単体版とX版での入口の違い、有効にする手順、項目が表示されない条件、設定と生成フィルタの関係を、公式の設定項目に沿って事実として整理する。

人気度:890
AI検索でのブランド言及を測る:指標の決め方と追跡の進め方
ハウツー記事

AI検索でのブランド言及を測る:指標の決め方と追跡の進め方

AI検索では順位ではなく回答への登場が可視性を決める。追跡用のプロンプトの決め方、ベースラインの記録、スコア・シェアオブボイス・論調などの指標、引用元の分け方、自動化に移る目安を順に解説する。

人気度:980