<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Akira</title>
    <description>The latest articles on DEV Community by Akira (@aakira).</description>
    <link>https://dev.to/aakira</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F3816151%2Fbb126af7-07b9-4483-91c4-7f4ccabb61f5.png</url>
      <title>DEV Community: Akira</title>
      <link>https://dev.to/aakira</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/aakira"/>
    <language>en</language>
    <item>
      <title>クロード・ハイク 5.5 ベンチマーク</title>
      <dc:creator>Akira</dc:creator>
      <pubDate>Thu, 08 Oct 2026 04:15:44 +0000</pubDate>
      <link>https://dev.to/aakira/kurodohaiku-55-bentimaku-1kp7</link>
      <guid>https://dev.to/aakira/kurodohaiku-55-bentimaku-1kp7</guid>
      <description>&lt;p&gt;Claude Haiku 5.5は、OSWorld 2.1で72.4%、GDPval-AA v2.1で1620、FrontierCode 1.1で46.4%、Terminal-Bench 4.0で39.2%のスコアを記録しました。Haiku 4.5は、これら3つのうち、15.7%、735、0.0%のスコアでした。これらはすべて最大努力の数値であり、デフォルトの&lt;code&gt;medium&lt;/code&gt;努力では、GDPval-AAは1277に低下します。現時点では、独立した研究機関からHaiku 5.5の結果はまだ発表されていません。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;今すぐApidogを試す&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;以下では、Claude Haiku 5.5のベンチマーク、実行者、努力レベルがスコアとコストに与える影響、さらに&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;で実際のトラフィックを使ってモデルを評価する手順を説明します。仕様と価格については、&lt;a href="https://apidog.com/jp/blog/what-is-claude-haiku-5-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5とは&lt;/a&gt;を確認してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  公開時のテーブル
&lt;/h2&gt;

&lt;p&gt;Haiku 5.5の各セルは、最大努力で適応的思考を使用しており、通常は5回の試行の平均値です。Terminal-Benchではタスクごとに10回試行されています。&lt;code&gt;n/r&lt;/code&gt;は結果が公開されていないことを意味します。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;ベンチマーク&lt;/th&gt;
&lt;th&gt;Haiku 5.5&lt;/th&gt;
&lt;th&gt;Haiku 4.5&lt;/th&gt;
&lt;th&gt;GPT-6 Luna&lt;/th&gt;
&lt;th&gt;Sonnet 5.5&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;GDPval-AA v2.1 (Elo)&lt;/td&gt;
&lt;td&gt;1620&lt;/td&gt;
&lt;td&gt;735&lt;/td&gt;
&lt;td&gt;1437&lt;/td&gt;
&lt;td&gt;1840&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AA-Briefcase v1.1 (Elo)&lt;/td&gt;
&lt;td&gt;1578&lt;/td&gt;
&lt;td&gt;614&lt;/td&gt;
&lt;td&gt;1336&lt;/td&gt;
&lt;td&gt;1824&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;OSWorld 2.1、オフラインサブセット&lt;/td&gt;
&lt;td&gt;72.4%&lt;/td&gt;
&lt;td&gt;15.7%&lt;/td&gt;
&lt;td&gt;48.9%&lt;/td&gt;
&lt;td&gt;83.9%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Humanity’s Last Exam、ツールなし&lt;/td&gt;
&lt;td&gt;45.9%&lt;/td&gt;
&lt;td&gt;10.2%&lt;/td&gt;
&lt;td&gt;n/r&lt;/td&gt;
&lt;td&gt;56.9%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Humanity’s Last Exam、ツールあり&lt;/td&gt;
&lt;td&gt;57.4%&lt;/td&gt;
&lt;td&gt;18.7%&lt;/td&gt;
&lt;td&gt;n/r&lt;/td&gt;
&lt;td&gt;64.5%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Terminal-Bench 4.0&lt;/td&gt;
&lt;td&gt;39.2%&lt;/td&gt;
&lt;td&gt;0.0%&lt;/td&gt;
&lt;td&gt;16.4%&lt;/td&gt;
&lt;td&gt;70.6%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;FrontierCode 1.1（メイン）&lt;/td&gt;
&lt;td&gt;46.4%&lt;/td&gt;
&lt;td&gt;n/r&lt;/td&gt;
&lt;td&gt;42.4%&lt;/td&gt;
&lt;td&gt;52.1% (xhigh)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Chartography、ツールなし&lt;/td&gt;
&lt;td&gt;46.4%&lt;/td&gt;
&lt;td&gt;6.4%&lt;/td&gt;
&lt;td&gt;29.1%&lt;/td&gt;
&lt;td&gt;61.6%&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  各ベンチマークの実行者
&lt;/h2&gt;

&lt;p&gt;Anthropicはほとんどのテストを自社で実行しました。ベンダー間の行はベンチマーク名を共有していますが、ハーネスや努力設定まで同じとは限りません。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;ベンチマーク&lt;/th&gt;
&lt;th&gt;実行者&lt;/th&gt;
&lt;th&gt;条件&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;GDPval-AA v2.1、AA-Briefcase v1.1&lt;/td&gt;
&lt;td&gt;Artificial Analysis、独立して&lt;/td&gt;
&lt;td&gt;GDPval-AA: 220タスク、44職種。EloはDeepSeek V4.1 Flash（最大）の1600に固定。Briefcase: 数週間のプロジェクト&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;FrontierCode 1.1&lt;/td&gt;
&lt;td&gt;Cognition&lt;/td&gt;
&lt;td&gt;ClaudeはClaude Code、GPTはCodexで実行。メイン = 150タスク中、最も難しい100タスク&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Chartography&lt;/td&gt;
&lt;td&gt;Anthropic、Surge AIのベンチマークで&lt;/td&gt;
&lt;td&gt;Gemini 3.5 Flashグレーダー。LunaのスコアはSurge AIから&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Terminal-Bench 4.0&lt;/td&gt;
&lt;td&gt;Anthropic&lt;/td&gt;
&lt;td&gt;Claude Code &lt;code&gt;--bare&lt;/code&gt;、66タスク、各10回試行、セーフガード有効&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;OSWorld 2.1&lt;/td&gt;
&lt;td&gt;Anthropic&lt;/td&gt;
&lt;td&gt;108タスク中82タスク、1080p、最大500ステップ&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Humanity’s Last Exam&lt;/td&gt;
&lt;td&gt;Anthropic&lt;/td&gt;
&lt;td&gt;98万トークンのタスク予算、Opus 4.6グレーダー&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;GPT-6 Lunaの2つのセルには文脈が必要です。AnthropicはOpenAIのAPIを介して、LunaのOSWorldスコアを同じ82タスクで実行しました。LunaのTerminal-Bench 16.4%は、公開リーダーボードのCodex CLI・最大努力によるものです。&lt;/p&gt;

&lt;p&gt;Terminal-Benchでは、Haiku 5.5の試行の1.8%（660回中12回）がセーフガードによって停止され、それぞれ失敗としてカウントされました。&lt;/p&gt;

&lt;h2&gt;
  
  
  FrontierCodeの罠
&lt;/h2&gt;

&lt;p&gt;公開時のテーブルでは、Haiku 5.5の最大値である46.4%と、Sonnet 5.5の最高スコアであるxhigh値の52.1%が並んでいます。&lt;a href="https://www.anthropic.com/claude-haiku-5-5-system-card" rel="noopener noreferrer"&gt;システムカード&lt;/a&gt;には、同条件での数値が示されています。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;FrontierCode 1.1&lt;/th&gt;
&lt;th&gt;メイン&lt;/th&gt;
&lt;th&gt;拡張&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Haiku 5.5、最大&lt;/td&gt;
&lt;td&gt;46.4%&lt;/td&gt;
&lt;td&gt;58.4%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Haiku 5.5、xhigh&lt;/td&gt;
&lt;td&gt;45.8%&lt;/td&gt;
&lt;td&gt;n/r&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Sonnet 5.5、最大&lt;/td&gt;
&lt;td&gt;46.2%&lt;/td&gt;
&lt;td&gt;59.1%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Sonnet 5.5、xhigh&lt;/td&gt;
&lt;td&gt;52.1%&lt;/td&gt;
&lt;td&gt;64.4%&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;最大努力では、Haiku 5.5がメインでSonnet 5.5を46.4%対46.2%でわずかに上回ります。一方、各モデルの最高設定を比較すると、Sonnetが5.7ポイントリードします。&lt;/p&gt;

&lt;p&gt;FrontierCodeの結果を引用する場合は、必ず努力レベルも併記してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  システムカードの追加情報
&lt;/h2&gt;

&lt;p&gt;システムカードには、公開投稿で省略された行が追加されています。特に明記されていない限り、すべて最大努力での結果です。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;ベンチマーク&lt;/th&gt;
&lt;th&gt;Haiku 5.5&lt;/th&gt;
&lt;th&gt;Haiku 4.5&lt;/th&gt;
&lt;th&gt;Sonnet 5.5&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;SWE-Bench Pro&lt;/td&gt;
&lt;td&gt;64.8&lt;/td&gt;
&lt;td&gt;n/r&lt;/td&gt;
&lt;td&gt;81.3&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;SWE-bench Multilingual&lt;/td&gt;
&lt;td&gt;83.7&lt;/td&gt;
&lt;td&gt;67.4&lt;/td&gt;
&lt;td&gt;90.3&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;SWE-bench Multimodal&lt;/td&gt;
&lt;td&gt;30.7&lt;/td&gt;
&lt;td&gt;19.8&lt;/td&gt;
&lt;td&gt;54.3&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;OSWorld 2.1、厳格な合格率&lt;/td&gt;
&lt;td&gt;37.1%&lt;/td&gt;
&lt;td&gt;n/r&lt;/td&gt;
&lt;td&gt;48.8%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Chartography、ツールあり&lt;/td&gt;
&lt;td&gt;86.2%&lt;/td&gt;
&lt;td&gt;8.8%&lt;/td&gt;
&lt;td&gt;90.2%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;OfficeQA / OfficeQA Pro&lt;/td&gt;
&lt;td&gt;73.5% / 60.3%&lt;/td&gt;
&lt;td&gt;63.0% / 47.1%&lt;/td&gt;
&lt;td&gt;76.9% / 65.6%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;HealthBench Professional（長さを調整済み）&lt;/td&gt;
&lt;td&gt;64.8%&lt;/td&gt;
&lt;td&gt;32.2%&lt;/td&gt;
&lt;td&gt;69.2%&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;OSWorldの72.4%は部分点であり、完全に合格したタスクは37.1%です。&lt;/p&gt;

&lt;p&gt;Chartographyはツールを使用すると46.4%から86.2%まで上昇します。チャートを扱うワークフローでは、Haiku 5.5に必要なツールを提供してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  デフォルトの努力レベルではスコアが低い
&lt;/h2&gt;

&lt;p&gt;Claude APIおよびClaude Codeでは、Haiku 5.5のデフォルトは&lt;code&gt;medium&lt;/code&gt;です。システムカードには、デフォルト努力レベルでの結果も報告されています。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;ベンチマーク&lt;/th&gt;
&lt;th&gt;Medium（デフォルト）&lt;/th&gt;
&lt;th&gt;最大&lt;/th&gt;
&lt;th&gt;注記&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;GDPval-AA v2.1&lt;/td&gt;
&lt;td&gt;1277&lt;/td&gt;
&lt;td&gt;1620&lt;/td&gt;
&lt;td&gt;Mediumでは、最大努力の約10分の1の出力トークンを使用&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AA-Briefcase v1.1&lt;/td&gt;
&lt;td&gt;1372&lt;/td&gt;
&lt;td&gt;1578&lt;/td&gt;
&lt;td&gt;Mediumでは、最大努力の4分の1未満の出力トークンを使用&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;HealthBench Professional&lt;/td&gt;
&lt;td&gt;59.9%&lt;/td&gt;
&lt;td&gt;64.8%&lt;/td&gt;
&lt;td&gt;Low 57.9%、high 61.3%&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;code&gt;output_config.effort&lt;/code&gt;を指定せずにAPIを呼び出すと、左列の結果に近い挙動を期待することになります。&lt;a href="https://platform.claude.com/docs/en/build-with-claude/effort" rel="noopener noreferrer"&gt;努力レベルのドキュメント&lt;/a&gt;には、5段階すべての設定が記載されています。&lt;/p&gt;

&lt;h2&gt;
  
  
  努力レベル別のスコアとコスト
&lt;/h2&gt;

&lt;p&gt;公開チャートの数値を、スコアとコストとして整理します。OSWorldとTerminal-Benchのコストは試行ごと、GDPval-AAのコストはタスクごとです。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;モデル&lt;/th&gt;
&lt;th&gt;Low&lt;/th&gt;
&lt;th&gt;Medium&lt;/th&gt;
&lt;th&gt;High&lt;/th&gt;
&lt;th&gt;Xhigh&lt;/th&gt;
&lt;th&gt;Max&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;OSWorld 2.1&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Haiku 5.5&lt;/td&gt;
&lt;td&gt;42.0% ($0.07)&lt;/td&gt;
&lt;td&gt;53.3% ($0.13)&lt;/td&gt;
&lt;td&gt;61.3% ($0.18)&lt;/td&gt;
&lt;td&gt;67.6% ($0.28)&lt;/td&gt;
&lt;td&gt;72.4% ($0.61)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Sonnet 5.5&lt;/td&gt;
&lt;td&gt;57.9% ($0.68)&lt;/td&gt;
&lt;td&gt;66.0% ($0.93)&lt;/td&gt;
&lt;td&gt;73.2% ($1.38)&lt;/td&gt;
&lt;td&gt;81.1% ($2.22)&lt;/td&gt;
&lt;td&gt;83.9% ($5.73)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;GPT-6 Luna&lt;/td&gt;
&lt;td&gt;19.2% ($0.04)&lt;/td&gt;
&lt;td&gt;37.5% ($0.13)&lt;/td&gt;
&lt;td&gt;42.3% ($0.14)&lt;/td&gt;
&lt;td&gt;44.8% ($0.17)&lt;/td&gt;
&lt;td&gt;48.9% ($0.21)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;GDPval-AA v2.1&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Haiku 5.5&lt;/td&gt;
&lt;td&gt;1125 ($0.012)&lt;/td&gt;
&lt;td&gt;1277 ($0.030)&lt;/td&gt;
&lt;td&gt;1420 ($0.089)&lt;/td&gt;
&lt;td&gt;1513 ($0.27)&lt;/td&gt;
&lt;td&gt;1620 ($0.87)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Sonnet 5.5&lt;/td&gt;
&lt;td&gt;1179 ($0.22)&lt;/td&gt;
&lt;td&gt;1324 ($0.27)&lt;/td&gt;
&lt;td&gt;1551 ($0.62)&lt;/td&gt;
&lt;td&gt;1731 ($1.88)&lt;/td&gt;
&lt;td&gt;1840 ($6.78)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;GPT-6 Luna&lt;/td&gt;
&lt;td&gt;1036 ($0.004)&lt;/td&gt;
&lt;td&gt;1262 ($0.02)&lt;/td&gt;
&lt;td&gt;1344 ($0.03)&lt;/td&gt;
&lt;td&gt;1364 ($0.05)&lt;/td&gt;
&lt;td&gt;1437 ($0.09)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Terminal-Bench 4.0&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Haiku 5.5&lt;/td&gt;
&lt;td&gt;12.7% ($0.42)&lt;/td&gt;
&lt;td&gt;20.3% ($0.68)&lt;/td&gt;
&lt;td&gt;24.8% ($1.04)&lt;/td&gt;
&lt;td&gt;31.5% ($1.75)&lt;/td&gt;
&lt;td&gt;39.2% ($2.64)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Sonnet 5.5&lt;/td&gt;
&lt;td&gt;20.0% ($0.62)&lt;/td&gt;
&lt;td&gt;28.8% ($0.68)&lt;/td&gt;
&lt;td&gt;43.0% ($1.46)&lt;/td&gt;
&lt;td&gt;61.5% ($4.34)&lt;/td&gt;
&lt;td&gt;70.6% ($10.44)&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;実装時に見るべきポイントは次のとおりです。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;最大努力は最後の段階で高価になります。&lt;/strong&gt; GDPval-AAでは、最大努力はmediumの約28倍のコストで、Eloは343ポイント高くなります。OSWorldでは、最大努力はxhighの2倍以上のコストで、スコア差は4.8ポイントです。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;OSWorldではHaiku 5.5のmediumがLunaの最大努力を上回ります。&lt;/strong&gt; Haiku 5.5は53.3%（$0.13）、Lunaは48.9%（$0.21）です。ただし、他の同レベル設定ではLunaの方が安価です。詳細は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-vs-gpt-6-luna?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 vs GPT-6 Luna&lt;/a&gt;を参照してください。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;OSWorldではHaiku 5.5の最大努力がSonnet 5.5のmediumを上回ります。&lt;/strong&gt; Haiku 5.5は72.4%（$0.61）、Sonnet 5.5は66.0%（$0.93）です。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Terminal-Benchは例外です。&lt;/strong&gt; Sonnet 5.5のhighは43.0%（$1.46）で、Haiku 5.5の最大努力である39.2%（$2.64）を、より低いコストで上回ります。Sonnetのコストには新しい$0.10のキャッシュ読み取り価格が適用されています。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;コストは定価に基づいています。10万トークンまでのプロンプトでは100万トークンあたり$0.10/$0.50で、それを超えると高くなります。詳細は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;価格の内訳&lt;/a&gt;を確認してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  Haiku 5.5がまだ劣る点
&lt;/h2&gt;

&lt;p&gt;Sonnet 5.5は公開テーブルのすべての行でリードしています。Haikuが直接対決で勝利したのは、同じ最大努力でのFrontierCodeだけです。&lt;/p&gt;

&lt;p&gt;差が大きいベンチマークは次のとおりです。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Terminal-Bench 4.0: 39.2% 対 70.6%&lt;/li&gt;
&lt;li&gt;SWE-Bench Pro: 64.8 対 81.3&lt;/li&gt;
&lt;li&gt;SWE-bench Multimodal: 30.7 対 54.3&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Anthropicも、Sonnet 5.5とOpus 5.5は「複雑なエージェント型コーディングタスクには依然として優れた選択肢」であると述べています。&lt;/p&gt;

&lt;p&gt;Haiku 5.5は、要約、分類、ブラウザ操作、または大きなモデル配下のサブエージェントなど、範囲を限定した作業に適しています。安価なサブエージェントとしてHaiku 5.5を実行する方法は、&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude CodeにおけるHaiku 5.5&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  独立した結果：まだなし
&lt;/h2&gt;

&lt;p&gt;2026年10月8日現在、独立した研究機関からHaiku 5.5の結果は発表されていません。&lt;/p&gt;

&lt;p&gt;Artificial AnalysisのHaiku 5.5ページは404エラーを返し、その&lt;a href="https://artificialanalysis.ai/leaderboards/models" rel="noopener noreferrer"&gt;リーダーボード&lt;/a&gt;にはClaude 4.5 Haikuのみが掲載されています。Vals、LMArena、SWE-bench、Aiderでも結果は示されていません。&lt;/p&gt;

&lt;p&gt;第三者機関による速度の数値はありません。AnthropicはHaiku 5.5を標準速度では「現時点で最速のモデル」と呼んでいますが、Fast ModeのOpusよりは遅いとしています。&lt;/p&gt;

&lt;p&gt;最も近い外部数値はCursorから来ています。&lt;a href="https://cursor.com/docs/models/claude-haiku-5-5" rel="noopener noreferrer"&gt;モデルドキュメント&lt;/a&gt;によると、Haiku 5.5はCursorBenchで最大努力時に48.4%のスコアを記録しており、lowの30.9%から上昇しています。&lt;/p&gt;

&lt;p&gt;思考オフの場合、Cursorは22.1%から26.2%を報告しています。同じ努力レベルで思考オンの場合は30.9%から42.3%です。&lt;/p&gt;

&lt;h2&gt;
  
  
  顧客の報告
&lt;/h2&gt;

&lt;p&gt;以下はAnthropicの公開投稿によるものであり、独立して検証されたものではありません。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;HubSpot:&lt;/strong&gt; シミュレーションされたCRMポータルスイートでの3回の実行の平均で92.8%を記録。これは同スイートでこれまでに見られた最高スコアです。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;AlphaSense:&lt;/strong&gt; 400のドキュメント内質問クエリで、Haiku 4.5の0.76に対して0.84を記録。統計的に有意であるとしています。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Box:&lt;/strong&gt; 初期テストで、Haiku 4.5よりも約半分のレイテンシで11ポイント高いスコアを記録。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Asana:&lt;/strong&gt; タスク完了レイテンシが、現在のモデルと比較して30%以上低下。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cognition:&lt;/strong&gt; Devin FusionはHaiku 5.5をサイドキック、Opus 5.5をリードとして使用し、FrontierCodeで66.2のスコアを保持。これはHaiku単独ではなく、2モデルのシステムです。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  独自の評価を実行する
&lt;/h2&gt;

&lt;p&gt;ベンチマークのスコアを、そのまま本番ワークロードの意思決定に使うべきではありません。&lt;/p&gt;

&lt;p&gt;Anthropicの&lt;a href="https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5" rel="noopener noreferrer"&gt;プロンプトガイド&lt;/a&gt;では、自社の評価で改善が確認できる場合にのみxhighまたはmaxを使用し、比較対象としてSonnet 5.5でも同じ評価を実行することを推奨しています。&lt;/p&gt;

&lt;p&gt;Apidogで評価コレクションを作成する手順は次のとおりです。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;code&gt;ANTHROPIC_API_KEY&lt;/code&gt;を環境変数として保存します。&lt;/li&gt;
&lt;li&gt;実際の入力から20〜50個を選び、Messages APIリクエストとして保存します。&lt;/li&gt;
&lt;li&gt;各リクエストにアサーションを追加します。

&lt;ul&gt;
&lt;li&gt;ステータスコードが&lt;code&gt;200&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;stop_reason&lt;/code&gt;が&lt;code&gt;"max_tokens"&lt;/code&gt;または&lt;code&gt;"refusal"&lt;/code&gt;ではない&lt;/li&gt;
&lt;li&gt;正答に必要な文字列、構造、またはフィールドが含まれる&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;low&lt;/code&gt;、&lt;code&gt;medium&lt;/code&gt;、&lt;code&gt;high&lt;/code&gt;でコレクションを実行します。努力レベルを変えると、プロンプトキャッシュは無効になります。&lt;/li&gt;
&lt;li&gt;合格率と&lt;code&gt;usage&lt;/code&gt;内のトークン数を記録します。新しいトークナイザーは、同じテキストに対してHaiku 4.5よりも約30%多くのトークンを生成します。&lt;/li&gt;
&lt;li&gt;コレクションを複製してモデルを&lt;code&gt;claude-sonnet-5-5&lt;/code&gt;に変更し、同じプロジェクト内で比較します。
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl https://api.anthropic.com/v1/messages &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"x-api-key: &lt;/span&gt;&lt;span class="nv"&gt;$ANTHROPIC_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"anthropic-version: 2023-06-01"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"content-type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "claude-haiku-5-5",
    "max_tokens": 8000,
    "thinking": {"type": "adaptive"},
    "output_config": {"effort": "medium"},
    "messages": [{
      "role": "user",
      "content": "Classify this support ticket as billing, bug or feature request: ..."
    }]
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Haiku 5.5では、&lt;code&gt;temperature&lt;/code&gt;、&lt;code&gt;top_p&lt;/code&gt;、&lt;code&gt;top_k&lt;/code&gt;、またはアシスタントの事前入力を送信しないでください。これらは400エラーを返します。&lt;/p&gt;

&lt;p&gt;また、&lt;code&gt;thinking&lt;/code&gt;ブロックが最初に返る場合があるため、レスポンスコンテンツは配列の位置ではなく&lt;code&gt;type&lt;/code&gt;で選択してください。&lt;/p&gt;

&lt;p&gt;実装例とテスト方法は、&lt;a href="https://apidog.com/jp/blog/how-to-use-claude-haiku-5-5-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;APIガイド&lt;/a&gt;および&lt;a href="https://apidog.com/jp/blog/test-llm-applications?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;LLMアプリケーションのテスト&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  よくある質問
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Claude Haiku 5.5はSonnet 5.5よりも優れていますか？
&lt;/h3&gt;

&lt;p&gt;Anthropicの数値では、全体としてはそうではありません。Sonnet 5.5は公開テーブルのすべての行でリードしています。&lt;/p&gt;

&lt;p&gt;Haikuがわずかに上回るのは、両方が最大努力で実行された場合のFrontierCodeのみです。Haiku 5.5は46.4%、Sonnet 5.5は46.2%です。&lt;/p&gt;

&lt;p&gt;アップグレードの視点については、&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-vs-haiku-4-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 vs Haiku 4.5&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  Haiku 5.5のSWE-benchスコアはどのくらいですか？
&lt;/h3&gt;

&lt;p&gt;すべて最大努力で、以下の結果です。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;SWE-Bench Pro: 64.8&lt;/li&gt;
&lt;li&gt;SWE-bench Multilingual: 83.7&lt;/li&gt;
&lt;li&gt;SWE-bench Multimodal: 30.7&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  ベンチマークはどの努力レベルで実行されましたか？
&lt;/h3&gt;

&lt;p&gt;最大努力で、通常は5回の試行の平均です。&lt;/p&gt;

&lt;p&gt;APIのデフォルトは&lt;code&gt;medium&lt;/code&gt;であり、GDPval-AAでは1620ではなく1277を記録します。&lt;/p&gt;

&lt;h3&gt;
  
  
  独立したHaiku 5.5のベンチマークはありますか？
&lt;/h3&gt;

&lt;p&gt;まだありません。&lt;/p&gt;

&lt;p&gt;Artificial AnalysisはGDPval-AAとAA-Briefcaseを独立して実行しましたが、これらのスコアはAnthropicが公開したものです。AAにはHaiku 5.5のページはありません。&lt;/p&gt;

&lt;h3&gt;
  
  
  GPT-6 Lunaの方が安価ですか？
&lt;/h3&gt;

&lt;p&gt;通常はそうです。&lt;/p&gt;

&lt;p&gt;LunaはGDPval-AAのすべての努力レベルと、mediumを除くOSWorldのすべてのレベルで低コストです。OSWorldのmediumでは両者のコストはほぼ同じです。Haiku 5.5は両方のベンチマークでより高いスコアを記録しています。&lt;/p&gt;

&lt;h2&gt;
  
  
  次のステップ
&lt;/h2&gt;

&lt;p&gt;まずは&lt;code&gt;medium&lt;/code&gt;で始めてください。評価コレクションで合格率の改善を確認し、その改善が追加コストに見合う場合にのみ&lt;code&gt;high&lt;/code&gt;、&lt;code&gt;xhigh&lt;/code&gt;、&lt;code&gt;max&lt;/code&gt;へ進みます。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/download?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidogをダウンロード&lt;/a&gt;し、実際のプロンプトで評価コレクションを作成してください。本番トラフィックを切り替える前に、Sonnet 5.5のベースラインとともに結果を&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;に保存して比較します。&lt;/p&gt;

</description>
      <category>ai</category>
      <category>api</category>
      <category>claude</category>
      <category>llm</category>
    </item>
    <item>
      <title>Claude Haiku 5.5とHaiku 4.5の比較：変更点と破壊的変更の対処法</title>
      <dc:creator>Akira</dc:creator>
      <pubDate>Thu, 08 Oct 2026 04:14:45 +0000</pubDate>
      <link>https://dev.to/aakira/claude-haiku-55tohaiku-45nobi-jiao-bian-geng-dian-topo-huai-de-bian-geng-nodui-chu-fa-3787</link>
      <guid>https://dev.to/aakira/claude-haiku-55tohaiku-45nobi-jiao-bian-geng-dian-topo-huai-de-bian-geng-nodui-chu-fa-3787</guid>
      <description>&lt;p&gt;Claude Haiku 5.5（&lt;code&gt;claude-haiku-5-5&lt;/code&gt;、2026年10月7日リリース）は、最大10万トークンまでのプロンプトでHaiku 4.5より90%安価です。入力／出力は100万トークンあたり &lt;code&gt;$0.10 / $0.50&lt;/code&gt;（Haiku 4.5は &lt;code&gt;$1 / $5&lt;/code&gt;）で、コンテキストウィンドウは20万トークンから100万トークンへ拡張されています。一方で、Haiku 4.5では動作していた5つのリクエスト形式がHaiku 5.5では400エラーになり、レスポンス形式やトークン数にもサイレントな変更があります。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;今すぐApidogを試す&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;以下では、移行時に確認すべき破壊的変更、変更前／変更後のJSON、サイレントな仕様変更、&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;でのテスト手順をまとめます。詳細な仕様は&lt;a href="https://apidog.com/jp/blog/what-is-claude-haiku-5-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5とは&lt;/a&gt;、Haiku 4.5の既存実装は&lt;a href="https://apidog.com/jp/blog/claude-haiku-4-5-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 4.5 APIガイド&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  Haiku 4.5 と Haiku 5.5 の比較
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;項目&lt;/th&gt;
&lt;th&gt;Claude Haiku 4.5&lt;/th&gt;
&lt;th&gt;Claude Haiku 5.5&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;モデルID（Claude API）&lt;/td&gt;
&lt;td&gt;&lt;code&gt;claude-haiku-4-5-20251001&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;claude-haiku-5-5&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;コンテキスト／最大出力&lt;/td&gt;
&lt;td&gt;200K / 64K&lt;/td&gt;
&lt;td&gt;1M / 128K&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;入力／出力（MTokあたり）&lt;/td&gt;
&lt;td&gt;$1 / $5&lt;/td&gt;
&lt;td&gt;10万トークンまで $0.10 / $0.50、超過分 $0.50 / $2.50&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;キャッシュ読み取り／5分書き込み（MTokあたり）&lt;/td&gt;
&lt;td&gt;$0.10 / $1.25&lt;/td&gt;
&lt;td&gt;10万トークンまで $0.01 / $0.125、超過分 $0.05 / $0.625&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;バッチ入力／出力（MTokあたり）&lt;/td&gt;
&lt;td&gt;$0.50 / $2.50&lt;/td&gt;
&lt;td&gt;10万トークンまで $0.05 / $0.25、超過分 $0.25 / $1.25&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;思考&lt;/td&gt;
&lt;td&gt;手動 &lt;code&gt;budget_tokens&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;アダプティブのみ、デフォルトでオン&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;努力レベル&lt;/td&gt;
&lt;td&gt;なし&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;low&lt;/code&gt;、&lt;code&gt;medium&lt;/code&gt;（デフォルト）、&lt;code&gt;high&lt;/code&gt;、&lt;code&gt;xhigh&lt;/code&gt;、&lt;code&gt;max&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;最小キャッシュ可能プロンプト&lt;/td&gt;
&lt;td&gt;4,096トークン&lt;/td&gt;
&lt;td&gt;512トークン&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;トークナイザー&lt;/td&gt;
&lt;td&gt;旧版&lt;/td&gt;
&lt;td&gt;同じテキストで約30%多くのトークン&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;非デフォルトのサンプリングパラメータ／プリフィル&lt;/td&gt;
&lt;td&gt;受け入れられる&lt;/td&gt;
&lt;td&gt;400エラー&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;プライオリティティア&lt;/td&gt;
&lt;td&gt;サポート&lt;/td&gt;
&lt;td&gt;非サポート&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;ステータス&lt;/td&gt;
&lt;td&gt;アクティブ、2026年10月15日以前の廃止なし&lt;/td&gt;
&lt;td&gt;アクティブ、2027年10月7日以前の廃止なし&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Haiku 4.5は非推奨ではありません。&lt;a href="https://platform.claude.com/docs/en/about-claude/model-deprecations" rel="noopener noreferrer"&gt;モデルの非推奨ページ&lt;/a&gt;では、廃止日なしのアクティブモデルとして記載されています。両モデルのレート制限も同じです。&lt;/p&gt;

&lt;h2&gt;
  
  
  5つの破壊的変更点
&lt;/h2&gt;

&lt;p&gt;以下は、Haiku 4.5で成功していたリクエストがHaiku 5.5では400エラーになる変更です。移行前に、既存のリクエストボディを検索して該当パラメータを洗い出してください。詳細は&lt;a href="https://platform.claude.com/docs/en/models/haiku-5-5/migration-guide" rel="noopener noreferrer"&gt;Haiku 5.5移行ガイド&lt;/a&gt;を確認してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  1. &lt;code&gt;budget_tokens&lt;/code&gt; による手動思考
&lt;/h3&gt;

&lt;p&gt;Haiku 5.5はアダプティブ思考のみを使用します。&lt;code&gt;thinking.type: "enabled"&lt;/code&gt; と &lt;code&gt;budget_tokens&lt;/code&gt; の組み合わせは使用できません。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json-doc"&gt;&lt;code&gt;&lt;span class="c1"&gt;// 変更前（Haiku 4.5）&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"claude-haiku-4-5-20251001"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"max_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;16000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"thinking"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"enabled"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"budget_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;8000&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"messages"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Classify this ticket."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c1"&gt;// 変更後（Haiku 5.5）&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"claude-haiku-5-5"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"max_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;16000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"thinking"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"adaptive"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"output_config"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"effort"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"medium"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"messages"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Classify this ticket."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;思考量を制御するには、&lt;code&gt;budget_tokens&lt;/code&gt; ではなく &lt;code&gt;output_config.effort&lt;/code&gt; を使います。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;4.5で小さい思考予算を使っていた場合: &lt;code&gt;low&lt;/code&gt; を検討&lt;/li&gt;
&lt;li&gt;標準的な用途: &lt;code&gt;medium&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;より複雑な推論: &lt;code&gt;high&lt;/code&gt;、&lt;code&gt;xhigh&lt;/code&gt;、&lt;code&gt;max&lt;/code&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;code&gt;thinking: { "type": "disabled" }&lt;/code&gt; は送信できますが、努力レベルが &lt;code&gt;high&lt;/code&gt; 以下の場合に限られます。&lt;code&gt;xhigh&lt;/code&gt; または &lt;code&gt;max&lt;/code&gt; と組み合わせると400エラーになります。&lt;/p&gt;

&lt;h3&gt;
  
  
  2. サンプリングパラメータ
&lt;/h3&gt;

&lt;p&gt;Haiku 5.5では、既存の &lt;code&gt;temperature&lt;/code&gt;、&lt;code&gt;top_p&lt;/code&gt;、&lt;code&gt;top_k&lt;/code&gt; 設定がそのまま使えない場合があります。&lt;/p&gt;

&lt;p&gt;削除対象:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;temperature&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;top_p&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;top_k&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;許可される値は &lt;code&gt;temperature: 1&lt;/code&gt; または &lt;code&gt;top_p: 0.99&lt;/code&gt; のみです。ただし、&lt;code&gt;temperature&lt;/code&gt; と &lt;code&gt;top_p&lt;/code&gt; を同時に送ることはできません。&lt;code&gt;top_p: 1&lt;/code&gt;、任意の &lt;code&gt;top_k&lt;/code&gt;、その他の値は400エラーになります。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json-doc"&gt;&lt;code&gt;&lt;span class="c1"&gt;// 変更前（Haiku 4.5）&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"claude-haiku-4-5-20251001"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"max_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;1024&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"temperature"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mf"&gt;0.2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"top_k"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;40&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"messages"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Extract the order ID."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c1"&gt;// 変更後（Haiku 5.5）&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"claude-haiku-5-5"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"max_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;1024&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"messages"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Extract the order ID."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;低い温度で出力の一貫性を確保していた場合は、プロンプトで制約を明示します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;注文IDだけを返してください。
説明、前置き、Markdownは含めないでください。
不明な場合は null を返してください。
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  3. アシスタントプリフィル
&lt;/h3&gt;

&lt;p&gt;Haiku 5.5では、最後のメッセージを &lt;code&gt;assistant&lt;/code&gt; ロールにして続きを生成させるプリフィルは使えません。思考を無効化していても拒否されます。&lt;/p&gt;

&lt;p&gt;&lt;code&gt;messages&lt;/code&gt; は &lt;code&gt;user&lt;/code&gt; ターンで終わるように変更してください。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json-doc"&gt;&lt;code&gt;&lt;span class="c1"&gt;// 変更前（Haiku 4.5）&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"claude-haiku-4-5-20251001"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"max_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;1024&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"messages"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Return the sentiment as JSON."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"assistant"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"{&lt;/span&gt;&lt;span class="se"&gt;\"&lt;/span&gt;&lt;span class="s2"&gt;sentiment&lt;/span&gt;&lt;span class="se"&gt;\"&lt;/span&gt;&lt;span class="s2"&gt;: &lt;/span&gt;&lt;span class="se"&gt;\"&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c1"&gt;// 変更後（Haiku 5.5）&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"claude-haiku-5-5"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"max_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;1024&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"system"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Reply with only a JSON object. No preamble."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"messages"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Return the sentiment as JSON."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;厳密な出力形式が必要な場合は、以下を優先してください。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;構造化出力を利用する&lt;/li&gt;
&lt;li&gt;分類結果をenumフィールドを持つツール呼び出しで返す&lt;/li&gt;
&lt;li&gt;システムプロンプトでJSON以外を禁止する&lt;/li&gt;
&lt;li&gt;アプリケーション側でJSON Schema検証を行う&lt;/li&gt;
&lt;/ol&gt;

&lt;h3&gt;
  
  
  4. コンピュータ使用: &lt;code&gt;computer_20250124&lt;/code&gt; から &lt;code&gt;computer_toolset_20260801&lt;/code&gt; へ
&lt;/h3&gt;

&lt;p&gt;Claude APIおよびGoogle Cloudでは、Haiku 5.5のコンピュータ使用は新しいツールセットを使う必要があります。&lt;/p&gt;

&lt;p&gt;以下を変更してください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;computer-use-2025-01-24&lt;/code&gt; ベータヘッダーを削除&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;computer_20250124&lt;/code&gt; を &lt;code&gt;computer_toolset_20260801&lt;/code&gt; に置換&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;fine-grained-tool-streaming-2025-05-14&lt;/code&gt; を送信している場合は削除&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;code&gt;fine-grained-tool-streaming-2025-05-14&lt;/code&gt; は、新ツールセットと同時に使うと400エラーになります。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json-doc"&gt;&lt;code&gt;&lt;span class="c1"&gt;// 変更前（Haiku 4.5）&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;// ヘッダー: anthropic-beta: computer-use-2025-01-24&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"claude-haiku-4-5-20251001"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"max_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;4096&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"tools"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"computer_20250124"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"name"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"computer"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"display_width_px"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;1280&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"display_height_px"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;800&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"messages"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Open the settings page."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c1"&gt;// 変更後（Haiku 5.5）&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;// ベータヘッダーなし&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"claude-haiku-5-5"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"max_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;4096&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"tools"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"computer_toolset_20260801"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"messages"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Open the settings page."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;エージェントループのディスパッチ方法も変更します。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;旧実装: &lt;code&gt;input.action&lt;/code&gt; を参照&lt;/li&gt;
&lt;li&gt;新実装: 各 &lt;code&gt;tool_use&lt;/code&gt; ブロックの &lt;code&gt;name&lt;/code&gt; と &lt;code&gt;toolset_name&lt;/code&gt; を参照&lt;/li&gt;
&lt;li&gt;ツール結果: &lt;code&gt;toolset_name&lt;/code&gt; を結果にエコーバックする&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Haiku 5.5では &lt;code&gt;browser_toolset_20260801&lt;/code&gt; も利用できますが、Haiku 4.5ではサポートされていません。実装例は&lt;a href="https://apidog.com/jp/blog/claude-code-computer-use?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Codeにおけるコンピュータ利用&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  5. 思考ブロックより前の履歴を編集する
&lt;/h3&gt;

&lt;p&gt;Haiku 5.5の思考ブロックは、その思考ブロック以前の入力が完全に同一である場合のみ有効です。&lt;/p&gt;

&lt;p&gt;以下を変更してから、過去の &lt;code&gt;thinking&lt;/code&gt; ブロックを再送信すると400エラーになります。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;system&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;tools&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;思考ブロックより前のメッセージ&lt;/li&gt;
&lt;li&gt;それ以前の会話履歴
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json-doc"&gt;&lt;code&gt;&lt;span class="c1"&gt;// 変更前: 編集されたsystem + 再送信された思考ブロック = 400&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"claude-haiku-5-5"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"max_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;4096&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"system"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"You are a billing agent. Be brief."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"messages"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Why was I charged twice?"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"assistant"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"thinking"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="nl"&gt;"thinking"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="nl"&gt;"signature"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"&amp;lt;from turn 1&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Checking."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Order 4412."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c1"&gt;// 変更後: 過去の履歴を変更せず、新しい指示を最新ターンに追加&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"claude-haiku-5-5"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"max_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;4096&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"system"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"You are a billing agent."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"messages"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Why was I charged twice?"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"assistant"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"thinking"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="nl"&gt;"thinking"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="nl"&gt;"signature"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"&amp;lt;from turn 1&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Checking."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Order 4412. Be brief."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;実装上は、思考ブロックを含む会話履歴を不変データとして扱うのが安全です。指示を更新したい場合は、過去の &lt;code&gt;system&lt;/code&gt; を書き換えず、最新のユーザーメッセージに追加してください。&lt;/p&gt;

&lt;p&gt;2026年8月31日00:00 UTCより前に作成されたアカウントでは、&lt;code&gt;thinking.block_binding.prefix_mismatch_behavior&lt;/code&gt; を設定したリクエストでのみ、このエラーが発生します。&lt;/p&gt;

&lt;h2&gt;
  
  
  エラーを返さないサイレントな変更点
&lt;/h2&gt;

&lt;p&gt;400エラーにならなくても、アプリケーションのパース、監視、コスト計算に影響する変更があります。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;思考フィールドがデフォルトで空になる&lt;/strong&gt;
各 &lt;code&gt;thinking&lt;/code&gt; ブロックは空の &lt;code&gt;thinking&lt;/code&gt; と &lt;code&gt;signature&lt;/code&gt; のみを返します。Haiku 4.5のような要約済み思考をログやUIで利用する場合は、以下を設定します。
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="w"&gt;  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"thinking"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"adaptive"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"display"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"summarized"&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;レスポンスが思考ブロックから始まる場合がある&lt;/strong&gt;
アダプティブ思考は明示的に設定しなくてもオンです。&lt;code&gt;content[0]&lt;/code&gt; をテキストとして扱わず、&lt;code&gt;type === "text"&lt;/code&gt; のブロックを検索してください。
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;text&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;content&lt;/span&gt;
    &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;block&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;block&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;type&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;text&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;block&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;block&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;text&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;""&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;トークン数が約30%増える&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
新しいトークナイザーでは、同じテキストでも約30%多くのトークンとして計上されます。さらに思考トークンも &lt;code&gt;max_tokens&lt;/code&gt; に含まれます。小さい &lt;code&gt;max_tokens&lt;/code&gt; では、テキストを出力する前に &lt;code&gt;stop_reason: "max_tokens"&lt;/code&gt; になる可能性があります。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;強制 &lt;code&gt;tool_choice&lt;/code&gt; は思考をスキップする&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;tool_choice: { "type": "any" }&lt;/code&gt; や名前付きツールは使えますが、レスポンスはツール呼び出しから始まり、&lt;code&gt;thinking&lt;/code&gt; ブロックは返りません。先に推論させたい場合は &lt;code&gt;tool_choice: { "type": "auto" }&lt;/code&gt; を使い、ツールを使う条件をプロンプトで指定してください。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;新しい拒否が発生する場合がある&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Haiku 5.5は &lt;code&gt;cyber&lt;/code&gt;、&lt;code&gt;frontier_llm&lt;/code&gt;、&lt;code&gt;bio&lt;/code&gt;、&lt;code&gt;general_harms&lt;/code&gt; の安全分類器を実行し、&lt;code&gt;stop_reason: "refusal"&lt;/code&gt; を返すことがあります。サーバー側フォールバックはなく、単純な再試行でも通常は同じ結果になります。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;プライオリティティアは利用不可&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Haiku 4.5でプライオリティティアのコミットメントがある場合、Haiku 5.5移行後の容量計画を別途行ってください。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;思考ブロックはアカウントに紐付く&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
思考ブロックは、それを生成したアカウントまたはリンク済みアカウントでのみ利用できます。会話を別アカウントに移行して再生すると、推論の継続性は失われます。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;短いプロンプトでもキャッシュが始まる&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
最小キャッシュ可能プロンプトは4,096トークンから512トークンに下がります。以前は対象外だった短いシステムプロンプトもキャッシュ対象になります。&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  改善された点
&lt;/h2&gt;

&lt;p&gt;以下は、Haiku 5.5を最大努力レベルで実行した場合のAnthropic報告値です。GDPval-AAとAA-BriefcaseはArtificial Analysisによる独自実施です。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;ベンチマーク&lt;/th&gt;
&lt;th&gt;Haiku 4.5&lt;/th&gt;
&lt;th&gt;Haiku 5.5&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;GDPval-AA v2.1（Elo）&lt;/td&gt;
&lt;td&gt;735&lt;/td&gt;
&lt;td&gt;1620&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AA-Briefcase v1.1（Elo）&lt;/td&gt;
&lt;td&gt;614&lt;/td&gt;
&lt;td&gt;1578&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;OSWorld 2.1、offline subset&lt;/td&gt;
&lt;td&gt;15.7%&lt;/td&gt;
&lt;td&gt;72.4%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Humanity’s Last Exam、with tools&lt;/td&gt;
&lt;td&gt;18.7%&lt;/td&gt;
&lt;td&gt;57.4%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Terminal-Bench 4.0&lt;/td&gt;
&lt;td&gt;0.0%&lt;/td&gt;
&lt;td&gt;39.2%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;SWE-bench Multilingual&lt;/td&gt;
&lt;td&gt;67.4%&lt;/td&gt;
&lt;td&gt;83.7%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Chartography、no tools&lt;/td&gt;
&lt;td&gt;6.4%&lt;/td&gt;
&lt;td&gt;46.4%&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Haiku 4.5のTerminal-Bench実行では、固定の63,999トークンの思考予算が使われました。Haiku 5.5はデフォルトの &lt;code&gt;medium&lt;/code&gt; 努力レベルでもGDPval-AAで1277点を記録し、Haiku 4.5を大きく上回っています。&lt;/p&gt;

&lt;p&gt;Box社は、Haiku 4.5よりレイテンシが約半分で、スコアが11ポイント高いと報告しています。ベンチマークの詳細は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-benchmarks?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5ベンチマーク&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;p&gt;Anthropicは、複雑なエージェントコーディングには依然としてSonnet 5.5またはOpus 5.5を推奨しています。Haiku 5.5は、分類、抽出、要約、圧縮、サブエージェント、ブラウザ利用に適したモデルです。&lt;/p&gt;

&lt;p&gt;コスト面では、AnthropicはHaiku 5.5が平均で約75%安価だとしています。これは、10万トークンまで90%安価、超過分は50%安価という料金体系と、新トークナイザーによるトークン増加を加味した数値です。ツール利用時のシステムプロンプトも、&lt;code&gt;auto&lt;/code&gt; ツール選択では496トークンから286トークンに縮小されています。料金例は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5の価格設定&lt;/a&gt;を確認してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  Apidogで移行をテストする
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;で、&lt;code&gt;https://api.anthropic.com/v1/messages&lt;/code&gt; に対する3つの保存済みリクエストを含むプロジェクトを作成します。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F83lglszsqzyiqxectqjv.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F83lglszsqzyiqxectqjv.png" alt="ApidogでClaude APIリクエストをテストする画面" width="799" height="530"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  1. ベースラインリクエストを作成する
&lt;/h3&gt;

&lt;p&gt;現在のHaiku 4.5リクエストを保存します。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;モデル: &lt;code&gt;claude-haiku-4-5-20251001&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;期待ステータス: &lt;code&gt;200&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;現行のレスポンス形式と &lt;code&gt;usage.input_tokens&lt;/code&gt; を記録&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  2. モデルIDだけを変更した失敗ケースを作成する
&lt;/h3&gt;

&lt;p&gt;ベースラインを複製し、&lt;code&gt;model&lt;/code&gt; だけを &lt;code&gt;claude-haiku-5-5&lt;/code&gt; に変更します。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;期待ステータス: &lt;code&gt;400&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;&lt;code&gt;budget_tokens&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;サンプリングパラメータ&lt;/li&gt;
&lt;li&gt;アシスタントプリフィル&lt;/li&gt;
&lt;li&gt;古いコンピュータツール&lt;/li&gt;
&lt;li&gt;思考ブロック前の履歴変更&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;破壊的変更ごとにリクエストをコピーして保存すると、チーム内レビューで原因を確認しやすくなります。&lt;/p&gt;

&lt;h3&gt;
  
  
  3. 移行済みリクエストを作成する
&lt;/h3&gt;

&lt;p&gt;修正後のボディを保存し、以下を検証します。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;ステータスコードが &lt;code&gt;200&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;stop_reason&lt;/code&gt; が &lt;code&gt;refusal&lt;/code&gt; ではない&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;stop_reason&lt;/code&gt; が &lt;code&gt;max_tokens&lt;/code&gt; ではない&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;content&lt;/code&gt; 配列内に &lt;code&gt;type: "text"&lt;/code&gt; のブロックがある&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;環境変数には &lt;code&gt;ANTHROPIC_API_KEY&lt;/code&gt; を保存し、ヘッダーで参照します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight http"&gt;&lt;code&gt;&lt;span class="err"&gt;x-api-key: {{ANTHROPIC_API_KEY}}
anthropic-version: 2023-06-01
content-type: application/json
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;ベースラインと移行済みリクエストの &lt;code&gt;usage.input_tokens&lt;/code&gt; を比較し、実際のプロンプトにおけるトークナイザー差分を確認してください。&lt;/p&gt;

&lt;p&gt;この3リクエストをテストシナリオとして保存すれば、誰かが &lt;code&gt;temperature&lt;/code&gt; や &lt;code&gt;top_k&lt;/code&gt; を再導入した場合でも、本番前のテストで検出できます。リクエストの基本構成は&lt;a href="https://apidog.com/jp/blog/how-to-use-claude-haiku-5-5-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5 APIの使い方&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;p&gt;Claude Codeを使っている場合は、次のコマンドで移行支援を実行できます。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;/claude-api migrate this project to claude-haiku-5-5
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;モデルIDの置換、パラメータ修正、チェックリストが表示されます。なお、&lt;code&gt;haiku&lt;/code&gt; エイリアスがHaiku 5.5へ解決されるのはAnthropic APIのみです。詳細は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude CodeにおけるClaude Haiku 5.5&lt;/a&gt;を確認してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  よくある質問
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Claude Haiku 4.5は非推奨ですか？
&lt;/h3&gt;

&lt;p&gt;いいえ。非推奨日は設定されておらず、アクティブなモデルです。2026年10月15日以前に廃止される予定はありません。&lt;/p&gt;

&lt;h3&gt;
  
  
  Haiku 4.5のリクエストがHaiku 5.5で400エラーになるのはなぜですか？
&lt;/h3&gt;

&lt;p&gt;以下を確認してください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;budget_tokens&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;temperature&lt;/code&gt;、&lt;code&gt;top_p&lt;/code&gt;、&lt;code&gt;top_k&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;アシスタントプリフィル&lt;/li&gt;
&lt;li&gt;&lt;code&gt;computer_20250124&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;思考ブロックより前の会話履歴、&lt;code&gt;system&lt;/code&gt;、&lt;code&gt;tools&lt;/code&gt; の変更&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;これらがHaiku 5.5への移行で問題になる5つの破壊的変更です。&lt;/p&gt;

&lt;h3&gt;
  
  
  長いプロンプトではHaiku 5.5の方が安いですか？
&lt;/h3&gt;

&lt;p&gt;はい。10万トークンを超える場合でも、Haiku 5.5は100万トークンあたり入力 &lt;code&gt;$0.50&lt;/code&gt;、出力 &lt;code&gt;$2.50&lt;/code&gt; で、Haiku 4.5の &lt;code&gt;$1 / $5&lt;/code&gt; の半額です。さらにHaiku 4.5は20万トークンを超えるプロンプトを処理できません。&lt;/p&gt;

&lt;h3&gt;
  
  
  すべてのワークロードをHaiku 5.5に切り替えるべきですか？
&lt;/h3&gt;

&lt;p&gt;分類、抽出、要約、サブエージェント用途では、まず実際のプロンプトとデータで評価してから移行してください。競合モデルとの比較は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-vs-gpt-6-luna?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 vs GPT-6 Luna&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  次のステップ
&lt;/h2&gt;

&lt;p&gt;Haiku 4.5の実リクエストを複製し、Haiku 5.5用にモデルIDだけを変更して400エラーを確認します。次に、各エラーを1つずつ修正し、移行済みリクエストが安定して通過してからトラフィックを切り替えてください。&lt;/p&gt;

&lt;p&gt;テスト用のリクエストペアを作成するには、&lt;a href="https://apidog.com/download?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidogをダウンロード&lt;/a&gt;してください。&lt;/p&gt;

</description>
    </item>
    <item>
      <title>クロード ハイク 5.5 料金</title>
      <dc:creator>Akira</dc:creator>
      <pubDate>Thu, 08 Oct 2026 04:12:32 +0000</pubDate>
      <link>https://dev.to/aakira/kurodo-haiku-55-liao-jin-4152</link>
      <guid>https://dev.to/aakira/kurodo-haiku-55-liao-jin-4152</guid>
      <description>&lt;p&gt;Claude Haiku 5.5は、10万トークンまでのプロンプトでは、入力トークン100万あたり0.10ドル、出力トークン100万あたり0.50ドルです。10万トークンを超えるプロンプトでは、入力0.50ドル、出力2.50ドルに上がります。キャッシュ読み取りは0.01ドルから、Batch APIではすべてのレートが半額です。Anthropicは、Haiku 4.5と比べて平均で約75%低いコストで実行できると述べています。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;Apidogを今すぐ試す&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;この記事では、料金表、約75%安の計算根拠、10万トークン超を含む3つの実行パターン、努力レベル別のコスト、Haiku 4.5・GPT-6 Luna・Sonnet 5.5との比較を解説します。モデルを初めて使う場合は、まず&lt;a href="https://apidog.com/jp/blog/what-is-claude-haiku-5-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5とは&lt;/a&gt;を確認してください。実トラフィックでコストを検証するには、&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;からリクエストを送信し、レスポンス内の&lt;code&gt;usage&lt;/code&gt;ブロックを読み取ります。&lt;/p&gt;

&lt;h2&gt;
  
  
  Claude Haiku 5.5 API料金表
&lt;/h2&gt;

&lt;p&gt;Anthropicの&lt;a href="https://platform.claude.com/docs/en/about-claude/pricing" rel="noopener noreferrer"&gt;料金ドキュメント&lt;/a&gt;に基づく、100万トークン（MTok）あたりの料金です。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;項目&lt;/th&gt;
&lt;th&gt;10万トークンまでのプロンプト&lt;/th&gt;
&lt;th&gt;10万トークンを超えるプロンプト&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;入力&lt;/td&gt;
&lt;td&gt;$0.10&lt;/td&gt;
&lt;td&gt;$0.50&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;出力&lt;/td&gt;
&lt;td&gt;$0.50&lt;/td&gt;
&lt;td&gt;$2.50&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;5分間キャッシュ書き込み&lt;/td&gt;
&lt;td&gt;$0.125&lt;/td&gt;
&lt;td&gt;$0.625&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;1時間キャッシュ書き込み&lt;/td&gt;
&lt;td&gt;$0.20&lt;/td&gt;
&lt;td&gt;$1.00&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;キャッシュ読み取り（ヒットおよび更新）&lt;/td&gt;
&lt;td&gt;$0.01&lt;/td&gt;
&lt;td&gt;$0.05&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;バッチ入力&lt;/td&gt;
&lt;td&gt;$0.05&lt;/td&gt;
&lt;td&gt;$0.25&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;バッチ出力&lt;/td&gt;
&lt;td&gt;$0.25&lt;/td&gt;
&lt;td&gt;$1.25&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;料金を計算する際は、次の点を確認してください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;10万トークン超のしきい値&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Haiku 5.5では、プロンプトが10万トークンを超えると高いレートが適用されます。他のClaudeモデル（4.6以降）が100万トークンのウィンドウ全体を単一レートで請求するのに対し、Haiku 5.5は例外です。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;米国限定の推論&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;inference_geo&lt;/code&gt;による米国限定ルーティングは、Claude APIおよびAWS上のClaude Platformで、すべてのトークンカテゴリに1.1倍の料金が適用されます。10万トークン未満では、入力0.11ドル、出力0.55ドルです。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;新しいトークナイザー&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
同じテキストでも、Haiku 4.5より約30%多くのトークンを生成します。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;ツール利用時のオーバーヘッド削減&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
ツール利用のシステムプロンプトは286トークン（自動/なし）で、Haiku 4.5の496トークンから減少しています。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Priority Tierと高速モードはなし&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Haiku 5.5では利用できません。&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  「約75%安」の根拠
&lt;/h2&gt;

&lt;p&gt;Haiku 5.5は、10万トークンまではHaiku 4.5より90%安く、10万トークン超では50%安く設定されています。Anthropicによると、Haiku 4.5のリクエストの90%は10万トークン未満でした。さらに、この比較には新しいトークナイザーによるトークン数増加も考慮されています。&lt;/p&gt;

&lt;p&gt;概算は次のとおりです。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;リクエスト数で重み付けします。&lt;br&gt;&lt;br&gt;
&lt;code&gt;0.9 × 90% + 0.1 × 50% = 86%削減&lt;/code&gt;&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;新しいトークナイザーによる約30%のトークン増加を加味します。&lt;br&gt;&lt;br&gt;
残り14%のコストは、&lt;code&gt;14% × 1.3 = 18.2%&lt;/code&gt; です。&lt;br&gt;&lt;br&gt;
したがって、削減率は約82%まで下がります。&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fnfm621dniwofqnzrqzii.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fnfm621dniwofqnzrqzii.png" alt="Haiku 5.5のコスト比較" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Anthropicの約75%という数値は、より保守的な平均値として扱うべきです。公開されていない重み付けでは、長いプロンプトがリクエスト数以上に支出を占めている可能性があります。最終的には、自分の&lt;code&gt;usage&lt;/code&gt;データで確認してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  各努力レベルでの試行あたりのコスト
&lt;/h2&gt;

&lt;p&gt;Haiku 5.5は、努力レベル（&lt;code&gt;low&lt;/code&gt;〜&lt;code&gt;max&lt;/code&gt;、APIデフォルトは&lt;code&gt;medium&lt;/code&gt;）を導入した最初のHaikuモデルです。実際の請求額は、料金表だけでなく努力レベルにも大きく左右されます。&lt;/p&gt;

&lt;p&gt;以下の数値は、ローンチ投稿の努力レベル別グラフからのものです。AnthropicはOSWorldとTerminal-Benchを実行し、Artificial AnalysisはGDPval-AAを実行しました。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;努力レベル&lt;/th&gt;
&lt;th&gt;OSWorld 2.1（スコア、1試行あたりドル）&lt;/th&gt;
&lt;th&gt;GDPval-AA v2.1（Elo、1タスクあたりドル）&lt;/th&gt;
&lt;th&gt;Terminal-Bench 4.0（スコア、1試行あたりドル）&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;低&lt;/td&gt;
&lt;td&gt;42.0%, $0.0695&lt;/td&gt;
&lt;td&gt;1125, $0.0117&lt;/td&gt;
&lt;td&gt;12.7%, $0.424&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;中&lt;/td&gt;
&lt;td&gt;53.3%, $0.1257&lt;/td&gt;
&lt;td&gt;1277, $0.0304&lt;/td&gt;
&lt;td&gt;20.3%, $0.6798&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;高&lt;/td&gt;
&lt;td&gt;61.3%, $0.1827&lt;/td&gt;
&lt;td&gt;1420, $0.0894&lt;/td&gt;
&lt;td&gt;24.8%, $1.0372&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;極高&lt;/td&gt;
&lt;td&gt;67.6%, $0.2792&lt;/td&gt;
&lt;td&gt;1513, $0.2673&lt;/td&gt;
&lt;td&gt;31.5%, $1.7545&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;最大&lt;/td&gt;
&lt;td&gt;72.4%, $0.6111&lt;/td&gt;
&lt;td&gt;1620, $0.8659&lt;/td&gt;
&lt;td&gt;39.2%, $2.6433&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;実装時は、次の点をコスト設計に反映してください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;OSWorldでは&lt;code&gt;max&lt;/code&gt;が&lt;code&gt;medium&lt;/code&gt;の4.9倍のコスト&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;$0.6111 ÷ $0.1257&lt;/code&gt;&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;GDPval-AAでは&lt;code&gt;max&lt;/code&gt;が&lt;code&gt;medium&lt;/code&gt;の28.5倍のコスト&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;$0.86593 ÷ $0.03042&lt;/code&gt;&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;ローンチ表のスコアは&lt;code&gt;max&lt;/code&gt;のもの&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
APIデフォルトの&lt;code&gt;medium&lt;/code&gt;では、GDPval-AAのEloは1620ではなく1277です。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;エージェントコーディングではSonnetも比較する&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Terminal-Benchでは、Sonnet 5.5の&lt;code&gt;low&lt;/code&gt;はスコア20%、コスト0.6205ドルでした。一方、Haiku 5.5の&lt;code&gt;medium&lt;/code&gt;はスコア20.3%、コスト0.6798ドルです。Anthropicは、複雑なエージェントコーディングタスクにはSonnetとOpusの方が適していると述べています。詳細な数値は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-benchmarks?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;ベンチマーク詳細&lt;/a&gt;で確認できます。&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Haiku 5.5の価格比較
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;モデル&lt;/th&gt;
&lt;th&gt;100万トークンあたりの入力/出力&lt;/th&gt;
&lt;th&gt;キャッシュ読み取り&lt;/th&gt;
&lt;th&gt;5分キャッシュ書き込み&lt;/th&gt;
&lt;th&gt;長文プロンプトルール&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Claude Haiku 5.5&lt;/td&gt;
&lt;td&gt;10万トークンまで $0.10 / $0.50&lt;/td&gt;
&lt;td&gt;$0.01&lt;/td&gt;
&lt;td&gt;$0.125&lt;/td&gt;
&lt;td&gt;10万トークン超: $0.50 / $2.50&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;GPT-6 Luna&lt;/td&gt;
&lt;td&gt;$0.10 / $0.50&lt;/td&gt;
&lt;td&gt;$0.01&lt;/td&gt;
&lt;td&gt;$0.125&lt;/td&gt;
&lt;td&gt;27.2万入力トークン超: 入力とキャッシュが2倍、出力が1.5倍（$0.20 / $0.75）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Claude Haiku 4.5&lt;/td&gt;
&lt;td&gt;$1 / $5&lt;/td&gt;
&lt;td&gt;$0.10&lt;/td&gt;
&lt;td&gt;$1.25&lt;/td&gt;
&lt;td&gt;単一レート（20万コンテキスト）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Claude Sonnet 5.5&lt;/td&gt;
&lt;td&gt;$2 / $10&lt;/td&gt;
&lt;td&gt;$0.10&lt;/td&gt;
&lt;td&gt;$2.50&lt;/td&gt;
&lt;td&gt;100万トークン全体で単一レート&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h3&gt;
  
  
  GPT-6 Lunaとの比較
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;GPT-6 Luna&lt;/strong&gt;は、10万トークンまではHaiku 5.5と同額ですが、追加料金が始まるしきい値が異なります。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://developers.openai.com/api/docs/models/gpt-6-luna" rel="noopener noreferrer"&gt;OpenAIのモデルページ&lt;/a&gt;によると、Lunaの追加料金は27.2万トークンを超えると適用され、リクエスト全体に課金されます。&lt;/p&gt;

&lt;p&gt;たとえば、入力15万トークン、出力2,000トークンのリクエストでは、Lunaは基本料金内です。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;(150,000 × $0.10 + 2,000 × $0.50) ÷ 1,000,000 = $0.016
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;この場合、Haiku 5.5の0.08ドルよりLunaの方が安価です。&lt;/p&gt;

&lt;p&gt;ただし、トークナイザーも異なります。Hacker Newsのコメント投稿者は、Claudeの10万トークンがGPTでは約6万〜6万5千トークンに相当すると推定しています。AnthropicのOSWorldチャートでは、Haiku 5.5の&lt;code&gt;medium&lt;/code&gt;は53.3%、0.1257ドルで、Lunaの&lt;code&gt;max&lt;/code&gt;である48.9%、0.205ドルを上回りました。&lt;/p&gt;

&lt;p&gt;詳しくは&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-vs-gpt-6-luna?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5 vs GPT-6 Luna&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  Sonnet 5.5との比較
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Sonnet 5.5&lt;/strong&gt;は同日、キャッシュ読み取り料金を0.20ドルから0.10ドルへ引き下げました。Anthropicによると、ほとんどのエージェント作業で約20%安くなっています。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/jp/blog/claude-sonnet-5-5-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Sonnet 5.5料金ガイド&lt;/a&gt;は、この値下げ前の情報です。&lt;/p&gt;

&lt;h3&gt;
  
  
  Haiku 4.5との比較
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Haiku 4.5&lt;/strong&gt;は非推奨ではありません。移行前に確認すべき破壊的変更については、&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-vs-haiku-4-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 vs Haiku 4.5&lt;/a&gt;を確認してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  APIクレジットとコンシューマープラン
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Max・TeamのAPIクレジット
&lt;/h3&gt;

&lt;p&gt;Max 5xには月額100ドル、Max 20xには月額200ドルのClaude Platformクレジットが付与されます。Teamでは、Standardシートあたり20ドル、Premiumシートあたり100ドルが付与され、合計上限は500ドルです。&lt;/p&gt;

&lt;p&gt;Free、Pro、Enterpriseは対象外です。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://platform.claude.com/docs/en/about-claude/api-credits-for-subscribers" rel="noopener noreferrer"&gt;APIクレジットのドキュメント&lt;/a&gt;によると、これらはClaude API向けであり、Claude Codeやクラウドでは使えません。また、未使用分の繰り越しはできません。&lt;/p&gt;

&lt;p&gt;入力100万トークンあたり0.10ドルで計算すると、100ドルで10億入力トークン、または例1のようなリクエストを約22万回購入できます。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;$100 ÷ $0.000455 = 約22万回
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  コンシューマープラン
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://claude.com/pricing" rel="noopener noreferrer"&gt;claude.com/pricing&lt;/a&gt;によると、Free、Pro、Max、Team、Enterpriseユーザーは、Web、iOS、Androidの&lt;a href="http://Claude.ai" rel="noopener noreferrer"&gt;Claude.ai&lt;/a&gt;でHaiku 5.5を選択できます。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Free: 0ドル&lt;/li&gt;
&lt;li&gt;Pro: 年間契約で月額17ドル、月額契約で20ドル&lt;/li&gt;
&lt;li&gt;Max: 月額100ドルから&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;FreeプランにはClaude Codeがありません。また、チャットプランでスクリプトやCIジョブを実行することはできません。&lt;/p&gt;

&lt;p&gt;詳細は&lt;a href="https://apidog.com/jp/blog/how-to-use-claude-haiku-5-5-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5を無料で使う方法&lt;/a&gt;を確認してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  クラウド経由の利用
&lt;/h3&gt;

&lt;p&gt;Bedrock、Google Cloud、Foundryでは、それぞれ独自の料金ページを通じてHaiku 5.5の料金が請求されます。&lt;/p&gt;

&lt;h2&gt;
  
  
  Apidogでリクエストごとのコストを追跡する
&lt;/h2&gt;

&lt;p&gt;すべてのMessagesレスポンスは&lt;code&gt;usage&lt;/code&gt;オブジェクトを返します。この値があれば、&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;で呼び出しごとの価格を計算できます。&lt;/p&gt;

&lt;h3&gt;
  
  
  1. APIキーを環境変数に保存する
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;export &lt;/span&gt;&lt;span class="nv"&gt;ANTHROPIC_API_KEY&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"your_api_key"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  2. 努力レベルごとのリクエストを作成する
&lt;/h3&gt;

&lt;p&gt;同じプロンプトで、&lt;code&gt;low&lt;/code&gt;、&lt;code&gt;medium&lt;/code&gt;、&lt;code&gt;high&lt;/code&gt;のリクエストをそれぞれ保存します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl https://api.anthropic.com/v1/messages &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"x-api-key: &lt;/span&gt;&lt;span class="nv"&gt;$ANTHROPIC_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"anthropic-version: 2023-06-01"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"content-type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "claude-haiku-5-5",
    "max_tokens": 4000,
    "thinking": {"type": "adaptive"},
    "output_config": {"effort": "medium"},
    "messages": [{"role": "user", "content": "Classify this support ticket: ..."}]
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  3. レスポンス後にコストを計算する
&lt;/h3&gt;

&lt;p&gt;Apidogのポストプロセッサに次のスクリプトを追加します。この例では、&lt;code&gt;input_tokens&lt;/code&gt;をプロンプト長として扱い、キャッシュなしの料金を計算します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;body&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;u&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;body&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;long&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;u&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;input_tokens&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;100000&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;rateIn&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;long&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="mf"&gt;0.50&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;0.10&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;rateOut&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;long&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="mf"&gt;2.50&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;0.50&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;cost&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;u&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;input_tokens&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;rateIn&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;u&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;output_tokens&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;rateOut&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="nx"&gt;e6&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="nx"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;environment&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;set&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;haiku_call_usd&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;cost&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toFixed&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;

&lt;span class="nx"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;not a refusal&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;body&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;stop_reason&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;to&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;not&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;eql&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;refusal&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  4. 結果を比較する
&lt;/h3&gt;

&lt;p&gt;3つの努力レベルを実行し、少なくとも次の項目を並べて比較します。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;比較項目&lt;/th&gt;
&lt;th&gt;確認する値&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;入力トークン数&lt;/td&gt;
&lt;td&gt;&lt;code&gt;usage.input_tokens&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;出力トークン数&lt;/td&gt;
&lt;td&gt;&lt;code&gt;usage.output_tokens&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;停止理由&lt;/td&gt;
&lt;td&gt;&lt;code&gt;stop_reason&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;呼び出しコスト&lt;/td&gt;
&lt;td&gt;&lt;code&gt;haiku_call_usd&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;努力レベル&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;low&lt;/code&gt; / &lt;code&gt;medium&lt;/code&gt; / &lt;code&gt;high&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Haiku 5.5のセーフティ分類器にはサーバーサイドのフォールバックがないため、拒否チェックは重要です。詳細な手順は&lt;a href="https://apidog.com/jp/blog/how-to-use-claude-haiku-5-5-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5 APIの使用方法&lt;/a&gt;に記載されています。&lt;/p&gt;

&lt;h2&gt;
  
  
  よくある質問
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Claude Haiku 5.5の100万トークンあたりのコストはいくらですか？
&lt;/h3&gt;

&lt;p&gt;10万トークンまでのプロンプトでは、入力0.10ドル、出力0.50ドルです。それ以上では、入力0.50ドル、出力2.50ドルです。&lt;/p&gt;

&lt;h3&gt;
  
  
  Haiku 5.5はHaiku 4.5よりも安いですか？
&lt;/h3&gt;

&lt;p&gt;はい。10万トークンまではトークンあたり90%安く、10万トークン超では50%安くなります。Anthropicによる平均コスト差は約75%です。&lt;/p&gt;

&lt;h3&gt;
  
  
  Haiku 5.5の価格はGPT-6 Lunaと同じですか？
&lt;/h3&gt;

&lt;p&gt;10万トークンまでは同じです。ただし、Haiku 5.5は10万トークン超で5倍に上がる一方、Lunaは27.2万トークンまで変動しません。詳細は&lt;a href="https://apidog.com/jp/blog/what-is-gpt-6-luna?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;GPT-6 Luna概要&lt;/a&gt;を確認してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  MaxプランのクレジットはClaude Codeで利用できますか？
&lt;/h3&gt;

&lt;p&gt;いいえ。これらのクレジットはClaude Platform API向けであり、Claude Codeは対象外です。Claude Codeでのプランアクセスについては、&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude CodeでのClaude Haiku 5.5&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  次のステップ：自身のワークロードの価格を計算する
&lt;/h2&gt;

&lt;p&gt;まず、最も一般的な3つのリクエストパターンを抽出します。次に、何件が10万トークンを超えるかを確認し、それぞれを&lt;code&gt;low&lt;/code&gt;と&lt;code&gt;medium&lt;/code&gt;の努力レベルで実行してください。&lt;/p&gt;

&lt;p&gt;最後に、&lt;code&gt;usage&lt;/code&gt;の数値へ料金表の単価を掛けて、実際の節約額を計算します。リクエストとコスト計算スクリプトを1つのプロジェクトで管理するには、&lt;a href="https://apidog.com/download?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidogをダウンロード&lt;/a&gt;してください。&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Claude Haiku 5.5 API の使い方</title>
      <dc:creator>Akira</dc:creator>
      <pubDate>Thu, 08 Oct 2026 04:08:51 +0000</pubDate>
      <link>https://dev.to/aakira/claude-haiku-55-api-noshi-ifang-16d2</link>
      <guid>https://dev.to/aakira/claude-haiku-55-api-noshi-ifang-16d2</guid>
      <description>&lt;p&gt;Claude Haiku 5.5 APIを使うには、&lt;code&gt;https://api.anthropic.com/v1/messages&lt;/code&gt; に対して、&lt;code&gt;"model": "claude-haiku-5-5"&lt;/code&gt;、&lt;code&gt;x-api-key&lt;/code&gt; ヘッダー、&lt;code&gt;anthropic-version: 2023-06-01&lt;/code&gt; を含むPOSTリクエストを送信します。プロンプトが10万トークンまでの場合、料金は入出力トークン100万あたり &lt;code&gt;$0.10/$0.50&lt;/code&gt;（それ以上は &lt;code&gt;$0.50/$2.50&lt;/code&gt;）です。最大100万トークンのコンテキストを読み取り、最大12万8千トークンを書き込みます。適応的思考が有効な &lt;code&gt;medium&lt;/code&gt; エフォートがデフォルトです。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;今すぐApidogを試す&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;Anthropicは2026年10月7日にHaiku 5.5をリリースしました。これはエフォートレベルを持つ最初のHaikuです（&lt;a href="https://apidog.com/jp/blog/what-is-claude-haiku-5-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5とは&lt;/a&gt;で仕様と位置付けを解説しています）。この記事では、curl、Python、TypeScriptでの最初の呼び出しに加え、エフォート、思考、キャッシング、バッチ、拒否、エージェントツールセットを実装ベースで説明します。以下のリクエストはすべて&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;に保存し、アサートできます。&lt;/p&gt;

&lt;h2&gt;
  
  
  Claude Haiku 5.5 API の概要
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;パラメータ&lt;/th&gt;
&lt;th&gt;Haiku 5.5 の動作&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;モデルID&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;claude-haiku-5-5&lt;/code&gt;（Bedrock: &lt;code&gt;anthropic.claude-haiku-5-5&lt;/code&gt;）。別エイリアスなし&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;MTokあたりの価格（10万トークンまでのプロンプト）&lt;/td&gt;
&lt;td&gt;入力 &lt;code&gt;$0.10&lt;/code&gt;、出力 &lt;code&gt;$0.50&lt;/code&gt;、キャッシュ読み取り &lt;code&gt;$0.01&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;MTokあたりの価格（10万トークンを超えるプロンプト）&lt;/td&gt;
&lt;td&gt;入力 &lt;code&gt;$0.50&lt;/code&gt;、出力 &lt;code&gt;$2.50&lt;/code&gt;、キャッシュ読み取り &lt;code&gt;$0.05&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;コンテキスト / 最大出力&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;1M / 128K&lt;/code&gt;。&lt;code&gt;output-300k-2026-03-24&lt;/code&gt; ベータヘッダーを使うバッチでは &lt;code&gt;300K&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;output_config.effort&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;low&lt;/code&gt;、&lt;code&gt;medium&lt;/code&gt;（デフォルト）、&lt;code&gt;high&lt;/code&gt;、&lt;code&gt;xhigh&lt;/code&gt;、&lt;code&gt;max&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;thinking&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;デフォルトで &lt;code&gt;adaptive&lt;/code&gt;。&lt;code&gt;disabled&lt;/code&gt; は &lt;code&gt;high&lt;/code&gt; エフォート以下のみ&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;thinking.display&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;デフォルトでは &lt;code&gt;thinking&lt;/code&gt; フィールドは空。&lt;code&gt;summarized&lt;/code&gt; は読みやすいテキストを返す&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;temperature&lt;/code&gt;、&lt;code&gt;top_p&lt;/code&gt;、&lt;code&gt;top_k&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;非デフォルト値は400を返す&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;アシスタントプリフィル&lt;/td&gt;
&lt;td&gt;思考がオフでも400を返す&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;キャッシュ可能な最小プロンプト&lt;/td&gt;
&lt;td&gt;512トークン（Haiku 4.5では4,096）&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;出典: &lt;a href="https://platform.claude.com/docs/en/models/haiku-5-5/overview" rel="noopener noreferrer"&gt;Haiku 5.5 モデルページ&lt;/a&gt; および &lt;a href="https://platform.claude.com/docs/en/about-claude/pricing" rel="noopener noreferrer"&gt;Claude API 料金ドキュメント&lt;/a&gt;。&lt;/p&gt;

&lt;h2&gt;
  
  
  Claude Haiku 5.5 API の最初の呼び出し
&lt;/h2&gt;

&lt;p&gt;Claude Consoleでキーを作成し、&lt;code&gt;ANTHROPIC_API_KEY&lt;/code&gt; として環境変数に設定します。&lt;a href="https://apidog.com/jp/blog/anthropic-api-key?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Anthropic API キーガイド&lt;/a&gt;も参照してください。キーをソースコードへ直接貼り付けないでください。&lt;/p&gt;

&lt;h3&gt;
  
  
  curl
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl https://api.anthropic.com/v1/messages &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"x-api-key: &lt;/span&gt;&lt;span class="nv"&gt;$ANTHROPIC_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"anthropic-version: 2023-06-01"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"content-type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "claude-haiku-5-5",
    "max_tokens": 4096,
    "output_config": {"effort": "medium"},
    "thinking": {"type": "adaptive", "display": "summarized"},
    "messages": [{
      "role": "user",
      "content": "Classify this ticket as billing, bug, or feature request: The export button times out on large projects."
    }]
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Python
&lt;/h3&gt;

&lt;p&gt;Python SDKは環境変数 &lt;code&gt;ANTHROPIC_API_KEY&lt;/code&gt; を自動的に取得します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;anthropic&lt;/span&gt;

&lt;span class="n"&gt;client&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;anthropic&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Anthropic&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;

&lt;span class="n"&gt;response&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;claude-haiku-5-5&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;max_tokens&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;4096&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;output_config&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;effort&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;medium&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="n"&gt;thinking&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;adaptive&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;display&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;summarized&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;[{&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;role&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;user&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;content&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Classify this ticket as billing, bug, or feature request: The export button times out on large projects.&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
    &lt;span class="p"&gt;}],&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;block&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;block&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nb"&gt;type&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;thinking&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;[thinking]&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;block&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;thinking&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;elif&lt;/span&gt; &lt;span class="n"&gt;block&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nb"&gt;type&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;block&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;stop_reason&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  TypeScript
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;Anthropic&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@anthropic-ai/sdk&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;client&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Anthropic&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;response&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
  &lt;span class="na"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;claude-haiku-5-5&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;max_tokens&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;4096&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;output_config&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;effort&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;medium&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="na"&gt;thinking&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;adaptive&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;display&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;summarized&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="na"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="na"&gt;role&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;user&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="na"&gt;content&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;Classify this ticket as billing, bug, or feature request: The export button times out on large projects.&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;],&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;

&lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;block&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;content&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;block&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;text&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;block&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;text&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;stop_reason&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;実装時は次の3点を守ってください。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;response.content[0].text&lt;/code&gt; を前提にしない&lt;br&gt;&lt;br&gt;
応答が &lt;code&gt;thinking&lt;/code&gt; ブロックから始まることがあります。必ず &lt;code&gt;block.type&lt;/code&gt; で分岐してテキストを取り出します。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;max_tokens&lt;/code&gt; に思考トークンの余裕を含める&lt;br&gt;&lt;br&gt;
思考トークンも &lt;code&gt;max_tokens&lt;/code&gt; にカウントされます。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;サポート外パラメータを送らない&lt;br&gt;&lt;br&gt;
&lt;code&gt;temperature&lt;/code&gt;、&lt;code&gt;top_p&lt;/code&gt;、&lt;code&gt;top_k&lt;/code&gt;、&lt;code&gt;budget_tokens&lt;/code&gt;、アシスタントプリフィルは、このモデルでは400エラーになります。&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Haiku 4.5から移行する場合は、&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-vs-haiku-4-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 vs Haiku 4.5 ガイド&lt;/a&gt;で変更前後のJSONと破壊的変更を確認してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  エフォートレベルを選択する
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;output_config.effort&lt;/code&gt; は、品質、レイテンシ、コストを調整する主要な設定です。&lt;a href="https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5" rel="noopener noreferrer"&gt;プロンプティングガイド&lt;/a&gt;では、次の使い分けが示されています。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;low&lt;/code&gt;: 最も安価で高速。チャット、短いツールタスク、単純な大量リクエスト向け。&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;medium&lt;/code&gt;: デフォルト。エージェントコーディングを含む大半の用途はここから開始。&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;high&lt;/code&gt;: ナレッジワーク、長いエージェントタスク、厳密な指示遵守向け。&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;xhigh&lt;/code&gt; / &lt;code&gt;max&lt;/code&gt;: 評価で改善が確認できる場合にのみ利用。AnthropicはSonnet 5.5でも同じ評価を実行して比較することを推奨しています。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;AnthropicのローンチチャートにあるOSWorld 2.1（オフラインサブセット）の結果は以下のとおりです。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;エフォート&lt;/th&gt;
&lt;th&gt;スコア&lt;/th&gt;
&lt;th&gt;試行あたりのコスト&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;low&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;42.0%&lt;/td&gt;
&lt;td&gt;&lt;code&gt;$0.0695&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;medium&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;53.3%&lt;/td&gt;
&lt;td&gt;&lt;code&gt;$0.1257&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;high&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;61.3%&lt;/td&gt;
&lt;td&gt;&lt;code&gt;$0.1827&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;xhigh&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;67.6%&lt;/td&gt;
&lt;td&gt;&lt;code&gt;$0.2792&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;max&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;72.4%&lt;/td&gt;
&lt;td&gt;&lt;code&gt;$0.6111&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;code&gt;xhigh&lt;/code&gt; から &lt;code&gt;max&lt;/code&gt; に上げると、5点未満のスコア向上に対してコストは2倍以上になります。まずは実際のプロンプトで &lt;code&gt;low&lt;/code&gt;、&lt;code&gt;medium&lt;/code&gt;、&lt;code&gt;high&lt;/code&gt; を比較し、必要な場合だけ上げてください。&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-benchmarks?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 ベンチマーク分析&lt;/a&gt;には、エフォート別の追加チャートがあります。&lt;/p&gt;

&lt;p&gt;また、マルチターンチャットで &lt;code&gt;xhigh&lt;/code&gt; を使う場合、モデルが思考をすべて書き込み、可視テキストなしでターンを終了することがあります。ユーザーに応答を返す前に、テキストブロックが存在するか確認してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  思考の制御
&lt;/h2&gt;

&lt;p&gt;適応的思考はデフォルトでオンです。Haiku 4.5と比べると、実装上は次の2点が重要です。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;デフォルト表示では思考テキストは非表示です。&lt;code&gt;thinking&lt;/code&gt; ブロックには空の &lt;code&gt;thinking&lt;/code&gt; フィールドと &lt;code&gt;signature&lt;/code&gt; のみが返されます。&lt;/li&gt;
&lt;li&gt;ログやUIで要約を表示したい場合は、&lt;code&gt;"display": "summarized"&lt;/code&gt; を指定します。
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"thinking"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"adaptive"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"display"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"summarized"&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;思考量を減らしたい場合は、プロンプトで直接回答を促すのではなく、エフォートを下げてください。Anthropicのテストでは、直接回答を促しても思考は停止しませんでした。&lt;/p&gt;

&lt;p&gt;思考を無効化できるのは &lt;code&gt;high&lt;/code&gt; 以下のエフォートだけです。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"claude-haiku-5-5"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"max_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;1024&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"thinking"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"disabled"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"output_config"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"effort"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"low"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"messages"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Extract the invoice number from: INV-2291, due Nov 3."&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;}]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;xhigh&lt;/code&gt; または &lt;code&gt;max&lt;/code&gt; で同じ設定を送ると400エラーになります。&lt;/p&gt;

&lt;p&gt;強制された &lt;code&gt;tool_choice&lt;/code&gt;（&lt;code&gt;any&lt;/code&gt; または特定ツール）は受け入れられますが、応答はツール呼び出しから開始し、思考ブロックは含まれません。&lt;/p&gt;

&lt;p&gt;マルチターンやエージェントループでは、返された思考ブロックをそのまま履歴に追加してください。思考ブロックの前にある &lt;code&gt;system&lt;/code&gt;、&lt;code&gt;tools&lt;/code&gt;、過去の &lt;code&gt;messages&lt;/code&gt; を変更すると400エラーになる場合があります。また、思考ブロックは生成したアカウント、またはリンクされたアカウントでのみ利用できます。&lt;/p&gt;

&lt;h2&gt;
  
  
  プロンプトのキャッシュとバッチジョブ
&lt;/h2&gt;

&lt;p&gt;キャッシュを使うと、安定したプロンプトプレフィックスのコストを下げられます。10万トークンまでのプロンプトでは、キャッシュ読み取りは100万トークンあたり &lt;code&gt;$0.01&lt;/code&gt; で、新規入力の &lt;code&gt;$0.10&lt;/code&gt; より安価です。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;5分キャッシュ書き込み: &lt;code&gt;$0.125&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;1時間キャッシュ書き込み: &lt;code&gt;$0.20&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;キャッシュ可能な最小プロンプト: 512トークン&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Haiku 4.5の最小値は4,096トークンだったため、Haiku 5.5では短いシステムプロンプトやツールリストもキャッシュ対象にできます。&lt;/p&gt;

&lt;p&gt;安定したプレフィックスに &lt;code&gt;cache_control&lt;/code&gt; を指定します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"claude-haiku-5-5"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"max_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;1024&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"system"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"You are a support triage assistant. &amp;lt;long, stable policy text here&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"cache_control"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"ephemeral"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;}],&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"messages"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Ticket: refund not received after 10 days."&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;}]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;リクエスト間でトップレベルの &lt;code&gt;effort&lt;/code&gt; を変更するとキャッシュは無効になります。一方、メッセージごとのエフォートは、&lt;code&gt;mid-conversation-output-config-2026-07-01&lt;/code&gt; ベータヘッダーを使うClaude APIおよびGoogle Cloudでキャッシュを保持します。&lt;/p&gt;

&lt;p&gt;TTLについては&lt;a href="https://platform.claude.com/docs/en/build-with-claude/prompt-caching" rel="noopener noreferrer"&gt;プロンプトキャッシングのドキュメント&lt;/a&gt;、概念については&lt;a href="https://apidog.com/jp/blog/what-is-prompt-caching?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;プロンプトキャッシング解説&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;p&gt;待機できるワークロードには、Message Batches APIを使えます。入出力料金は50%削減されます。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;プロンプト長&lt;/th&gt;
&lt;th&gt;入力&lt;/th&gt;
&lt;th&gt;出力&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;10万トークンまで&lt;/td&gt;
&lt;td&gt;&lt;code&gt;$0.05 / MTok&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;$0.25 / MTok&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;10万トークン超&lt;/td&gt;
&lt;td&gt;&lt;code&gt;$0.25 / MTok&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;$1.25 / MTok&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;また、&lt;code&gt;output-300k-2026-03-24&lt;/code&gt; ベータヘッダーを使うバッチは、30万出力トークンに到達できる唯一の経路です。&lt;/p&gt;

&lt;p&gt;10万トークンを超えるプロンプトには高額な料金が適用されます。設計時にはプロンプトサイズを計測してください。&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 料金ガイド&lt;/a&gt;で料金境界の例を確認できます。&lt;/p&gt;

&lt;h2&gt;
  
  
  &lt;code&gt;stop_reason: "refusal"&lt;/code&gt; を処理する
&lt;/h2&gt;

&lt;p&gt;Haiku 5.5はリクエストを拒否できるセーフティ分類器を実行します。サーバー側のフォールバックはありません。拒否時には次のような応答になります。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"stop_reason"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"refusal"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;カテゴリには &lt;code&gt;cyber&lt;/code&gt;、&lt;code&gt;frontier_llm&lt;/code&gt;、&lt;code&gt;bio&lt;/code&gt;、&lt;code&gt;general_harms&lt;/code&gt; があります。Haiku 4.5から移行する場合、これらの拒否は新しい挙動です。&lt;/p&gt;

&lt;p&gt;拒否を盲目的にリトライしないでください。同じリクエストを再送しても、通常は別の拒否が返されます。&lt;code&gt;stop_reason&lt;/code&gt; を先に確認し、通常応答と分けて処理します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;run&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
    &lt;span class="n"&gt;response&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;claude-haiku-5-5&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;max_tokens&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;4096&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;)&lt;/span&gt;

    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;stop_reason&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;refusal&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="n"&gt;details&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;getattr&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;stop_details&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="bp"&gt;None&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="n"&gt;category&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;getattr&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;details&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;category&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;unknown&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

        &lt;span class="nf"&gt;log_refusal&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;category&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;  &lt;span class="c1"&gt;# 独自のログ処理
&lt;/span&gt;        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;status&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;refused&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;category&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;category&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="n"&gt;text&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sh"&gt;""&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="n"&gt;block&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt;
        &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;block&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;block&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nb"&gt;type&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
    &lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;status&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;ok&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;拒否されたリクエストは、人間のレビューまたは別モデルへのルーティングを検討してください。&lt;code&gt;cyber&lt;/code&gt; または &lt;code&gt;bio&lt;/code&gt; 分類器によって正当なセキュリティ・ライフサイエンス業務がブロックされるチームは、Anthropicのサイバー検証プログラムまたはライフサイエンス検証プログラムに申請できます。&lt;/p&gt;

&lt;h2&gt;
  
  
  コンピューター利用とブラウザー利用
&lt;/h2&gt;

&lt;p&gt;Claude APIとGoogle Cloudでは、Haiku 5.5は &lt;code&gt;computer_toolset_20260801&lt;/code&gt; ツールセットでコンピューター利用をサポートします。ベータヘッダーは不要です。&lt;/p&gt;

&lt;p&gt;古い &lt;code&gt;computer_20250124&lt;/code&gt; を宣言すると400エラーになります。&lt;/p&gt;

&lt;p&gt;ブラウザー利用には &lt;code&gt;browser_toolset_20260801&lt;/code&gt; を使用します。これはHaiku 4.5ではサポートされていません。PythonおよびTypeScript SDKは、リリース日に両ツールセット向けのベータクラスを追加しました。&lt;/p&gt;

&lt;p&gt;利用可能なツールメンバーについては、&lt;a href="https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool" rel="noopener noreferrer"&gt;コンピューター利用ツールに関するドキュメント&lt;/a&gt;を確認してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  レート制限
&lt;/h2&gt;

&lt;p&gt;Haiku 5.5の&lt;a href="https://platform.claude.com/docs/en/api/rate-limits" rel="noopener noreferrer"&gt;レート制限&lt;/a&gt;はHaiku 4.5と同じです。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;ティア&lt;/th&gt;
&lt;th&gt;リクエスト/分&lt;/th&gt;
&lt;th&gt;入力トークン/分&lt;/th&gt;
&lt;th&gt;出力トークン/分&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Start&lt;/td&gt;
&lt;td&gt;1,000&lt;/td&gt;
&lt;td&gt;2M&lt;/td&gt;
&lt;td&gt;400K&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Scale&lt;/td&gt;
&lt;td&gt;最大10,000&lt;/td&gt;
&lt;td&gt;10M&lt;/td&gt;
&lt;td&gt;2M&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Priority Tierはサポートされていません。429エラーの実装パターンは、&lt;a href="https://apidog.com/jp/blog/rate-limit-exceeded-guide?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;レート制限超過ガイド&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  ApidogでClaude Haiku 5.5 APIをテストする
&lt;/h2&gt;

&lt;p&gt;保存済みリクエストを使うと、エフォートごとの比較、拒否のデバッグ、キャッシュ動作の確認を繰り返せます。&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;での設定手順は以下のとおりです。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F3jw3p8guq8r3yjgnrwuv.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F3jw3p8guq8r3yjgnrwuv.png" alt="ApidogでのClaude Haiku 5.5 APIテスト画面" width="799" height="530"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;環境を作成し、&lt;code&gt;ANTHROPIC_API_KEY&lt;/code&gt; をシークレット変数として追加します。&lt;code&gt;x-api-key&lt;/code&gt; ヘッダーには &lt;code&gt;{{ANTHROPIC_API_KEY}}&lt;/code&gt; を設定し、&lt;code&gt;anthropic-version: 2023-06-01&lt;/code&gt; と &lt;code&gt;content-type: application/json&lt;/code&gt; を追加します。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;https://api.anthropic.com/v1/messages&lt;/code&gt; へのPOSTリクエストを作成し、最初の呼び出しのJSONを貼り付けて保存します。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;次のアサーションを追加します。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;HTTPステータスが &lt;code&gt;200&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;$.stop_reason&lt;/code&gt; が &lt;code&gt;end_turn&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;$.usage.output_tokens&lt;/code&gt; が &lt;code&gt;0&lt;/code&gt; より大きい&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;$.content[*].type&lt;/code&gt; に &lt;code&gt;text&lt;/code&gt; が含まれる&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;これにより、拒否や空の &lt;code&gt;xhigh&lt;/code&gt; 応答をテストで検出できます。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;リクエストを &lt;code&gt;low&lt;/code&gt;、&lt;code&gt;high&lt;/code&gt;、&lt;code&gt;xhigh&lt;/code&gt;、&lt;code&gt;max&lt;/code&gt; 用に複製し、フォルダーを実行します。自分のプロンプトに対する各エフォートの &lt;code&gt;usage&lt;/code&gt; を比較できます。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;キャッシュ済みシステムプロンプトのバリアントを追加し、2回目の実行で &lt;code&gt;$.usage.cache_read_input_tokens&lt;/code&gt; が &lt;code&gt;0&lt;/code&gt; より大きいことをアサートします。&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;より広いテストパターンについては、&lt;a href="https://apidog.com/jp/blog/test-llm-applications?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;LLMアプリケーションのテスト&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  よくある質問（FAQ）
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Claude Haiku 5.5のモデルIDは何ですか？
&lt;/h3&gt;

&lt;p&gt;Claude API、Google Cloud、Microsoft Foundry、およびAWS上のClaude Platformでは &lt;code&gt;claude-haiku-5-5&lt;/code&gt; です。日付サフィックスや別個のエイリアスはありません。Amazon Bedrockでは &lt;code&gt;anthropic.claude-haiku-5-5&lt;/code&gt; を使います。&lt;/p&gt;

&lt;h3&gt;
  
  
  Claude Haiku 5.5 APIの無料版はありますか？
&lt;/h3&gt;

&lt;p&gt;常時提供される無料ティアはありません。ただし、新しいAPIユーザーにはAPIテスト用の少額の無料クレジットが付与されます。&lt;/p&gt;

&lt;p&gt;無料の &lt;a href="http://Claude.ai" rel="noopener noreferrer"&gt;Claude.ai&lt;/a&gt; ユーザーはチャットでHaiku 5.5を選択できますが、これはAPIキーではありません。MaxおよびTeamプランには月額APIクレジットが含まれるようになりました。&lt;a href="https://apidog.com/jp/blog/how-to-use-claude-haiku-5-5-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;無料アクセスガイド&lt;/a&gt;で対象範囲を確認してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  Haiku 4.5向けのリクエストが400エラーを返すのはなぜですか？
&lt;/h3&gt;

&lt;p&gt;以下の項目を確認してください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;budget_tokens&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;非デフォルトの &lt;code&gt;temperature&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;&lt;code&gt;top_p&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;top_k&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;アシスタントプリフィル&lt;/li&gt;
&lt;li&gt;古い &lt;code&gt;computer_20250124&lt;/code&gt; ツール&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;これらが一般的な原因です。&lt;/p&gt;

&lt;h3&gt;
  
  
  Claude CodeでHaiku 5.5を使用できますか？
&lt;/h3&gt;

&lt;p&gt;はい。v2.1.293以降で使用できます。Anthropic APIでは、&lt;code&gt;haiku&lt;/code&gt; エイリアスはHaiku 5.5に解決されます。詳細は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude CodeでのClaude Haiku 5.5&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  エージェントコーディングにはHaiku 5.5とSonnet 5.5のどちらを使うべきですか？
&lt;/h3&gt;

&lt;p&gt;Anthropicは、Sonnet 5.5とOpus 5.5が「複雑なエージェントコーディングタスクにはより良い選択肢のままである」と述べています。&lt;/p&gt;

&lt;p&gt;Haiku 5.5は、分類、要約、圧縮、サブエージェント、ブラウザー利用など、狭い範囲の作業に使ってください。&lt;/p&gt;

&lt;h2&gt;
  
  
  次のステップ
&lt;/h2&gt;

&lt;p&gt;まず最初のリクエストを &lt;code&gt;medium&lt;/code&gt; で送信してください。次に、実際のワークロードから選んだ同一プロンプトを &lt;code&gt;low&lt;/code&gt; と &lt;code&gt;high&lt;/code&gt; で実行し、&lt;code&gt;usage.output_tokens&lt;/code&gt;、レイテンシ、回答品質を比較します。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/download?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidogをダウンロード&lt;/a&gt;して、3つのリクエストとアサーションを保存しておくと、次のモデルリリース時にはモデルIDや設定フィールドを変更するだけで再評価できます。&lt;/p&gt;

</description>
      <category>ai</category>
      <category>api</category>
      <category>claude</category>
      <category>llm</category>
    </item>
    <item>
      <title>クロード・ハイク 5.5 を無料で使う方法</title>
      <dc:creator>Akira</dc:creator>
      <pubDate>Thu, 08 Oct 2026 04:08:08 +0000</pubDate>
      <link>https://dev.to/aakira/kurodohaiku-55-wowu-liao-deshi-ufang-fa-3kmb</link>
      <guid>https://dev.to/aakira/kurodohaiku-55-wowu-liao-deshi-ufang-fa-3kmb</guid>
      <description>&lt;p&gt;はい、Claude Haiku 5.5は無料で利用できますが、対象はチャットのみです。Anthropicによると、フリープランのユーザーはWeb、iOS、Android版の&lt;a href="https://www.anthropic.com/claude/haiku" rel="noopener noreferrer"&gt;Claude.aiでHaiku 5.5を選択できます&lt;/a&gt;。一方、Claude APIには継続的な無料枠はありません。新規ユーザーは少額のテストクレジットを受け取れる場合がありますが、Claude Codeはフリープランに含まれず、無料チャットアカウントにAPIキーは提供されません。コードから&lt;code&gt;claude-haiku-5-5&lt;/code&gt;を呼び出す場合はトークン課金となり、最大10万トークンのプロンプトでは入力100万トークンあたり0.10ドル、出力100万トークンあたり0.50ドルからです。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;今すぐApidogを試す&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;Haiku 5.5は2026年10月7日にリリースされました。本記事では、無料チャットの利用手順、「無料のHaiku 5.5 APIは存在するか」という問いへの回答、有料プランに付帯するAPIクレジット、利用できないオファーを整理します。モデルの概要は&lt;a href="https://apidog.com/jp/blog/what-is-claude-haiku-5-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5とは何か&lt;/a&gt;、Claude全般の無料利用は&lt;a href="https://apidog.com/jp/blog/how-to-use-claude-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;無料Claudeガイド&lt;/a&gt;を参照してください。APIに移行する場合は、&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;を使うと、実装前にHaiku 5.5リクエストを送信・検査できます。&lt;/p&gt;

&lt;h2&gt;
  
  
  すべてのルートを一目で
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;ルート&lt;/th&gt;
&lt;th&gt;無料？&lt;/th&gt;
&lt;th&gt;得られるもの&lt;/th&gt;
&lt;th&gt;注意点&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;a href="http://Claude.ai" rel="noopener noreferrer"&gt;Claude.ai&lt;/a&gt; フリープラン&lt;/td&gt;
&lt;td&gt;はい&lt;/td&gt;
&lt;td&gt;Web、iOS、Android版のチャットでHaiku 5.5を選択&lt;/td&gt;
&lt;td&gt;チャットのみ。APIキーなし、Claude Codeなし&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Claude API&lt;/td&gt;
&lt;td&gt;いいえ&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;claude-haiku-5-5&lt;/code&gt;を最大10万トークンのプロンプトで入力0.10ドル／出力0.50ドル（100万トークンあたり）で利用&lt;/td&gt;
&lt;td&gt;新規ユーザーには少額のテストクレジットのみ。10万トークン超のプロンプトは入力0.50ドル／出力2.50ドル&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;MaxおよびTeam月額APIクレジット&lt;/td&gt;
&lt;td&gt;いいえ、有料プランの特典&lt;/td&gt;
&lt;td&gt;月額100ドル（Max 5x）、200ドル（Max 20x）、最大500ドルプール（Team）&lt;/td&gt;
&lt;td&gt;フリー、Pro、Enterpriseには適用されない。Claude Codeやクラウドプラットフォームでは利用不可&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Claude Code&lt;/td&gt;
&lt;td&gt;いいえ&lt;/td&gt;
&lt;td&gt;v2.1.293以降でHaiku 5.5を利用可能&lt;/td&gt;
&lt;td&gt;フリープランでは利用不可&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Vercel AI Gateway&lt;/td&gt;
&lt;td&gt;未確認&lt;/td&gt;
&lt;td&gt;支払いをしていないアカウントには30日ごとに5ドルのクレジット&lt;/td&gt;
&lt;td&gt;Vercelは、このクレジットがHaiku 5.5をカバーするか明言していない&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Google Cloud 300ドルお試し&lt;/td&gt;
&lt;td&gt;いいえ&lt;/td&gt;
&lt;td&gt;Claudeには何もなし&lt;/td&gt;
&lt;td&gt;マネージドAPIとして提供されるパートナーモデルは対象外&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Azure 200ドルクレジット&lt;/td&gt;
&lt;td&gt;いいえ&lt;/td&gt;
&lt;td&gt;Claudeには何もなし&lt;/td&gt;
&lt;td&gt;サードパーティブランド製品は対象外&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;OpenRouter、GitHub Copilot&lt;/td&gt;
&lt;td&gt;いいえ&lt;/td&gt;
&lt;td&gt;2026年10月8日時点でリストにない&lt;/td&gt;
&lt;td&gt;Haiku 4.5のみ&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  ルート1：Claude.aiのフリープラン
&lt;/h2&gt;

&lt;p&gt;誰でも使える最も簡単な無料ルートです。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;a href="http://claude.ai" rel="noopener noreferrer"&gt;claude.ai&lt;/a&gt;でアカウントを作成するか、iOSまたはAndroidアプリをインストールします。&lt;/li&gt;
&lt;li&gt;新しいチャットを開きます。&lt;/li&gt;
&lt;li&gt;モデルピッカーを開き、&lt;strong&gt;Haiku 5.5&lt;/strong&gt;を選択します。&lt;/li&gt;
&lt;li&gt;短時間で完了するタスクから試します。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Anthropicの&lt;a href="https://claude.com/pricing" rel="noopener noreferrer"&gt;料金ページ&lt;/a&gt;では、Haikuはフリープランに含まれる一方、Opusは含まれないと明記されています。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fassets.apidog.com%2Fblog-next%2F2026%2F10%2Fimage-29.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fassets.apidog.com%2Fblog-next%2F2026%2F10%2Fimage-29.png" alt="" width="800" height="493"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;重要なのは「Haiku 5.5を&lt;strong&gt;選択できる&lt;/strong&gt;」という表現です。Anthropicは、Haiku 5.5がフリープランのデフォルトモデルであるとは説明していません。長い会話を始める前に、必ずモデルピッカーを確認してください。&lt;/p&gt;

&lt;p&gt;Anthropicの&lt;a href="http://Claude.ai" rel="noopener noreferrer"&gt;Claude.ai&lt;/a&gt;システムプロンプトでは、Haiku 5.5を「迅速な質問に最適な最速のモデル」と説明しています。次のような用途に向いています。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;短く、繰り返し可能なタスク&lt;/strong&gt;
要約、書き換え、分類、迅速な検索などに使います。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;長い入力は慎重に扱う&lt;/strong&gt;
APIのコンテキストウィンドウは100万トークンですが、Anthropicはフリープランのコンテキスト制限を公開していません。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;複雑な問題は別モデルを検討する&lt;/strong&gt;
AnthropicはSonnet 5.5とOpus 5.5を、複雑なエージェントコーディング向けに位置付けています。詳しくは&lt;a href="https://apidog.com/jp/blog/how-to-use-claude-sonnet-5-5-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;無料Sonnet 5.5ガイド&lt;/a&gt;を参照してください。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;チャットの無料利用権だけでは、Claude Codeの実行、APIキーの取得、スクリプト・CIジョブ・エージェントの実行はできません。&lt;/p&gt;

&lt;h2&gt;
  
  
  無料のClaude Haiku 5.5 APIは存在しますか？
&lt;/h2&gt;

&lt;p&gt;継続的に使える無料APIはありません。&lt;/p&gt;

&lt;p&gt;Anthropicの料金ドキュメントには、新規ユーザーが「APIをテストするための少量の無料クレジット」を得られる場合があるとあります。ただし、継続的な無料枠や公式の無料Haiku 5.5 APIオファーはありません。&lt;code&gt;claude-haiku-5-5&lt;/code&gt;へのリクエストはすべてトークン単位で課金されます。&lt;/p&gt;

&lt;h3&gt;
  
  
  MaxおよびTeam月額APIクレジット（有料特典）
&lt;/h3&gt;

&lt;p&gt;Haiku 5.5の提供に合わせて、AnthropicはMaxおよびTeamサブスクライバー向けに&lt;a href="https://platform.claude.com/docs/en/about-claude/api-credits-for-subscribers" rel="noopener noreferrer"&gt;月額APIクレジット&lt;/a&gt;を追加しました。これは無料枠ではなく、サブスクリプション料金を支払うことで付与されるクレジットです。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;プラン&lt;/th&gt;
&lt;th&gt;月額APIクレジット&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Max 5x&lt;/td&gt;
&lt;td&gt;100ドル&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Max 20x&lt;/td&gt;
&lt;td&gt;200ドル&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Team&lt;/td&gt;
&lt;td&gt;スタンダードシートあたり20ドル、プレミアムシートあたり100ドル。プール上限は500ドル&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;フリー、Pro、Enterprise&lt;/td&gt;
&lt;td&gt;対象外&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;このクレジットは、Claudeプラットフォーム上の以下を含むすべてのモデルで利用できます。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Messages API&lt;/li&gt;
&lt;li&gt;Message Batches&lt;/li&gt;
&lt;li&gt;Managed Agents&lt;/li&gt;
&lt;li&gt;Agent SDK&lt;/li&gt;
&lt;li&gt;Console Playground&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Haiku 5.5も対象です。ただし、以下には適用されません。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;インタラクティブなClaude Code&lt;/li&gt;
&lt;li&gt;Claudeアプリ内での追加利用&lt;/li&gt;
&lt;li&gt;Bedrock&lt;/li&gt;
&lt;li&gt;Google Cloud&lt;/li&gt;
&lt;li&gt;Microsoft Foundry&lt;/li&gt;
&lt;li&gt;AWS上のClaude Platform&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;クレジットは請求サイクルの終了時に失効し、翌月へ繰り越せません。新規サブスクライバーは7日後から請求できます。&lt;a href="http://claude.ai" rel="noopener noreferrer"&gt;claude.ai&lt;/a&gt;の請求設定で1つのConsole組織をリンクしますが、この組織は自分で変更できません。&lt;/p&gt;

&lt;p&gt;クレジットを使い切り、他の残高もない場合、APIリクエストは翌月まで停止します。使用料がClaudeプランに自動請求されることはありません。請求手順は&lt;a href="https://support.claude.com/en/articles/17154008-monthly-api-credits-for-max-and-team-plans" rel="noopener noreferrer"&gt;ヘルプセンターの記事&lt;/a&gt;を確認してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  Vercel AI Gateway（未確認）
&lt;/h3&gt;

&lt;p&gt;VercelはHaiku 5.5を&lt;code&gt;anthropic/claude-haiku-5.5&lt;/code&gt;としてリストしています。&lt;a href="https://vercel.com/ai-gateway/models/claude-haiku-5.5" rel="noopener noreferrer"&gt;モデルページ&lt;/a&gt;には、支払いをしていない無料ユーザーは30日ごとに5ドルのクレジットを受け取れると記載されています。&lt;/p&gt;

&lt;p&gt;ただし、このクレジットがHaiku 5.5に使えるかは明記されていません。支払い履歴のないアカウントでリクエストが実際に成功するまでは、未確認のルートとして扱ってください。&lt;/p&gt;

&lt;p&gt;仮に利用できる場合、5ドルは最大10万トークンの料金帯で以下に相当します。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;入力：約5,000万トークン&lt;/li&gt;
&lt;li&gt;出力：約1,000万トークン&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  最も安価な有料パス
&lt;/h3&gt;

&lt;p&gt;MaxやTeamを契約していない場合は、ConsoleでAPIキーを作成して定価で利用します。キー作成手順は&lt;a href="https://apidog.com/jp/blog/anthropic-api-key?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Anthropic APIキーガイド&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Haiku 5.5、100万トークンあたり&lt;/th&gt;
&lt;th&gt;入力&lt;/th&gt;
&lt;th&gt;出力&lt;/th&gt;
&lt;th&gt;キャッシュ読み取り&lt;/th&gt;
&lt;th&gt;バッチ入力／出力&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;最大10万トークンのプロンプト&lt;/td&gt;
&lt;td&gt;0.10ドル&lt;/td&gt;
&lt;td&gt;0.50ドル&lt;/td&gt;
&lt;td&gt;0.01ドル&lt;/td&gt;
&lt;td&gt;0.05ドル／0.25ドル&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;10万トークンを超えるプロンプト&lt;/td&gt;
&lt;td&gt;0.50ドル&lt;/td&gt;
&lt;td&gt;2.50ドル&lt;/td&gt;
&lt;td&gt;0.05ドル&lt;/td&gt;
&lt;td&gt;0.25ドル／1.25ドル&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;たとえば、入力2,000トークンと出力500トークンのリクエストは、低料金帯では次の計算になります。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;入力: 2,000 / 1,000,000 × $0.10 = $0.0002
出力:   500 / 1,000,000 × $0.50 = $0.00025
合計: 約$0.00045
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;注意点は2つあります。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;新しいトークナイザーは、同じテキストでもHaiku 4.5より約30%多くトークンを生成します。&lt;/li&gt;
&lt;li&gt;10万トークンを超えるプロンプトには高い料金が適用されます。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;詳細な計算例は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5の料金内訳&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;p&gt;少ない予算で使うための実践的な方法は次の4つです。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;労力レベルを下げる&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;output_config.effort&lt;/code&gt;には&lt;code&gt;low&lt;/code&gt;、&lt;code&gt;medium&lt;/code&gt;（デフォルト）、&lt;code&gt;high&lt;/code&gt;、&lt;code&gt;xhigh&lt;/code&gt;、&lt;code&gt;max&lt;/code&gt;を設定できます。Anthropicは&lt;code&gt;low&lt;/code&gt;を最も安価かつ高速なレベルと説明しています。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;不要なら思考を無効化する&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;high&lt;/code&gt;以下の努力レベルでは、&lt;code&gt;thinking: {"type": "disabled"}&lt;/code&gt;を設定できます。思考トークンは&lt;code&gt;max_tokens&lt;/code&gt;に含まれます。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;共通プレフィックスをキャッシュする&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Haiku 5.5でキャッシュ可能な最小プロンプトは512トークンです。低料金帯のキャッシュ読み取りは100万トークンあたり0.01ドルです。仕組みは&lt;a href="https://apidog.com/jp/blog/what-is-prompt-caching?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;プロンプトキャッシュ説明&lt;/a&gt;を参照してください。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;待機可能な処理はBatch APIへ送る&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Batch APIでは入力・出力料金が半額になります。&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  無料ではないもの
&lt;/h2&gt;

&lt;p&gt;「無料のHaiku 5.5」を検索すると表示されることがありますが、以下は無料アクセスを提供するものではありません。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;フリープランでのClaude Code&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Claude Codeはフリープランに含まれず、MaxおよびTeamのAPIクレジットでも支払えません。Haiku 5.5を使うにはv2.1.293以降が必要です。セットアップは&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 Claude Codeガイド&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;ProプランからのAPIアクセス&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Proプランは月額APIクレジットの対象外です。Proサブスクライバーも、API呼び出しごとにトークン単位で支払います。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Google Cloudの300ドルお試し&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Googleによると、このクレジットはマネージドAPIとして提供される生成AIパートナーモデルには利用できません。&lt;a href="https://cloud.google.com/free/docs/free-cloud-features" rel="noopener noreferrer"&gt;無料トライアルアカウント&lt;/a&gt;は、アップグレードするまでサードパーティの生成AIモデルを使用できません。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Azureの200ドルクレジット&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Microsoftの&lt;a href="https://azure.microsoft.com/en-us/pricing/offers/ms-azr-0044p/" rel="noopener noreferrer"&gt;提供条件&lt;/a&gt;では、サードパーティブランド製品およびAzure Marketplace経由の製品が対象外です。Claudeはサードパーティブランドのモデルです。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;AWS無料枠&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
AWSは新規アカウントに最大200ドルのクレジットを提供していますが、BedrockはAWS Marketplace経由でHaiku 5.5の料金を請求します。確認できるAWSページには無料枠クレジットが適用されるとは書かれていないため、利用できない前提で考えるべきです。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;OpenRouter&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
2026年10月8日時点で、OpenRouterのモデル一覧にはHaiku 5.5がありません。Haiku 4.5のみが1ドル／5ドルで提供されており、&lt;code&gt;:free&lt;/code&gt;バリアントもありません。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;GitHub Copilot&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
GitHubはHaiku 5.5を発表しておらず、サポートモデルページにはHaiku 4.5のみが掲載されています。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Cursor Hobby&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Haiku 5.5はCursorの「Other Models」プールから課金され、Pro、Pro Plus、Ultraプランに含まれます。Hobbyプランで使えるという公式情報はありません。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;サードパーティ製「Haiku 5.5」チャットボット&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
チャットボットアグリゲーターには、無関係なユーザーが作成し、別会社のモデルで動いているものがあります。&lt;a href="http://Claude.ai" rel="noopener noreferrer"&gt;Claude.ai&lt;/a&gt;または公式モバイルアプリを使用してください。&lt;/p&gt;
&lt;h2&gt;
  
  
  Apidogで最初のHaiku 5.5リクエストをテストする
&lt;/h2&gt;

&lt;p&gt;APIキーを取得したら、実装を始める前にリクエストを検証します。&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;では、&lt;code&gt;ANTHROPIC_API_KEY&lt;/code&gt;を環境変数として保存できるため、共有するリクエストにキーを直接書かずに済みます。&lt;/p&gt;

&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fassets.apidog.com%2Fblog-next%2F2026%2F10%2Fimage-30.png" alt="" width="799" height="530"&gt;

&lt;p&gt;次のcURLコマンドをApidogにインポートし、&lt;code&gt;$ANTHROPIC_API_KEY&lt;/code&gt;を&lt;code&gt;{{ANTHROPIC_API_KEY}}&lt;/code&gt;に置き換えてください。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl https://api.anthropic.com/v1/messages &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"x-api-key: &lt;/span&gt;&lt;span class="nv"&gt;$ANTHROPIC_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"anthropic-version: 2023-06-01"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"content-type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "claude-haiku-5-5",
    "max_tokens": 1024,
    "thinking": {"type": "disabled"},
    "output_config": {"effort": "low"},
    "messages": [
      {"role": "user", "content": "Classify this ticket as billing, bug, or feature request: The export button returns a 500 error."}
    ]
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;送信後は、レスポンスの&lt;code&gt;usage&lt;/code&gt;オブジェクトを確認し、実際に請求されたトークン数を把握します。続いて、リクエストを保存し、少なくとも次の2つをアサートしてください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;HTTPステータスだけでなく&lt;code&gt;stop_reason&lt;/code&gt;も確認する&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Haiku 5.5は安全分類器を実行しており、&lt;code&gt;stop_reason: "refusal"&lt;/code&gt;でリクエストを拒否する場合があります。Haiku 4.5から移行する場合は、新しい挙動です。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;&lt;code&gt;usage&lt;/code&gt;が予算内に収まることを確認する&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
努力レベルやプロンプトを変更するたびに再実行し、トークン使用量を比較してください。&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Haiku 4.5のリクエストをコピーする場合は、以下を削除してください。Haiku 5.5では400エラーになる可能性があります。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;temperature&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;top_p&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;top_k&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;budget_tokens&lt;/code&gt;を使う思考設定&lt;/li&gt;
&lt;li&gt;アシスタントの事前入力&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;互換性のない変更点は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-vs-haiku-4-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 vs Haiku 4.5ガイド&lt;/a&gt;を、努力レベル・思考・キャッシュの詳細は&lt;a href="https://apidog.com/jp/blog/how-to-use-claude-haiku-5-5-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 APIガイド&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  よくある質問
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Claude Haiku 5.5は無料ですか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
はい、チャットでは無料です。フリープランのユーザーは、Web、iOS、Android版の&lt;a href="http://Claude.ai" rel="noopener noreferrer"&gt;Claude.ai&lt;/a&gt;でHaiku 5.5を選択できます。APIとClaude Codeは有料です。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Haiku 5.5はClaudeフリープランのデフォルトモデルですか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Anthropicはそう明言していません。フリーユーザーがHaiku 5.5を選択できると説明しているだけなので、モデルピッカーを確認してください。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;無料のClaude Haiku 5.5 APIキーを取得できますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
継続的に使えるものはありません。新規APIユーザーは少額のテストクレジットしか得られず、チャットプランにAPIキーは含まれません。MaxおよびTeamプランには月額APIクレジットがありますが、有料サブスクリプションの特典です。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;MaxおよびTeam APIクレジットはClaude Codeで使えますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
いいえ。対象はClaude API、Message Batches、Managed Agents、Agent SDK、Console Playgroundです。インタラクティブなClaude Codeやクラウドプラットフォームには適用されません。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;GPT-6 Lunaは無料の代替手段ですか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
GPT-6 Lunaは短いプロンプトに対して同じ0.10ドル／0.50ドルの定価設定です。OpenAIはデスクトップアプリで、Chatではなく、フリーおよびGoユーザーがアクセスできるようにしています。詳細は&lt;a href="https://apidog.com/jp/blog/how-to-use-gpt-6-luna-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;GPT-6 Luna無料ガイド&lt;/a&gt;と&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-vs-gpt-6-luna?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 vs GPT-6 Luna比較&lt;/a&gt;を参照してください。&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  チャットから始めて、APIには少額を支払う
&lt;/h2&gt;

&lt;p&gt;まずは&lt;a href="http://claude.ai" rel="noopener noreferrer"&gt;claude.ai&lt;/a&gt;またはモバイルアプリを開き、迅速で繰り返し可能なタスクにHaiku 5.5を使ってください。&lt;/p&gt;

&lt;p&gt;スクリプトやエージェントで使う必要がある場合は、すでにMaxまたはTeamのAPIクレジットがあるか確認します。クレジットがない場合でも、最大10万トークンのプロンプトであれば、入力100万トークンあたり0.10ドル、出力100万トークンあたり0.50ドルのため、少額のConsole残高でも始められます。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/download?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidogをダウンロード&lt;/a&gt;して、最初の&lt;code&gt;claude-haiku-5-5&lt;/code&gt;リクエストを送信しましょう。&lt;code&gt;stop_reason&lt;/code&gt;と&lt;code&gt;usage&lt;/code&gt;をアサートし、初日からAPIキーを環境変数に保存する運用をおすすめします。&lt;/p&gt;

</description>
    </item>
    <item>
      <title>クロード・ハイク 5.5とは？</title>
      <dc:creator>Akira</dc:creator>
      <pubDate>Thu, 08 Oct 2026 04:05:17 +0000</pubDate>
      <link>https://dev.to/aakira/kurodohaiku-55toha-2lb1</link>
      <guid>https://dev.to/aakira/kurodohaiku-55toha-2lb1</guid>
      <description>&lt;p&gt;Claude Haiku 5.5は、Anthropicの現行モデルの中で最小かつ最速のモデルで、2026年10月7日にAPI ID &lt;code&gt;claude-haiku-5-5&lt;/code&gt;としてリリースされました。料金は、10万トークンまでのプロンプトでは入力100万トークンあたり0.10ドル、出力100万トークンあたり0.50ドルです。10万トークンを超えるプロンプトでは、入力0.50ドル、出力2.50ドルになります。&lt;a href="https://www.anthropic.com/claude-haiku-5-5" rel="noopener noreferrer"&gt;発表記事&lt;/a&gt;でAnthropicは、Haiku 4.5と比べて平均の実行コストを約75%削減し、「これまでのモデルで最速」と説明しています。Haikuシリーズで初めて努力設定（effort setting）を導入し、100万トークンのコンテキストウィンドウも提供します。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;今すぐApidogを試す&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;この記事では、Haiku 5.5の仕様、2段階料金、Haiku 4.5からの移行時の破壊的変更、利用方法を実装視点で整理します。料金の詳細は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5の料金詳細&lt;/a&gt;を参照してください。APIリクエストの検証には、&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;を使うと、Messages APIの呼び出し、環境変数でのキー管理、トークン使用量の確認を1つのプロジェクトで行えます。&lt;/p&gt;

&lt;h2&gt;
  
  
  Claude Haiku 5.5の仕様概要
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;項目&lt;/th&gt;
&lt;th&gt;Claude Haiku 5.5&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;リリース日&lt;/td&gt;
&lt;td&gt;2026年10月7日&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;モデルID（Claude API、Google Cloud、Microsoft Foundry、Claude Platform on AWS）&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;claude-haiku-5-5&lt;/code&gt;（固定ID、日付サフィックスなし）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;モデルID（Amazon Bedrock）&lt;/td&gt;
&lt;td&gt;&lt;code&gt;anthropic.claude-haiku-5-5&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;コンテキストウィンドウ&lt;/td&gt;
&lt;td&gt;100万トークン（Haiku 4.5は20万トークン）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;最大出力&lt;/td&gt;
&lt;td&gt;12万8000トークン（Haiku 4.5は6万4000トークン）。バッチAPIでは&lt;code&gt;output-300k-2026-03-24&lt;/code&gt;ベータヘッダーで30万トークン&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;思考（Thinking）&lt;/td&gt;
&lt;td&gt;アダプティブのみ&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;努力レベル（Effort levels）&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;low&lt;/code&gt;、&lt;code&gt;medium&lt;/code&gt;（デフォルト）、&lt;code&gt;high&lt;/code&gt;、&lt;code&gt;xhigh&lt;/code&gt;、&lt;code&gt;max&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;知識カットオフ&lt;/td&gt;
&lt;td&gt;2026年6月&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;MTokあたりの料金（10万トークンまでのプロンプト）&lt;/td&gt;
&lt;td&gt;入力0.10ドル、出力0.50ドル&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;MTokあたりの料金（10万トークンを超えるプロンプト）&lt;/td&gt;
&lt;td&gt;入力0.50ドル、出力2.50ドル&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;廃止&lt;/td&gt;
&lt;td&gt;2027年10月7日より前ではない&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  ClaudeのラインナップにおけるHaiku 5.5の位置付け
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;モデル&lt;/th&gt;
&lt;th&gt;MTokあたりの入力/出力&lt;/th&gt;
&lt;th&gt;デフォルトの努力レベル&lt;/th&gt;
&lt;th&gt;レイテンシー&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Claude Fable 5.1&lt;/td&gt;
&lt;td&gt;$10 / $50&lt;/td&gt;
&lt;td&gt;&lt;code&gt;high&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;遅い&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;a href="https://apidog.com/jp/blog/what-is-claude-opus-5-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Opus 5.5&lt;/a&gt;&lt;/td&gt;
&lt;td&gt;$4 / $20&lt;/td&gt;
&lt;td&gt;&lt;code&gt;medium&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;中程度&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;a href="https://apidog.com/jp/blog/what-is-claude-sonnet-5-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Sonnet 5.5&lt;/a&gt;&lt;/td&gt;
&lt;td&gt;$2 / $10&lt;/td&gt;
&lt;td&gt;&lt;code&gt;high&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;速い&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Claude Haiku 5.5&lt;/td&gt;
&lt;td&gt;10万トークンまでのプロンプトで$0.10 / $0.50&lt;/td&gt;
&lt;td&gt;&lt;code&gt;medium&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;最速&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;4モデルはいずれも、100万トークンのコンテキストウィンドウ、最大12万8000トークンの出力、2026年6月の知識カットオフを共有しています。&lt;/p&gt;

&lt;p&gt;Haiku 5.5は、次のような高ボリュームかつレイテンシーに敏感な処理に適しています。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;チケットや文書の分類&lt;/li&gt;
&lt;li&gt;JSON・フィールドの抽出&lt;/li&gt;
&lt;li&gt;モデルルーティング&lt;/li&gt;
&lt;li&gt;要約&lt;/li&gt;
&lt;li&gt;ライブサポート&lt;/li&gt;
&lt;li&gt;ブラウザ利用&lt;/li&gt;
&lt;li&gt;Opus 5.5またはSonnet 5.5配下のサブエージェント&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;速度については、「標準速度では最速」とされています。ただし、Fast ModeのOpusより速いという意味ではありません。Anthropicは1秒あたりのトークン数を公表していません。&lt;/p&gt;

&lt;h2&gt;
  
  
  Claude Haiku 5.5の料金
&lt;/h2&gt;

&lt;p&gt;料金はプロンプト長で切り替わります。&lt;strong&gt;入力が10万トークンを超えるリクエストでは、高い料金体系が適用される&lt;/strong&gt;ため、長大なコンテキストを送信するワークロードでは事前の見積もりが必要です。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fzxahqlzhtird78k4e0mz.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fzxahqlzhtird78k4e0mz.png" alt="Claude Haiku 5.5の料金" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;出典: &lt;a href="https://platform.claude.com/docs/en/about-claude/pricing" rel="noopener noreferrer"&gt;Claude API料金&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;「約75%削減」は平均値です。10万トークンまでのプロンプトではHaiku 4.5より90%安く、10万トークンを超えると50%安くなります。Haiku 4.5のリクエストの90%は10万トークン以下でした。この比較には、同じテキストで約30%多くのトークンを生成する新しいトークナイザーの影響が考慮されています。&lt;/p&gt;

&lt;p&gt;米国内のみで推論する&lt;code&gt;inference_geo&lt;/code&gt;は、すべてのトークンカテゴリで1.1倍のコストです。また、キャッシュ可能なプロンプトの最小サイズは、Haiku 4.5の4,096トークンから512トークンに下がりました。&lt;/p&gt;

&lt;p&gt;10万トークン未満では、表示価格はGPT-6 Lunaと一致します。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;入力: $0.10 / MTok&lt;/li&gt;
&lt;li&gt;出力: $0.50 / MTok&lt;/li&gt;
&lt;li&gt;キャッシュ読み込み: $0.01 / MTok&lt;/li&gt;
&lt;li&gt;キャッシュ書き込み: $0.125 / MTok&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;ただし、追加料金が始まる閾値は異なります。Lunaは入力27万2000トークン超で追加料金が発生します。&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-vs-gpt-6-luna?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5とGPT-6 Lunaの比較&lt;/a&gt;と&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;料金ガイド&lt;/a&gt;で、料金差と計算例を確認できます。&lt;/p&gt;

&lt;h2&gt;
  
  
  Haiku 4.5からの変更点
&lt;/h2&gt;

&lt;p&gt;Haiku 5.5へ移行すると、コンテキストウィンドウは5倍、最大出力は2倍になります。また、初めて努力（effort）を制御できます。&lt;/p&gt;

&lt;p&gt;ただし、&lt;a href="https://platform.claude.com/docs/en/models/haiku-5-5/migration-guide" rel="noopener noreferrer"&gt;移行ガイド&lt;/a&gt;によると、Haiku 4.5向けの実装をそのまま送ると400エラーになるケースがあります。&lt;/p&gt;

&lt;h3&gt;
  
  
  400エラーになる5つの変更
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;手動思考予算（Manual thinking budgets）&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;次の指定は失敗します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="w"&gt;   &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
     &lt;/span&gt;&lt;span class="nl"&gt;"thinking"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"enabled"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="nl"&gt;"budget_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;4096&lt;/span&gt;&lt;span class="w"&gt;
     &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Haiku 5.5では、アダプティブ思考と努力レベルを使います。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="w"&gt;   &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
     &lt;/span&gt;&lt;span class="nl"&gt;"thinking"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"adaptive"&lt;/span&gt;&lt;span class="w"&gt;
     &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
     &lt;/span&gt;&lt;span class="nl"&gt;"output_config"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="nl"&gt;"effort"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"medium"&lt;/span&gt;&lt;span class="w"&gt;
     &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;サンプリングパラメーター（Sampling parameters）&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;code&gt;temperature&lt;/code&gt;、&lt;code&gt;top_p&lt;/code&gt;、&lt;code&gt;top_k&lt;/code&gt;を削除してください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;デフォルト以外の&lt;code&gt;temperature&lt;/code&gt;または&lt;code&gt;top_p&lt;/code&gt;は失敗する&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;top_k&lt;/code&gt;を指定すると失敗する&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;temperature&lt;/code&gt;と&lt;code&gt;top_p&lt;/code&gt;を同時に送ると失敗する&lt;/li&gt;
&lt;/ul&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;アシスタントによる事前入力（Assistant prefill）&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;思考をオフにしていても、assistantメッセージによる事前入力は拒否されます。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;古いコンピューター使用ツール（Old computer use tool）&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Claude APIとGoogle Cloudでは、&lt;code&gt;computer_toolset_20260801&lt;/code&gt;を使います。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="w"&gt;   &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
     &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"computer_toolset_20260801"&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;computer_20250124&lt;/code&gt;は失敗します。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;編集された履歴（Edited history）&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;返却された思考ブロックより前にある&lt;code&gt;system&lt;/code&gt;、&lt;code&gt;tools&lt;/code&gt;、過去のメッセージを変更すると失敗します。会話履歴は追記専用として扱ってください。&lt;/p&gt;

&lt;h3&gt;
  
  
  エラーにはならないが結果に影響する変更
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;思考表示&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
思考ブロックはデフォルトで空で、署名のみが返されます。内容を表示するには&lt;code&gt;"display": "summarized"&lt;/code&gt;を設定します。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;トークンカウント&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
同じテキストでも約30%多くのトークンが生成されます。&lt;code&gt;max_tokens&lt;/code&gt;には思考トークンも含まれます。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;強制ツール使用&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;tool_choice&lt;/code&gt;で&lt;code&gt;any&lt;/code&gt;または特定ツールを強制できます。ただし、レスポンスには思考ブロックが含まれません。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;拒否（Refusals）&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
安全性分類器は&lt;code&gt;stop_reason: "refusal"&lt;/code&gt;を返す場合があります。サーバー側フォールバックはありません。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Priority Tier&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Haiku 5.5ではサポートされません。&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;APIでは、&lt;code&gt;high&lt;/code&gt;以下の努力レベルで思考を無効化できます。&lt;code&gt;xhigh&lt;/code&gt;および&lt;code&gt;max&lt;/code&gt;で思考を無効にすると400エラーになります。&lt;/p&gt;

&lt;p&gt;Haiku 4.5は非推奨ではなく、引き続きアクティブです。移行時のリクエスト差分は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-vs-haiku-4-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 vs Haiku 4.5ガイド&lt;/a&gt;で確認できます。&lt;/p&gt;

&lt;h2&gt;
  
  
  Claude Haiku 5.5のベンチマーク
&lt;/h2&gt;

&lt;p&gt;Haiku 5.5のベンチマークスコアは最大努力レベルで測定され、ほとんどが5回試行の平均です。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Artificial Analysis: GDPval-AA、AA-Briefcase&lt;/li&gt;
&lt;li&gt;Cognition: FrontierCode&lt;/li&gt;
&lt;li&gt;Anthropic: Chartography（Surge AIベンチマーク）&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F3prj3uotj2m02x8ojo8p.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F3prj3uotj2m02x8ojo8p.png" alt="Claude Haiku 5.5のベンチマーク" width="800" height="705"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;数値を比較する際は、努力レベルが同一か確認してください。FrontierCodeでは、Haikuは最大努力レベル、Sonnet 5.5は&lt;code&gt;xhigh&lt;/code&gt;努力レベルで比較されています。最大努力レベルのSonnetは46.2%、Haikuは46.4%でした。&lt;/p&gt;

&lt;p&gt;Anthropicは、LunaのOSWorldスコアをOpenAI API経由で実行し、LunaのTerminal-Benchスコアは公開リーダーボードのCodex CLI結果から取得しています。&lt;/p&gt;

&lt;p&gt;デフォルトの&lt;code&gt;medium&lt;/code&gt;努力レベルでは、Haiku 5.5は以下のスコアを記録しました。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;ベンチマーク&lt;/th&gt;
&lt;th&gt;スコア&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;GDPval-AA&lt;/td&gt;
&lt;td&gt;1277&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AA-Briefcase&lt;/td&gt;
&lt;td&gt;1372&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Anthropicは、複雑なエージェント型コーディングにはSonnet 5.5とOpus 5.5が依然として適しているとしています。2026年10月8日時点では、独立リーダーボードにHaiku 5.5の結果はありませんでした。Cursorは独自のCursorBenchで、最大努力レベルにおいて48.4%を報告しています。&lt;/p&gt;

&lt;p&gt;努力レベルごとのスコアとコストは、&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-benchmarks?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;ベンチマーク詳細解説&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  Claude Haiku 5.5を利用できる場所
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;プラットフォーム&lt;/th&gt;
&lt;th&gt;アクセス&lt;/th&gt;
&lt;th&gt;備考&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Claude API&lt;/td&gt;
&lt;td&gt;&lt;code&gt;claude-haiku-5-5&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;トークンごとの支払い&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Amazon Bedrock&lt;/td&gt;
&lt;td&gt;&lt;code&gt;anthropic.claude-haiku-5-5&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;AWS Marketplace経由で請求&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Google Cloud、Microsoft Foundry、Claude Platform on AWS&lt;/td&gt;
&lt;td&gt;&lt;code&gt;claude-haiku-5-5&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Claude APIと同じID&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;a href="http://Claude.ai" rel="noopener noreferrer"&gt;Claude.ai&lt;/a&gt;（Web、iOS、Android）&lt;/td&gt;
&lt;td&gt;モデルピッカー&lt;/td&gt;
&lt;td&gt;Free、Pro、Max、Team、Enterpriseで選択可能&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Claude Code&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/model claude-haiku-5-5&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;v2.1.293以降、有料プラン&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Vercel AI Gateway&lt;/td&gt;
&lt;td&gt;&lt;code&gt;anthropic/claude-haiku-5.5&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;$0.10 / $0.50から&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Cursor&lt;/td&gt;
&lt;td&gt;&lt;code&gt;claude-haiku-5-5&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Other Modelsプール&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;2026年10月8日時点では、OpenRouterには未掲載で、GitHub Copilotへの導入も発表されていません。&lt;/p&gt;

&lt;p&gt;Claude.aiの無料チャットアクセスはAPIキーではありません。APIは、Anthropicが新規ユーザーに提供する少額のテストクレジットを超えると従量課金です。&lt;/p&gt;

&lt;p&gt;MaxおよびTeamプランには月間APIクレジットが含まれるようになりました。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Max 5x: 100ドル&lt;/li&gt;
&lt;li&gt;Max 20x: 200ドル&lt;/li&gt;
&lt;li&gt;Team: 最大500ドルのプール&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;これらのクレジットはClaude Codeには適用されません。無料で使える範囲は&lt;a href="https://apidog.com/jp/blog/how-to-use-claude-haiku-5-5-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;無料アクセスガイド&lt;/a&gt;で確認してください。&lt;/p&gt;

&lt;p&gt;Claude Codeでは、&lt;code&gt;haiku&lt;/code&gt;エイリアスはAnthropic API上でのみHaiku 5.5を意味します。それ以外の環境ではHaiku 4.5を意味します。サブエージェント構成は&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude CodeでのHaiku 5.5&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  Haiku 5.5に切り替えるべきユーザー
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Haiku 4.5を使っている場合&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
まず5つの破壊的変更を修正してから切り替えてください。両モデルにスコアがある比較項目ではHaiku 5.5がHaiku 4.5を上回り、リスト価格も低くなっています。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;単純かつ反復的な処理にSonnetまたはOpusを使っている場合&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
分類、抽出、要約、サブエージェント処理でHaiku 5.5を評価してください。複雑なエージェント型コーディングには、より大きいモデルを継続利用してください。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;入力が頻繁に10万トークンを超える場合&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
導入前に両方の料金体系を比較してください。閾値を超えると、入力単価はトークンあたり5倍になります。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;セキュリティ関連の処理を行う場合&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Haiku 5.5のサイバーセキュリティ保護機能は、引き続きペネトレーションテストをブロックします。&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Anthropicの発表記事では、Asanaがタスク完了時のレイテンシーを30%以上削減したと報告し、BoxはHaiku 4.5より11ポイント高いスコアを約半分のレイテンシーで達成したと説明しています。これらは顧客による主張であり、独立テストではありません。&lt;/p&gt;

&lt;p&gt;また、システムカードでは、Anthropicの自動監査において他モデルより過剰拒否（over-refused）が多かったとされています。本番移行前に、自分のプロンプトセットで拒否率を測定してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  最初のHaiku 5.5リクエストを送信する
&lt;/h2&gt;

&lt;p&gt;以下は、サポートチケットを分類する最小のMessages APIリクエストです。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl https://api.anthropic.com/v1/messages &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"x-api-key: &lt;/span&gt;&lt;span class="nv"&gt;$ANTHROPIC_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"anthropic-version: 2023-06-01"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"content-type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "claude-haiku-5-5",
    "max_tokens": 4000,
    "thinking": {
      "type": "adaptive",
      "display": "summarized"
    },
    "output_config": {
      "effort": "low"
    },
    "messages": [
      {
        "role": "user",
        "content": "Classify this support ticket as billing, bug, or feature request: The export button returns a 500 error."
      }
    ]
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;このリクエストでは、次の項目を含めないでください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;temperature&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;top_p&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;top_k&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;assistant prefill&lt;/li&gt;
&lt;li&gt;手動の&lt;code&gt;budget_tokens&lt;/code&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;レスポンスは思考ブロックから始まる可能性があるため、配列の位置ではなく各コンテンツブロックの&lt;code&gt;type&lt;/code&gt;で処理してください。&lt;/p&gt;

&lt;p&gt;たとえば、レスポンス処理では&lt;code&gt;text&lt;/code&gt;ブロックだけを連結する実装にします。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;text&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;content&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;block&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;block&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;type&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;text&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;block&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;block&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;text&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="se"&gt;\n&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;text&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;では、curlコマンドを新規リクエストとしてインポートし、キーを&lt;code&gt;ANTHROPIC_API_KEY&lt;/code&gt;環境変数に保存します。さらに、次のようなテストを追加して失敗状態を検出できます。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;stop_reason&lt;/code&gt;が&lt;code&gt;refusal&lt;/code&gt;ではない&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;stop_reason&lt;/code&gt;が&lt;code&gt;max_tokens&lt;/code&gt;ではない&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;usage&lt;/code&gt;が返されている&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;content&lt;/code&gt;に&lt;code&gt;text&lt;/code&gt;ブロックが存在する&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;次に、同じリクエストを&lt;code&gt;medium&lt;/code&gt;努力レベルで複製し、&lt;code&gt;usage&lt;/code&gt;を比較してください。品質、入力トークン、出力トークン、レイテンシーを記録すると、ワークロードに適した努力レベルを判断できます。&lt;/p&gt;

&lt;p&gt;キャッシュ、バッチ処理、ストリーミングは&lt;a href="https://apidog.com/jp/blog/how-to-use-claude-haiku-5-5-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 APIガイド&lt;/a&gt;を参照してください。APIキーが必要な場合は、&lt;a href="https://apidog.com/jp/blog/anthropic-api-key?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Anthropic APIキーガイド&lt;/a&gt;が役立ちます。&lt;/p&gt;

&lt;h2&gt;
  
  
  よくある質問
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Claude Haiku 5.5はいつリリースされましたか？&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;2026年10月7日です。Sonnet 5.5の9日後にリリースされました。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Claude Haiku 5.5は無料ですか？&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="http://Claude.ai" rel="noopener noreferrer"&gt;Claude.ai&lt;/a&gt;のチャットアプリでは、無料ユーザーも選択できます。APIは、新規ユーザー向けの少額なテストクレジットを除き有料です。&lt;a href="https://apidog.com/jp/blog/how-to-use-claude-haiku-5-5-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;すべての無料利用方法&lt;/a&gt;を確認してください。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Claude Haiku 5.5のコンテキストウィンドウはどれくらいですか？&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;100万トークンです。Messages APIでは最大12万8000トークンを出力できます。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Haiku 4.5は廃止されますか？&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;まだです。Haiku 4.5は引き続きアクティブとしてリストされており、2026年10月15日より前に廃止されることはありません。&lt;/p&gt;

&lt;h2&gt;
  
  
  次のステップ
&lt;/h2&gt;

&lt;p&gt;まず、現在実行している高ボリューム処理を1つ選んでください。たとえば、チケットのトリアージ、文書要約、フォームからの情報抽出です。&lt;/p&gt;

&lt;p&gt;次の手順で評価します。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;現在のプロンプトを&lt;code&gt;claude-haiku-5-5&lt;/code&gt;へ送信する&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;low&lt;/code&gt;努力レベルで出力品質、レイテンシー、&lt;code&gt;usage&lt;/code&gt;を記録する&lt;/li&gt;
&lt;li&gt;同じリクエストを&lt;code&gt;medium&lt;/code&gt;で実行する&lt;/li&gt;
&lt;li&gt;現在のモデルの結果と比較する&lt;/li&gt;
&lt;li&gt;入力が10万トークンを超えるリクエストを別途集計する&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;refusal&lt;/code&gt;と&lt;code&gt;max_tokens&lt;/code&gt;の発生率を確認する&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;a href="https://apidog.com/download?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidogをダウンロード&lt;/a&gt;して、リクエスト、環境変数、アサーションを1つのプロジェクトにまとめると、切り替え前後の比較を再現しやすくなります。月額コストの見積もりには、&lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;料金ガイド&lt;/a&gt;を使用してください。&lt;/p&gt;

</description>
    </item>
    <item>
      <title>クロードコードでのクロード俳句5.5活用術 (サブエージェントモデルへの応用)</title>
      <dc:creator>Akira</dc:creator>
      <pubDate>Thu, 08 Oct 2026 04:05:05 +0000</pubDate>
      <link>https://dev.to/aakira/kurodokododenokurodopai-ju-55huo-yong-shu-sabuezientomoderuhenoying-yong--21j9</link>
      <guid>https://dev.to/aakira/kurodokododenokurodopai-ju-55huo-yong-shu-sabuezientomoderuhenoying-yong--21j9</guid>
      <description>&lt;p&gt;Claude Code で Claude Haiku 5.5 を使うには、まず &lt;code&gt;claude update&lt;/code&gt; で v2.1.293 以降へ更新します。続いて &lt;code&gt;claude --model claude-haiku-5-5&lt;/code&gt; で開始するか、既存セッションで &lt;code&gt;/model claude-haiku-5-5&lt;/code&gt; を実行してください。実運用では、Haiku 5.5 をメインモデルにするより、検索・テスト実行・ログ要約を担当するサブエージェントとして Sonnet 5.5 や Opus 5.5 と組み合わせる方法が有効です。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;今すぐApidogを試す&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;Haiku 5.5 のモデル仕様については、「&lt;a href="https://apidog.com/jp/blog/what-is-claude-haiku-5-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5とは&lt;/a&gt;」を参照してください。API を呼び出すプロジェクトでは、&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt; にテストシナリオを保存し、Haiku サブエージェントから実行すると、メインセッションのコンテキストを節約できます。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fpdzw21lf1xr5g9q3xnd5.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fpdzw21lf1xr5g9q3xnd5.png" alt="Claude Haiku 5.5 と Claude Code" width="800" height="705"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Claude Code での Claude Haiku 5.5 の概要
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;設定&lt;/th&gt;
&lt;th&gt;Haiku 5.5&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;最小バージョン&lt;/td&gt;
&lt;td&gt;v2.1.293（&lt;code&gt;claude update&lt;/code&gt;）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;モデル ID&lt;/td&gt;
&lt;td&gt;&lt;code&gt;claude-haiku-5-5&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;haiku&lt;/code&gt; エイリアス&lt;/td&gt;
&lt;td&gt;Anthropic API では Haiku 5.5&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;コンテキスト&lt;/td&gt;
&lt;td&gt;すべてのプランでネイティブ 1M、&lt;code&gt;[1m]&lt;/code&gt; サフィックス不要&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;自動圧縮&lt;/td&gt;
&lt;td&gt;デフォルトで約 967K トークン&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;デフォルトエフォート&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;medium&lt;/code&gt;（&lt;code&gt;low&lt;/code&gt;〜&lt;code&gt;max&lt;/code&gt;）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;思考&lt;/td&gt;
&lt;td&gt;常時オン、Claude Code では無効化不可&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;API 価格&lt;/td&gt;
&lt;td&gt;プロンプトが最大 100K トークンなら入力/出力 100 万トークンあたり $0.10/$0.50。100K 超では $0.50/$2.50&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;利用条件&lt;/td&gt;
&lt;td&gt;Pro、Max、Team、Enterprise、または API キー。無料プランでは利用不可&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  ステップ1: Claude Code を更新する
&lt;/h2&gt;

&lt;p&gt;Haiku 5.5 を使うには Claude Code v2.1.293 以降が必要です。まず更新します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;claude update
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;更新後、バージョンを確認してください。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;claude &lt;span class="nt"&gt;--version&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md" rel="noopener noreferrer"&gt;変更履歴&lt;/a&gt;では、Haiku 5.5 は Anthropic API におけるデフォルトの Haiku モデルとして記載されています。&lt;/p&gt;

&lt;p&gt;Claude Code 自体は無料プランでは利用できません。利用には Pro、Max、Team、Enterprise のいずれか、または Anthropic API キーが必要です。無料ユーザーは &lt;a href="http://Claude.ai" rel="noopener noreferrer"&gt;Claude.ai&lt;/a&gt; で Haiku 5.5 を選択できます。料金は &lt;a href="https://claude.com/pricing" rel="noopener noreferrer"&gt;claude.com/pricing&lt;/a&gt; を確認してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ2: Haiku 5.5 をメインモデルとして選択する
&lt;/h2&gt;

&lt;p&gt;新しいセッションを Haiku 5.5 で開始するには、モデル ID を明示します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;claude &lt;span class="nt"&gt;--model&lt;/span&gt; claude-haiku-5-5
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;実行中のセッションでは、次のコマンドで切り替えられます。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;/model claude-haiku-5-5
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;保存済み設定の &lt;code&gt;model&lt;/code&gt; が &lt;code&gt;haiku&lt;/code&gt; の場合、Haiku 4.5 で保存されたセッションも Haiku 5.5 として再開されます。ただし、これは Anthropic API を使う場合に限られます。&lt;/p&gt;

&lt;h3&gt;
  
  
  &lt;code&gt;haiku&lt;/code&gt; エイリアスはプロバイダーごとに異なる
&lt;/h3&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;プロバイダー&lt;/th&gt;
&lt;th&gt;
&lt;code&gt;haiku&lt;/code&gt; が解決するモデル&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Anthropic API&lt;/td&gt;
&lt;td&gt;Haiku 5.5&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AWS の Claude Platform&lt;/td&gt;
&lt;td&gt;Haiku 4.5&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Amazon Bedrock&lt;/td&gt;
&lt;td&gt;Haiku 4.5&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Google Cloud の Agent Platform&lt;/td&gt;
&lt;td&gt;Haiku 4.5&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Microsoft Foundry&lt;/td&gt;
&lt;td&gt;Haiku 4.5&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Bedrock、Google Cloud、Foundry、AWS の Claude Platform を使う場合、&lt;code&gt;/model haiku&lt;/code&gt; や &lt;code&gt;model: haiku&lt;/code&gt; は Haiku 4.5 を選ぶ可能性があります。Haiku 5.5 を使うには、プロバイダーに応じて完全なモデル ID を指定してください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Google Cloud / AWS Claude Platform: &lt;code&gt;claude-haiku-5-5&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;Amazon Bedrock: &lt;code&gt;us.anthropic.claude-haiku-5-5&lt;/code&gt; などの推論プロファイル ID&lt;/li&gt;
&lt;li&gt;Microsoft Foundry: 対応するデプロイメント名&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;また、後述する &lt;code&gt;ANTHROPIC_DEFAULT_HAIKU_MODEL&lt;/code&gt; で &lt;code&gt;haiku&lt;/code&gt; の参照先を設定できます。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ3: エフォートレベルを選択する
&lt;/h2&gt;

&lt;p&gt;Haiku 5.5 は、&lt;code&gt;low&lt;/code&gt;、&lt;code&gt;medium&lt;/code&gt;、&lt;code&gt;high&lt;/code&gt;、&lt;code&gt;xhigh&lt;/code&gt;、&lt;code&gt;max&lt;/code&gt; のエフォート制御を備えた最初の Haiku モデルです。Claude Code ではデフォルトで &lt;code&gt;medium&lt;/code&gt; が使われます。&lt;/p&gt;

&lt;p&gt;より長いエージェント作業に使う場合は、起動時に &lt;code&gt;high&lt;/code&gt; を指定します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;claude &lt;span class="nt"&gt;--model&lt;/span&gt; claude-haiku-5-5 &lt;span class="nt"&gt;--effort&lt;/span&gt; high
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;セッション内では次のように変更できます。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;/effort low
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;実装時の目安は次のとおりです。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;low&lt;/code&gt;: 短い検索、単発のツール実行、大量の反復処理&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;medium&lt;/code&gt;: 通常の開発作業&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;high&lt;/code&gt;: 複数ステップの調査、長めのエージェントタスク&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;xhigh&lt;/code&gt; / &lt;code&gt;max&lt;/code&gt;: 評価で効果を確認できたタスクだけに限定&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Claude Code では思考を無効化できません。&lt;code&gt;alwaysThinkingEnabled: false&lt;/code&gt; や &lt;code&gt;MAX_THINKING_TOKENS=0&lt;/code&gt; を指定しても Haiku 5.5 では効果がありません。トークン使用量を下げるには、エフォートを &lt;code&gt;low&lt;/code&gt; または &lt;code&gt;medium&lt;/code&gt; に下げてください。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ4: Haiku 5.5 をサブエージェントとして実行する
&lt;/h2&gt;

&lt;p&gt;Haiku 5.5 は、検索、テスト、ログ確認、ドキュメント収集など、反復的でコンテキスト消費が大きい作業に向いています。主導モデルを Sonnet 5.5 または Opus 5.5 にし、Haiku をサブエージェントとして使う構成が実用的です。&lt;/p&gt;

&lt;p&gt;サブエージェントは、次の場所に Markdown ファイルとして保存します。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;プロジェクト単位: &lt;code&gt;.claude/agents/&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;全プロジェクト共通: &lt;code&gt;~/.claude/agents/&lt;/code&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;YAML フロントマターでは &lt;code&gt;name&lt;/code&gt; と &lt;code&gt;description&lt;/code&gt; が必須です。&lt;code&gt;model&lt;/code&gt; には &lt;code&gt;sonnet&lt;/code&gt;、&lt;code&gt;opus&lt;/code&gt;、&lt;code&gt;haiku&lt;/code&gt;、&lt;code&gt;fable&lt;/code&gt;、完全なモデル ID、または &lt;code&gt;inherit&lt;/code&gt; を設定できます。詳細は &lt;a href="https://code.claude.com/docs/en/sub-agents" rel="noopener noreferrer"&gt;サブエージェントドキュメント&lt;/a&gt; と &lt;a href="https://apidog.com/jp/blog/create-claude-code-subagents?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Code サブエージェントガイド&lt;/a&gt; を参照してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  Explore を Haiku ベースの検索エージェントで置き換える
&lt;/h3&gt;

&lt;p&gt;組み込みの Explore サブエージェントは、メイン会話と同じモデルで実行されます。たとえば Opus 5.5 のセッションで Explore を使うと、検索も Opus 5.5 で実行されます。&lt;/p&gt;

&lt;p&gt;プロジェクト側で &lt;code&gt;Explore&lt;/code&gt; という名前のサブエージェントを定義すると、組み込み Explore をオーバーライドできます。&lt;code&gt;.claude/agents/Explore.md&lt;/code&gt; を作成してください。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight markdown"&gt;&lt;code&gt;&lt;span class="nn"&gt;---&lt;/span&gt;
&lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Explore&lt;/span&gt;
&lt;span class="na"&gt;description&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;高速な読み取り専用コードベース検索。ファイルを検索したり、シンボルや呼び出し箇所を見つけたりするのに使いますが、何も編集しません。&lt;/span&gt;
&lt;span class="na"&gt;tools&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Read, Grep, Glob&lt;/span&gt;
&lt;span class="na"&gt;model&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;haiku&lt;/span&gt;
&lt;span class="na"&gt;effort&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;low&lt;/span&gt;
&lt;span class="nn"&gt;---&lt;/span&gt;

コードベースを検索し、見つけたものを報告します。ファイルパスと行番号、各一致の簡単な要約を返します。ファイルを編集しないでください。
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;実行中に次のコマンドを使い、実際に選ばれたモデルを確認してください。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;/tasks
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;クラウドプロバイダー経由の場合は、&lt;code&gt;model: haiku&lt;/code&gt; を完全なモデル ID に置き換えてください。&lt;/p&gt;

&lt;h3&gt;
  
  
  すべてのサブエージェントを Haiku に固定する
&lt;/h3&gt;

&lt;p&gt;すべてのサブエージェントを Haiku で動かしたい場合は、設定ファイルの &lt;code&gt;env&lt;/code&gt; ブロックに次を追加します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"env"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"CLAUDE_CODE_SUBAGENT_MODEL"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"haiku"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"CLAUDE_CODE_SUBAGENT_MODEL_FORCE"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"1"&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;CLAUDE_CODE_SUBAGENT_MODEL&lt;/code&gt; だけではデフォルトを設定するだけです。サブエージェント個別の &lt;code&gt;model&lt;/code&gt; フィールドが優先され、組み込み Explore も切り替わりません。全サブエージェントを強制する場合は &lt;code&gt;CLAUDE_CODE_SUBAGENT_MODEL_FORCE&lt;/code&gt; も設定してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ5: バックグラウンド作業を Haiku 5.5 に向ける
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;ANTHROPIC_DEFAULT_HAIKU_MODEL&lt;/code&gt; は、&lt;code&gt;haiku&lt;/code&gt; や &lt;code&gt;claude --resume&lt;/code&gt; などのバックグラウンド機能で使うモデルを指定します。&lt;/p&gt;

&lt;p&gt;古い &lt;code&gt;ANTHROPIC_SMALL_FAST_MODEL&lt;/code&gt; は非推奨です。シェルプロファイルに残っている場合は、&lt;a href="https://code.claude.com/docs/en/env-vars" rel="noopener noreferrer"&gt;環境変数リファレンス&lt;/a&gt;を確認して置き換えてください。&lt;/p&gt;

&lt;p&gt;Anthropic API を直接使う場合、通常は追加設定不要です。Google Cloud ではバックグラウンドタスクがデフォルトで Sonnet、Foundry ではプライマリモデル、Bedrock では Sonnet またはプライマリモデルを使うため、Haiku 5.5 を明示的に指定します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Google Cloud の Agent Platform&lt;/span&gt;
&lt;span class="nb"&gt;export &lt;/span&gt;&lt;span class="nv"&gt;ANTHROPIC_DEFAULT_HAIKU_MODEL&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;claude-haiku-5-5

&lt;span class="c"&gt;# Amazon Bedrock（推論プロファイル ID）&lt;/span&gt;
&lt;span class="nb"&gt;export &lt;/span&gt;&lt;span class="nv"&gt;ANTHROPIC_DEFAULT_HAIKU_MODEL&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;us.anthropic.claude-haiku-5-5
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;設定を永続化する場合は、利用中のシェルに応じて &lt;code&gt;~/.zshrc&lt;/code&gt; や &lt;code&gt;~/.bashrc&lt;/code&gt; に追加します。&lt;/p&gt;

&lt;h2&gt;
  
  
  長いセッションにおける 100K の価格ステップ
&lt;/h2&gt;

&lt;p&gt;Haiku 5.5 の API 価格はプロンプト長に依存します。Claude Code は各ターンで会話履歴をプロンプトとして送るため、長いセッションではコンテキスト長を意識する必要があります。&lt;/p&gt;

&lt;p&gt;コンテキストが 100K トークンを超えると、価格は次のように変わります。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;プロンプト長&lt;/th&gt;
&lt;th&gt;入力 100 万トークンあたり&lt;/th&gt;
&lt;th&gt;出力 100 万トークンあたり&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;最大 100K トークン&lt;/td&gt;
&lt;td&gt;$0.10&lt;/td&gt;
&lt;td&gt;$0.50&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;100K トークン超&lt;/td&gt;
&lt;td&gt;$0.50&lt;/td&gt;
&lt;td&gt;$2.50&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;100K を超えると短いプロンプト時の 5 倍です。キャッシュ済みトークンがこの境界に含まれるかは明記されていないため、コスト見積もりでは含まれる前提で扱うのが安全です。&lt;/p&gt;

&lt;p&gt;自動圧縮はデフォルトで約 967K トークンまで実行されないため、コスト制御には不十分な場合があります。API 課金で使う場合は、次の 2 つを実施してください。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;早めに圧縮する&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;/autocompact 100k&lt;/code&gt; を設定すると、1M トークン付近まで待たず、100K 境界付近で圧縮できます。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;大量出力をサブエージェントへ移す&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
テストログ、grep 結果、調査メモをサブエージェント側のコンテキストに閉じ込めます。メイン会話に必要なのは要約だけです。&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;100K 超でも Haiku 5.5 は $0.50/$2.50 であり、Sonnet 5.5 の $2/$10 の 4 分の 1です。料金計算の詳細は &lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 の料金内訳&lt;/a&gt; を参照してください。&lt;/p&gt;

&lt;p&gt;Max および Team の契約者は、&lt;a href="https://platform.claude.com/docs/en/about-claude/api-credits-for-subscribers" rel="noopener noreferrer"&gt;API クレジットに関するドキュメント&lt;/a&gt;も確認してください。新しい月額 API クレジットは、インタラクティブな Claude Code を対象としていません。&lt;/p&gt;

&lt;h2&gt;
  
  
  Sonnet 5.5 または Opus 5.5 を主導モデルにすべきケース
&lt;/h2&gt;

&lt;p&gt;複雑なエージェント的コーディングでは、Sonnet 5.5 や Opus 5.5 を主導モデルに残してください。Anthropic が Claude Code で最大エフォートを使って実行した Terminal-Bench 4.0 では、Haiku 5.5 は 39.2%、Sonnet 5.5 は 70.6% でした。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;エフォート&lt;/th&gt;
&lt;th&gt;Haiku 5.5&lt;/th&gt;
&lt;th&gt;Sonnet 5.5&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;medium&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;20.3%（$0.68）&lt;/td&gt;
&lt;td&gt;28.8%（$0.68）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;high&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;24.8%（$1.04）&lt;/td&gt;
&lt;td&gt;43%（$1.46）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;max&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;39.2%（$2.64）&lt;/td&gt;
&lt;td&gt;70.6%（$10.44）&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;code&gt;medium&lt;/code&gt; では 1 試行あたりのコストがほぼ同じである一方、Sonnet のスコアが高くなっています。難しい実装、複数ファイルにまたがる設計変更、長時間のシェル作業では、Haiku を主導モデルにしないほうが安全です。&lt;/p&gt;

&lt;p&gt;一方で、コンピューター操作では異なる傾向があります。OSWorld 2.1 では、Haiku 5.5 の &lt;code&gt;medium&lt;/code&gt; は 1 試行あたり $0.13 で 53.3%、Sonnet 5.5 の &lt;code&gt;low&lt;/code&gt; は $0.68 で 57.9% でした。詳細は &lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-benchmarks?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 ベンチマーク分析&lt;/a&gt; と &lt;a href="https://apidog.com/jp/blog/claude-sonnet-5-5-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Sonnet 5.5 Claude Code ガイド&lt;/a&gt; を確認してください。&lt;/p&gt;

&lt;p&gt;実用的な役割分担は次のとおりです。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Sonnet 5.5 / Opus 5.5&lt;/strong&gt;: 設計、実装、複雑なデバッグ、最終判断&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Haiku 5.5&lt;/strong&gt;: Explore、テストランナー、ログ要約、ドキュメント取得、読み取り専用調査&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  例: Apidog テストを実行する Haiku サブエージェント
&lt;/h2&gt;

&lt;p&gt;テスト実行は、反復的で出力が大きくなりやすい作業です。Haiku サブエージェントに任せると、主導モデルのコンテキストをテストログで埋めずに済みます。&lt;/p&gt;

&lt;p&gt;以下を &lt;code&gt;.claude/agents/api-test-runner.md&lt;/code&gt; として保存してください。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight markdown"&gt;&lt;code&gt;&lt;span class="nn"&gt;---&lt;/span&gt;
&lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;api-test-runner&lt;/span&gt;
&lt;span class="na"&gt;description&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;APIエンドポイントが変更された後、Apidog CLI を使用してプロジェクトの Apidog テストシナリオを実行し、合格数と失敗数、および失敗したリクエストを報告します。&lt;/span&gt;
&lt;span class="na"&gt;tools&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Bash, Read&lt;/span&gt;
&lt;span class="na"&gt;model&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;haiku&lt;/span&gt;
&lt;span class="na"&gt;effort&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;low&lt;/span&gt;
&lt;span class="nn"&gt;---&lt;/span&gt;

変更されたエンドポイントをカバーするシナリオについて、このリポジトリの README に記載されている Apidog CLI テストコマンドを実行します。合格数と失敗数を報告します。失敗ごとに、リクエスト名、期待される結果、実際の結果を示します。コードを編集しないでください。失敗した実行を複数回再試行しないでください。
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Apidog CLI の認証と実行コマンドは、「&lt;a href="https://apidog.com/jp/blog/apidog-cli-in-claude-code?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Code での Apidog CLI&lt;/a&gt;」を参照してください。サブエージェントが実行するテストシナリオを作成するには、&lt;a href="https://apidog.com/download?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog をダウンロード&lt;/a&gt;してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  Haiku 4.5 からのアプリ移行
&lt;/h2&gt;

&lt;p&gt;API 経由で Haiku 4.5 を使っているプロジェクトは、Claude Code から移行作業を始められます。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;/claude-api migrate this project to claude-haiku-5-5
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;移行時は、互換性のないリクエストパラメータに注意してください。Haiku 5.5 では、以下を指定すると 400 エラーになります。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;手動の &lt;code&gt;budget_tokens&lt;/code&gt; 思考設定&lt;/li&gt;
&lt;li&gt;デフォルト以外の &lt;code&gt;temperature&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;デフォルト以外の &lt;code&gt;top_p&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;任意の &lt;code&gt;top_k&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;アシスタントメッセージの事前入力&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;修正内容は &lt;a href="https://apidog.com/jp/blog/claude-haiku-5-5-vs-haiku-4-5?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 vs Haiku 4.5 ガイド&lt;/a&gt; を確認してください。&lt;/p&gt;

&lt;p&gt;移行後は、旧リクエストと新リクエストを Apidog に保存して比較可能にします。&lt;code&gt;ANTHROPIC_API_KEY&lt;/code&gt; は環境変数として管理し、テストでは少なくとも次を検証してください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;stop_reason&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;usage&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;想定外の &lt;code&gt;refusal&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;トークン使用量の急増&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;これにより、本番環境で停止理由や料金が変わる前に、テストで検出できます。&lt;/p&gt;

&lt;h2&gt;
  
  
  よくある質問
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Haiku 5.5 は Claude Code のデフォルトモデルですか？
&lt;/h3&gt;

&lt;p&gt;いいえ。Haiku 5.5 は Anthropic API のデフォルト Haiku モデルです。Claude Code のメインモデルとして使うには、&lt;code&gt;--model&lt;/code&gt; または &lt;code&gt;/model&lt;/code&gt; で明示的に選択してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  Claude Code の無料プランで Haiku 5.5 を使えますか？
&lt;/h3&gt;

&lt;p&gt;使えません。Claude Code には有料プランまたは API キーが必要です。無料ユーザーは &lt;a href="http://Claude.ai" rel="noopener noreferrer"&gt;Claude.ai&lt;/a&gt; で Haiku 5.5 を選択できます。詳しくは &lt;a href="https://apidog.com/jp/blog/how-to-use-claude-haiku-5-5-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Claude Haiku 5.5 を無料で使う方法&lt;/a&gt; を参照してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  &lt;code&gt;model: haiku&lt;/code&gt; を指定すると Haiku 4.5 になるのはなぜですか？
&lt;/h3&gt;

&lt;p&gt;Bedrock、Google Cloud、Foundry、AWS の Claude Platform を利用しているか、Claude Code が v2.1.293 より前である可能性があります。完全なモデル ID を指定するか、&lt;code&gt;ANTHROPIC_DEFAULT_HAIKU_MODEL&lt;/code&gt; を設定してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  トークンを節約するために思考をオフにできますか？
&lt;/h3&gt;

&lt;p&gt;Claude Code ではできません。代わりにエフォートを下げてください。最も低コストなのは &lt;code&gt;low&lt;/code&gt; です。&lt;/p&gt;

&lt;h2&gt;
  
  
  次のステップ
&lt;/h2&gt;

&lt;p&gt;まず &lt;code&gt;claude update&lt;/code&gt; を実行し、Haiku を使う &lt;code&gt;Explore&lt;/code&gt; オーバーライドを追加してください。そのまま Sonnet 5.5 または Opus 5.5 を主導モデルとして 1 週間使い、検索・ログ確認・テスト実行を Haiku に移します。&lt;/p&gt;

&lt;p&gt;API を含むプロジェクトなら、次にテストランナーサブエージェントを追加してください。アプリケーションコードから Haiku 5.5 を呼び出す場合は、&lt;a href="https://apidog.com/jp/blog/how-to-use-claude-haiku-5-5-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Haiku 5.5 API ガイド&lt;/a&gt;から始めましょう。&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt; を使うと、サブエージェントに実行させる API テストを管理できます。&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Nano Banana 2.1、Nano Banana 2、Nano Banana Proを徹底比較！どれを選ぶべき？</title>
      <dc:creator>Akira</dc:creator>
      <pubDate>Tue, 06 Oct 2026 17:24:49 +0000</pubDate>
      <link>https://dev.to/aakira/nano-banana-21-nano-banana-2-nano-banana-prowoche-di-bi-jiao-dorewoxuan-bubeki-14fe</link>
      <guid>https://dev.to/aakira/nano-banana-21-nano-banana-2-nano-banana-prowoche-di-bi-jiao-dorewoxuan-bubeki-14fe</guid>
      <description>&lt;p&gt;Googleは現在、Gemini APIで4つのNano Banana画像モデルを提供しています。最新のNano Banana 2.1は、2026年10月6日にリリースされ、置き換えるモデルの画像あたりの価格が半額です。多くのチームではデフォルトの選択肢になりますが、すべてのワークロードに適するわけではありません。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;今すぐApidogを試す&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;このガイドでは、Nano Banana 2.1、Nano Banana 2、Nano Banana Proを並べて比較し、Nano Banana 2 Liteを予算重視の選択肢として扱います。以下の価格と制限は、2026年10月7日時点のGoogleの&lt;a href="https://ai.google.dev/gemini-api/docs/image-generation" rel="noopener noreferrer"&gt;画像生成ドキュメント&lt;/a&gt;および&lt;a href="https://ai.google.dev/gemini-api/docs/pricing" rel="noopener noreferrer"&gt;料金ページ&lt;/a&gt;に基づいています。&lt;/p&gt;

&lt;h2&gt;
  
  
  クイック評価
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;新規プロジェクトでは &lt;strong&gt;Nano Banana 2.1&lt;/strong&gt;（&lt;code&gt;gemini-nano-banana-2.1&lt;/code&gt;）をデフォルトにしてください。Googleもすべての新規プロジェクトに推奨しており、1K、2K、4Kの出力費用はNano Banana 2の半額です。&lt;/li&gt;
&lt;li&gt;0.5K（512px）出力が必要な場合は、&lt;strong&gt;Nano Banana 2&lt;/strong&gt;（&lt;code&gt;gemini-3.1-flash-image&lt;/code&gt;）を維持してください。2.1はこのサイズを提供していません。&lt;/li&gt;
&lt;li&gt;グラウンディングなし・参照入力が少ない大量の1K画像には、&lt;strong&gt;Nano Banana 2 Lite&lt;/strong&gt;（&lt;code&gt;gemini-3.1-flash-lite-image&lt;/code&gt;）を使用してください。1Kの画像単価は2.1と同じですが、入力費用が低くなります。&lt;/li&gt;
&lt;li&gt;Googleがプロフェッショナルアセット制作向けのプレミアムティアとして位置付けるモデルが必要で、1K画像あたり約4倍の費用を許容できる場合は、&lt;strong&gt;Nano Banana Pro&lt;/strong&gt;（&lt;code&gt;gemini-3-pro-image&lt;/code&gt;）を選択してください。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;注意点として、Googleは2.1のベンチマークを公開していません。ローンチ発表では2.1が「あらゆる面で以前のモデルを上回る」とされていますが、並行比較の数値はありません。本記事はモデル間の品質優劣を断定するものではありません。以下の手順で、実際のプロンプトを使って検証してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  並行比較仕様
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;/th&gt;
&lt;th&gt;Nano Banana 2.1&lt;/th&gt;
&lt;th&gt;Nano Banana 2&lt;/th&gt;
&lt;th&gt;Nano Banana Pro&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;APIモデルID&lt;/td&gt;
&lt;td&gt;&lt;code&gt;gemini-nano-banana-2.1&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;gemini-3.1-flash-image&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;gemini-3-pro-image&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Googleの位置づけ&lt;/td&gt;
&lt;td&gt;主要な高効率主力モデル&lt;/td&gt;
&lt;td&gt;以前の世代の主力モデル&lt;/td&gt;
&lt;td&gt;複雑な視覚タスクのためのプレミアムな選択肢&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;解像度&lt;/td&gt;
&lt;td&gt;1K、2K、4K&lt;/td&gt;
&lt;td&gt;0.5K、1K、2K、4K&lt;/td&gt;
&lt;td&gt;1K、2K、4K&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;入力価格（100万トークンあたり）&lt;/td&gt;
&lt;td&gt;$1.50&lt;/td&gt;
&lt;td&gt;$0.50&lt;/td&gt;
&lt;td&gt;$2.00&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;画像出力価格（100万トークンあたり）&lt;/td&gt;
&lt;td&gt;$30&lt;/td&gt;
&lt;td&gt;$60&lt;/td&gt;
&lt;td&gt;$120&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;0.5Kでの画像あたり&lt;/td&gt;
&lt;td&gt;n/a&lt;/td&gt;
&lt;td&gt;$0.045&lt;/td&gt;
&lt;td&gt;n/a&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;1Kでの画像あたり&lt;/td&gt;
&lt;td&gt;$0.0336&lt;/td&gt;
&lt;td&gt;$0.067&lt;/td&gt;
&lt;td&gt;$0.134&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2Kでの画像あたり&lt;/td&gt;
&lt;td&gt;$0.0504&lt;/td&gt;
&lt;td&gt;$0.101&lt;/td&gt;
&lt;td&gt;$0.134&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4Kでの画像あたり&lt;/td&gt;
&lt;td&gt;$0.0756&lt;/td&gt;
&lt;td&gt;$0.151&lt;/td&gt;
&lt;td&gt;$0.24&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;1Kでのバッチ画像あたり&lt;/td&gt;
&lt;td&gt;$0.0168&lt;/td&gt;
&lt;td&gt;$0.034&lt;/td&gt;
&lt;td&gt;$0.067&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Google検索グラウンディング&lt;/td&gt;
&lt;td&gt;ウェブ検索 + 画像検索&lt;/td&gt;
&lt;td&gt;ウェブ検索 + 画像検索&lt;/td&gt;
&lt;td&gt;ウェブ検索&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;参照画像&lt;/td&gt;
&lt;td&gt;最大14枚（オブジェクト最大10個、キャラクター最大4人）&lt;/td&gt;
&lt;td&gt;最大14枚（オブジェクト最大10個、キャラクター最大4人）&lt;/td&gt;
&lt;td&gt;最大14枚（オブジェクト最大6個、キャラクター最大5人）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;動画入力&lt;/td&gt;
&lt;td&gt;はい&lt;/td&gt;
&lt;td&gt;はい&lt;/td&gt;
&lt;td&gt;いいえ&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;無料APIティア&lt;/td&gt;
&lt;td&gt;いいえ（AI Studioでテスト）&lt;/td&gt;
&lt;td&gt;いいえ&lt;/td&gt;
&lt;td&gt;いいえ&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;表には次の詳細が含まれていません。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;トークン計算&lt;/strong&gt;: 2.1とNano Banana 2では、1K画像は1,120出力トークン、2Kは1,680、4Kは2,520です。トークン数は同じですが、2.1はレートが半分のため出力費用も半分です。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;バッチ処理&lt;/strong&gt;: 2.1では、2Kは$0.0252、4Kは$0.0378のバッチ価格もあります。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;思考&lt;/strong&gt;: Gemini 3画像モデルはデフォルトで思考を行い、APIでは無効化できません。最大2枚の中間「思考画像」が生成されますが、課金対象ではありません。2.1でのテキストおよび思考出力は100万トークンあたり$7.50、Nano Banana 2では$3です。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;グラウンディング費用&lt;/strong&gt;: Gemini 3.xモデル全体で月間5,000件の無料検索リクエストが共有され、それ以降は1,000件あたり$14です。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  画像1,000枚あたりの費用
&lt;/h2&gt;

&lt;p&gt;出力費用のみ、標準API、有料ティアの場合です。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;モデル&lt;/th&gt;
&lt;th&gt;0.5K&lt;/th&gt;
&lt;th&gt;1K&lt;/th&gt;
&lt;th&gt;2K&lt;/th&gt;
&lt;th&gt;4K&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Nano Banana 2.1&lt;/td&gt;
&lt;td&gt;n/a&lt;/td&gt;
&lt;td&gt;$33.60&lt;/td&gt;
&lt;td&gt;$50.40&lt;/td&gt;
&lt;td&gt;$75.60&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Nano Banana 2&lt;/td&gt;
&lt;td&gt;$45.00&lt;/td&gt;
&lt;td&gt;$67.00&lt;/td&gt;
&lt;td&gt;$101.00&lt;/td&gt;
&lt;td&gt;$151.00&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Nano Banana 2 Lite&lt;/td&gt;
&lt;td&gt;n/a&lt;/td&gt;
&lt;td&gt;$33.60&lt;/td&gt;
&lt;td&gt;n/a&lt;/td&gt;
&lt;td&gt;n/a&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Nano Banana Pro&lt;/td&gt;
&lt;td&gt;n/a&lt;/td&gt;
&lt;td&gt;$134.00&lt;/td&gt;
&lt;td&gt;$134.00&lt;/td&gt;
&lt;td&gt;$240.00&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;バッチAPIを使うと、2.1は1K、2K、4Kで1,000枚あたりそれぞれ$16.80、$25.20、$37.80まで下がります。&lt;/p&gt;

&lt;p&gt;特に確認すべき数字は次の2つです。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;2.1の4K画像は$0.0756で、Proの1K画像（$0.134）よりも安価です。&lt;/li&gt;
&lt;li&gt;2.1の1K画像は$0.0336で、Nano Banana 2の512pxティア（$0.045）より安価です。正確に512pxが必要な場合だけ0.5Kを維持してください。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  入力が重い編集で費用計算が変わる場合
&lt;/h2&gt;

&lt;p&gt;出力費用だけで判断してはいけません。2.1の入力料金は100万トークンあたり$1.50で、Nano Banana 2の$0.50の3倍です。そのため、多数の参照画像を送る編集ワークロードでは入力費用が増えます。&lt;/p&gt;

&lt;p&gt;Googleの&lt;a href="https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/nano-banana-2-1" rel="noopener noreferrer"&gt;Vertex AIモデルページ&lt;/a&gt;によると、各入力画像は1,120トークンを消費します。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;シナリオ:&lt;/strong&gt; 14枚の参照画像と500トークンのプロンプトを送信し、1K画像を1枚生成する製品撮影パイプライン。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;/th&gt;
&lt;th&gt;Nano Banana 2.1&lt;/th&gt;
&lt;th&gt;Nano Banana 2&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;入力トークン（14 × 1,120 + 500）&lt;/td&gt;
&lt;td&gt;16,180&lt;/td&gt;
&lt;td&gt;16,180&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;入力費用&lt;/td&gt;
&lt;td&gt;$0.0243&lt;/td&gt;
&lt;td&gt;$0.0081&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;1K出力&lt;/td&gt;
&lt;td&gt;$0.0336&lt;/td&gt;
&lt;td&gt;$0.0670&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;リクエストあたりの合計&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;$0.0579&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;$0.0751&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;1,000リクエストあたり&lt;/td&gt;
&lt;td&gt;$57.90&lt;/td&gt;
&lt;td&gt;$75.10&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;14枚の画像上限でも2.1が安価ですが、差は50%から約23%まで縮まります。&lt;/p&gt;

&lt;p&gt;転換点も計算できます。各入力トークンは2.1で$0.000001高く、出力費用の削減額は1Kで$0.0334、2Kで$0.0506、4Kで$0.0754です。したがって、2.1のほうが高くなるのは、1リクエストに次の入力トークン数が含まれる場合です。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;1K: 約33,400トークン&lt;/li&gt;
&lt;li&gt;2K: 約50,600トークン&lt;/li&gt;
&lt;li&gt;4K: 約75,400トークン&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;14枚の参照画像だけでは、この水準には到達しません。ただし、以下の条件では近づく可能性があります。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;長い複数ターンの編集セッション&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;previous_interaction_id&lt;/code&gt;で編集を連鎖させる場合、以前のターンが課金対象のコンテキストに追加される可能性があります。各レスポンスの利用状況データで入力トークン数を監視してください。フル参照を使う10ターンのセッションでは、1Kのしきい値を超える可能性があります。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;思考およびテキストトークン&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
2.1は100万トークンあたり$7.50、Nano Banana 2は$3です。思考は無効化できないため、重い推論を引き起こすプロンプトでは差が縮まります。&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;長い履歴を持つ1K編集を運用している場合は、切り替える前に実トラフィックで両モデルを測定してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  Nano Banana 2 Liteが適合するケース
&lt;/h2&gt;

&lt;p&gt;Liteは予算重視の選択肢です。Googleはこれを「最速で最も安価なGemini画像モデル」と呼び、入力トークン100万あたり$0.25、1K画像あたり$0.0336としています。1Kの出力単価は2.1と同じです。&lt;/p&gt;

&lt;p&gt;ただし、Liteには次の制約があります。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;出力は1Kのみ&lt;/li&gt;
&lt;li&gt;Google検索グラウンディングをサポートしない&lt;/li&gt;
&lt;li&gt;複数の参照入力や複数ターン編集には「最適化されていない」&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;大量のシンプルな1Kテキスト画像生成では、Liteと2.1の画像単価は同じですが、Liteの入力費用は2.1の6分の1です。2K・4K、グラウンディング、反復編集が必要になった時点で2.1へ移行してください。&lt;/p&gt;

&lt;p&gt;Googleは、現在レガシーとなっている初代Nano Banana（&lt;code&gt;gemini-2.5-flash-image&lt;/code&gt;）からの移行先としてもLiteを推奨しています。以前の移行については、&lt;a href="https://apidog.com/jp/blog/nano-banana-1-vs-nano-banana-2?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 1 vs Nano Banana 2の比較&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  Nano Banana Proが依然として理にかなうケース
&lt;/h2&gt;

&lt;p&gt;GoogleはProを「最も複雑な視覚タスクのためのプレミアムな選択肢」と説明しています。最高のワールドナレッジ、高度なローカライゼーション、正確なブランド一貫性、精密なクリエイティブコントロールを備えたプロフェッショナルアセット制作向けに最適化されているとしています。プロンプティングガイドでも、プロフェッショナル用途のテキスト量が多いアセットにはProを推奨しています。&lt;/p&gt;

&lt;p&gt;ただし、これらはポジショニングに関する記述であり、公開ベンチマークではありません。Proと2.1の比較データは公開されていないため、自分の要件と予算で検証してください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;既存のProワークフローが要件を満たしている、または5キャラクターの一貫性制限に依存している場合は、&lt;strong&gt;Proを維持&lt;/strong&gt;してください。&lt;/li&gt;
&lt;li&gt;大量処理でProを使っている場合は、まず&lt;strong&gt;2.1をテスト&lt;/strong&gt;してください。4Kでは2.1はProの約3分の1の価格です（$0.0756 vs $0.24）。1Kでは約4分の1です。&lt;/li&gt;
&lt;li&gt;Proは画像検索グラウンディングおよび動画入力を&lt;strong&gt;利用できません&lt;/strong&gt;。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Proのリクエスト形式については、&lt;a href="https://apidog.com/jp/blog/nano-banana-pro-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana Pro APIガイド&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  移行に関する注意点
&lt;/h2&gt;

&lt;p&gt;Nano Banana 2から2.1への移行は、基本的には&lt;code&gt;model&lt;/code&gt;文字列を変更するだけです。エンドポイント、&lt;code&gt;response_format&lt;/code&gt;、&lt;code&gt;google_search&lt;/code&gt;ツールは同じです。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="nt"&gt;-s&lt;/span&gt; &lt;span class="nt"&gt;-X&lt;/span&gt; POST &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/interactions"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"x-goog-api-key: &lt;/span&gt;&lt;span class="nv"&gt;$GEMINI_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "gemini-nano-banana-2.1",
    "input": [
      {
        "type": "text",
        "text": "A studio product photo of a ceramic mug on a walnut desk"
      }
    ],
    "response_format": {
      "type": "image",
      "mime_type": "image/png",
      "aspect_ratio": "16:9",
      "image_size": "2K"
    }
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;本番トラフィックを切り替える前に、次を確認してください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;画像サイズ&lt;/strong&gt;: いずれかの呼び出しで&lt;code&gt;"image_size": "512px"&lt;/code&gt;または0.5Kを指定している場合、&lt;code&gt;gemini-3.1-flash-image&lt;/code&gt;を維持してください。2.1はこのサイズをサポートしていません。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;大文字のK&lt;/strong&gt;: &lt;code&gt;"2K"&lt;/code&gt;は有効です。&lt;code&gt;"2k"&lt;/code&gt;はすべてのモデルで拒否されます。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;画像検索&lt;/strong&gt;: &lt;code&gt;google_search&lt;/code&gt;ツールに&lt;code&gt;"search_types": ["web_search", "image_search"]&lt;/code&gt;を追加し、Googleが要求する返却済み検索候補を表示してください。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;予算&lt;/strong&gt;: 同じトラフィックでは、入力費用は約3倍、画像出力費用は半分になります。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;無料ティア&lt;/strong&gt;: これらのモデルに無料のGemini APIティアはありません。&lt;a href="https://apidog.com/jp/blog/how-to-use-nano-banana-2-1-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2.1を無料で利用する方法&lt;/a&gt;を参照してください。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;マルチターン編集とグラウンディングを含む完全なコードウォークスルーは、&lt;a href="https://apidog.com/jp/blog/nano-banana-2-1-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2.1 APIガイド&lt;/a&gt;を参照してください。変更点の概要は、&lt;a href="https://apidog.com/jp/blog/nano-banana-2-1?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2.1の概要&lt;/a&gt;で確認できます。&lt;/p&gt;

&lt;h2&gt;
  
  
  Apidogで3つのモデルをA/Bテストする方法
&lt;/h2&gt;

&lt;p&gt;公開ベンチマークがないため、重要な比較は自分のプロンプトで行うことです。&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;を使うと、専用のテストハーネスを実装せずに比較できます。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;1つのリクエストを保存する&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;POST https://generativelanguage.googleapis.com/v1beta/interactions&lt;/code&gt;を作成します。APIキーは環境変数として保存し、ヘッダーに&lt;code&gt;x-goog-api-key: {{GEMINI_API_KEY}}&lt;/code&gt;を設定します。上記のJSONボディを貼り付け、参照画像がある場合は&lt;code&gt;{"type": "image", "mime_type": "image/jpeg", "data": "&amp;lt;BASE64&amp;gt;"}&lt;/code&gt;形式で追加します。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;リクエストを2回複製する&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;model&lt;/code&gt;フィールドだけを次の3モデルに変更します。&lt;br&gt;
&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;   gemini-nano-banana-2.1
   gemini-3.1-flash-image
   gemini-3-pro-image
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;プロンプト、参照画像、アスペクト比、&lt;code&gt;image_size&lt;/code&gt;はすべて同じにしてください。変数をモデルだけに限定します。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;送信して比較する&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Apidogで各レスポンスのステータス、レイテンシ、サイズを確認します。各base64画像をデコードし、並べてレビューしてください。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;回帰チェックとして保存する&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;200&lt;/code&gt;ステータスと空でない画像をアサートします。リクエストをテストシナリオにグループ化し、Googleがモデルを更新したときに再実行してください。&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;1件ではなく、実際のプロンプトを10〜20件実行してください。その後、各モデルの画像単価に月間ボリュームを掛けて費用を比較します。&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidogを無料でダウンロード&lt;/a&gt;して試してみましょう。&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Nano Banana 2.1はNano Banana 2よりも優れていますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Googleは2.1が「あらゆる面で以前のモデルを上回る」としており、視覚デザイン、マスクベースの編集、主題の一貫性、より自然な見た目の画像を挙げています。ただし、ベンチマークは公開されていないため、自分のプロンプトで検証してください。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Nano Banana 2.1はNano Banana 2よりも安価ですか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
画像あたりでは安価です。1K、2K、4Kでは半額です。一方で入力トークンあたりでは安価ではありません。2.1は100万トークンあたり$1.50、Nano Banana 2は$0.50です。多くのワークロードでは、出力費用の削減が入力費用の増加を上回ります。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Nano Banana Proを2.1に置き換えるべきですか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
まずテストしてください。2.1は1KでProの約4分の1の費用ですが、Googleは引き続きProをプレミアムモデルとして位置付けています。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Nano Banana 2.1を無料で利用できますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Gemini APIでは利用できません。料金ページにはNano Bananaモデルの無料ティアは記載されていませんが、Google AI Studioで2.1をテストすることはできます。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;参照画像は何枚送信できますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
3モデルすべてで最大14枚です。2.1とNano Banana 2はオブジェクト最大10個、キャラクター最大4人までの一貫性を保ちます。Proはオブジェクト最大6個、キャラクター最大5人まで対応します。&lt;/p&gt;

&lt;h2&gt;
  
  
  結論
&lt;/h2&gt;

&lt;p&gt;Nano Banana 2.1は、新しいGemini画像ワークロードにおける妥当なデフォルトです。Nano Banana 2と比べて画像あたりの費用は半額で、グラウンディング、動画入力、参照画像の制限は同じです。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;512px出力が必要な場合、または測定済みの長い履歴を持つ編集ではNano Banana 2を使用する&lt;/li&gt;
&lt;li&gt;大量のシンプルな1K画像ではLiteを使用する&lt;/li&gt;
&lt;li&gt;Proはプレミアムな位置付けが要件に合致する場合に維持し、約4倍の費用を払う前に並行テストで価値を検証する&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;まずは実際のプロンプト、参照画像、編集フローを使って並行テストを実行し、品質・レイテンシ・総コストで判断してください。&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Nano Banana 2.1 API 使い方</title>
      <dc:creator>Akira</dc:creator>
      <pubDate>Tue, 06 Oct 2026 17:24:32 +0000</pubDate>
      <link>https://dev.to/aakira/nano-banana-21-api-shi-ifang-3ofk</link>
      <guid>https://dev.to/aakira/nano-banana-21-api-shi-ifang-3ofk</guid>
      <description>&lt;p&gt;Googleは2026年10月6日にNano Banana 2.1をリリースしました。これはGemini APIを通じて&lt;code&gt;gemini-nano-banana-2.1&lt;/code&gt;として呼び出し可能です。Nano Banana 2（Gemini 3.1 Flash Image）のアップデート版であり、視覚品質、マスクスタイル編集、ターン間のキャラクター一貫性が改善されています。また、両モデルが対応するすべての解像度で、Nano Banana 2の半分のコストで画像を生成できます。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;今すぐApidogを試す&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;この記事では、空のターミナルから画像を保存するまでの手順を解説します。さらに、アスペクト比、2K・4K出力、画像編集、マルチターン変更、参照画像、検索グラウンディング、コストも扱います。以下のリクエストはすべて&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;に保存・再実行できるため、Nano Banana 2.1を現在利用しているモデルと比較できます。&lt;/p&gt;

&lt;p&gt;まず背景を確認したい場合は、変更点とGoogleがまだ公開していない情報をまとめた&lt;a href="https://apidog.com/jp/blog/nano-banana-2-1?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2.1とは&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  必要なもの
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;項目&lt;/th&gt;
&lt;th&gt;値&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;ベースURL&lt;/td&gt;
&lt;td&gt;&lt;code&gt;https://generativelanguage.googleapis.com/v1beta&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;認証ヘッダー&lt;/td&gt;
&lt;td&gt;&lt;code&gt;x-goog-api-key: $GEMINI_API_KEY&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;モデルID&lt;/td&gt;
&lt;td&gt;&lt;code&gt;gemini-nano-banana-2.1&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;エンドポイント&lt;/td&gt;
&lt;td&gt;&lt;code&gt;POST /v1beta/interactions&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;解像度&lt;/td&gt;
&lt;td&gt;1K（デフォルト）、2K、4K&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;入力&lt;/td&gt;
&lt;td&gt;テキスト、画像（最大14枚の参照）、動画&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Python SDK&lt;/td&gt;
&lt;td&gt;&lt;code&gt;pip install google-genai&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;JavaScript SDK&lt;/td&gt;
&lt;td&gt;&lt;code&gt;npm install @google/genai&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;以降の例では、Googleの画像生成ドキュメントで2.1向けに使われているInteractions APIを使用します。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ1：Gemini APIキーを取得する
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;a href="https://aistudio.google.com/" rel="noopener noreferrer"&gt;Google AI Studio&lt;/a&gt;を開き、サインインします。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;APIキーを取得&lt;/strong&gt;から、Google Cloudプロジェクト用のキーを作成します。&lt;/li&gt;
&lt;li&gt;プロジェクトで請求を有効化します。Googleの料金ページでは、Nano Banana 2.1の無料枠は「利用不可」と記載されているため、API呼び出しには有料プロジェクトが必要です。&lt;/li&gt;
&lt;li&gt;APIキーを環境変数へ設定します。
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;export &lt;/span&gt;&lt;span class="nv"&gt;GEMINI_API_KEY&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"your-key-here"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Googleは2.1をAI Studio Playgroundにリンクしており、プロンプトの試験には便利です。ただし、無料アカウントでの生成可能回数は公開されていません。&lt;a href="https://apidog.com/jp/blog/how-to-use-nano-banana-2-1-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2.1を無料で使う方法&lt;/a&gt;では利用方法を、&lt;a href="https://apidog.com/jp/blog/google-gemini-api-key-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini APIキーの取得&lt;/a&gt;ではキー設定を詳しく解説しています。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ2：最初の画像を生成する
&lt;/h2&gt;

&lt;h3&gt;
  
  
  curl
&lt;/h3&gt;

&lt;p&gt;まずはREST APIでリクエストを送信します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="nt"&gt;-s&lt;/span&gt; &lt;span class="nt"&gt;-X&lt;/span&gt; POST &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/interactions"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"x-goog-api-key: &lt;/span&gt;&lt;span class="nv"&gt;$GEMINI_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "gemini-nano-banana-2.1",
    "input": [
      {
        "type": "text",
        "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"
      }
    ]
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;レスポンスはJSONです。画像は画像コンテンツブロック内にbase64データとして返るため、保存するにはSDKまたはスクリプトでデコードします。&lt;/p&gt;

&lt;h3&gt;
  
  
  Python
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;from&lt;/span&gt; &lt;span class="n"&gt;google&lt;/span&gt; &lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;genai&lt;/span&gt;
&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;base64&lt;/span&gt;

&lt;span class="n"&gt;client&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;genai&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Client&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;  &lt;span class="c1"&gt;# GEMINI_API_KEY を読み込む
&lt;/span&gt;
&lt;span class="n"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gemini-nano-banana-2.1&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;with&lt;/span&gt; &lt;span class="nf"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;generated_image.png&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;wb&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;as&lt;/span&gt; &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;write&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;base64&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;b64decode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;interaction&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;output_image&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;interaction.output_image&lt;/code&gt;は最後に生成された画像ブロックを返します。&lt;code&gt;data&lt;/code&gt;フィールドはbase64形式なので、ファイルへ書き込む前にデコードしてください。&lt;/p&gt;

&lt;h3&gt;
  
  
  JavaScript
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;GoogleGenAI&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@google/genai&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="k"&gt;as&lt;/span&gt; &lt;span class="nx"&gt;fs&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;node:fs&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;ai&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;GoogleGenAI&lt;/span&gt;&lt;span class="p"&gt;({});&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;ai&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
  &lt;span class="na"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;gemini-nano-banana-2.1&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;input&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;image&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;interaction&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;output_image&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;image&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;fs&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;writeFileSync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;nano-banana.png&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;Buffer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;image&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;base64&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Gemini 3の画像モデルは、描画前に構図を計画します。この処理中に最大2つの一時的な「思考画像」が生成される場合があります。これらには料金が発生せず、APIで思考を無効化することはできません。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ3：アスペクト比、解像度、画像のみの出力を設定する
&lt;/h2&gt;

&lt;p&gt;出力形式は&lt;code&gt;response_format&lt;/code&gt;で制御します。&lt;code&gt;"type": "image"&lt;/code&gt;を指定すると画像だけが返り、会話テキストが含まれないため、レスポンスが小さくなり解析も簡単です。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gemini-nano-banana-2.1&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;A product shot of a matte black coffee grinder on a marble counter&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;response_format&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;mime_type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image/png&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;aspect_ratio&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;16:9&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image_size&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;2K&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;設定時のポイントは次のとおりです。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;image_size&lt;/code&gt;には&lt;code&gt;1K&lt;/code&gt;、&lt;code&gt;2K&lt;/code&gt;、&lt;code&gt;4K&lt;/code&gt;を指定できます。&lt;code&gt;K&lt;/code&gt;は大文字で指定してください。&lt;code&gt;2k&lt;/code&gt;のような小文字は拒否されます。&lt;/li&gt;
&lt;li&gt;Nano Banana 2.1には512pxティアはありません。512pxはNano Banana 2向けの設定です。&lt;/li&gt;
&lt;li&gt;対応アスペクト比は、&lt;code&gt;1:1&lt;/code&gt;、&lt;code&gt;2:3&lt;/code&gt;、&lt;code&gt;3:2&lt;/code&gt;、&lt;code&gt;3:4&lt;/code&gt;、&lt;code&gt;4:3&lt;/code&gt;、&lt;code&gt;4:5&lt;/code&gt;、&lt;code&gt;5:4&lt;/code&gt;、&lt;code&gt;9:16&lt;/code&gt;、&lt;code&gt;16:9&lt;/code&gt;、&lt;code&gt;21:9&lt;/code&gt;、&lt;code&gt;1:4&lt;/code&gt;、&lt;code&gt;4:1&lt;/code&gt;、&lt;code&gt;1:8&lt;/code&gt;、&lt;code&gt;8:1&lt;/code&gt;です。&lt;/li&gt;
&lt;li&gt;2Kの&lt;code&gt;16:9&lt;/code&gt;は2752x1536px、4Kの&lt;code&gt;16:9&lt;/code&gt;は5504x3072pxです。&lt;/li&gt;
&lt;li&gt;テキストと画像の両方が必要な場合は、リストで指定します。
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;response_format&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  ステップ4：既存の画像を編集する
&lt;/h2&gt;

&lt;p&gt;既存画像を編集する場合は、テキスト指示とbase64エンコード済み画像を&lt;code&gt;input&lt;/code&gt;に渡します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;with&lt;/span&gt; &lt;span class="nf"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;living_room.png&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;rb&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;as&lt;/span&gt; &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;image_b64&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;base64&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;b64encode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;read&lt;/span&gt;&lt;span class="p"&gt;()).&lt;/span&gt;&lt;span class="nf"&gt;decode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;utf-8&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="n"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gemini-nano-banana-2.1&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
                &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Using the provided image of a living room, change only the blue sofa &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
                &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;to be a vintage, brown leather chesterfield sofa. Keep the rest of &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
                &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;the room, including the pillows on the sofa and the lighting, unchanged.&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
            &lt;span class="p"&gt;),&lt;/span&gt;
        &lt;span class="p"&gt;},&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;data&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;image_b64&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;mime_type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image/png&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="p"&gt;],&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  マスクファイルなしでマスクスタイルのインペインティングを行う
&lt;/h3&gt;

&lt;p&gt;個別のマスクファイルをアップロードする必要はありません。変更対象を文章で明示します。Googleのテンプレートは次の形式です。&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;提供された画像を使用し、[特定の要素]のみを[新しい要素/説明]に変更してください。元のスタイル、照明、構図を維持し、画像内のその他すべてをまったく同じに保ってください。&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;実装時は次を意識してください。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;変更する要素を1つに絞る。&lt;/li&gt;
&lt;li&gt;置き換える内容を具体的に書く。&lt;/li&gt;
&lt;li&gt;維持すべき要素を明示する。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;「ソファをもっと素敵にする」のような曖昧な指示では、モデルが部屋全体を描き直す可能性があります。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ5：マルチターン編集で反復する
&lt;/h2&gt;

&lt;p&gt;マルチターン編集では、前回のインタラクションIDを&lt;code&gt;previous_interaction_id&lt;/code&gt;として渡します。次のリクエストには、変更したい箇所だけを記述します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;interaction_2&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gemini-nano-banana-2.1&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Update this infographic to be in Spanish. Do not change any other elements of the image.&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;previous_interaction_id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;interaction&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nb"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;response_format&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;mime_type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image/png&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;aspect_ratio&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;16:9&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image_size&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;2K&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;REST APIでは、同じフィールドをリクエストボディに追加します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"previous_interaction_id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"&amp;lt;PREVIOUS_INTERACTION_ID&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;複数回の編集でキャラクターや製品の見た目を維持したい場合は、この方式を使います。Nano Banana 2.1のマルチターンにおけるキャラクター一貫性の改善が活きるポイントです。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ6：最大14枚の参照画像を組み合わせる
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;input&lt;/code&gt;配列へ複数の&lt;code&gt;image&lt;/code&gt;ブロックを追加します。Nano Banana 2.1では、高忠実度オブジェクト画像を最大10枚、キャラクター画像を最大4枚、合計14枚まで指定できます。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gemini-nano-banana-2.1&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;An office group photo of these people, they are making funny faces.&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;},&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;data&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;person_1_b64&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;mime_type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image/png&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;data&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;person_2_b64&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;mime_type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image/png&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;data&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;person_3_b64&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;mime_type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image/png&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="p"&gt;],&lt;/span&gt;
    &lt;span class="n"&gt;response_format&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;aspect_ratio&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;5:4&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image_size&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;2K&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;参照画像は入力トークンとして課金されます。2.1の入力コストはNano Banana 2の3倍であるため、参照画像を多用するワークフローでは、切り替え前に実測でコストを比較してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ7：Google検索で画像をグラウンディングする
&lt;/h2&gt;

&lt;p&gt;天気図や最近のイベントなど、最新の事実に依存する画像では検索ツールを追加します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gemini-nano-banana-2.1&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;A detailed painting of a Timareta butterfly resting on a flower&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;tools&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;google_search&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;search_types&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;web_search&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image_search&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;],&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;{"type": "google_search"}&lt;/code&gt;だけを指定した場合はウェブ検索を利用できます。&lt;code&gt;image_search&lt;/code&gt;を追加すると、モデルはウェブ上の画像を視覚的コンテキストとして利用できます。この機能はNano Banana 2.1とNano Banana 2のみがサポートしています。&lt;/p&gt;

&lt;p&gt;注意点は次のとおりです。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;グラウンディングでは、検索結果に含まれる実在人物の画像は利用できません。&lt;/li&gt;
&lt;li&gt;グラウンディング結果をユーザーへ表示する場合、Googleは&lt;code&gt;google_search_result&lt;/code&gt;ステップで返る&lt;code&gt;search_suggestions&lt;/code&gt;の表示を義務付けています。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  ステップ8：Apidogでテストする
&lt;/h2&gt;

&lt;p&gt;スクリプトは生成処理に適していますが、プロンプト、APIキー、モデル設定を素早く検証するには、保存済みリクエストが便利です。&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;では次の手順でテストできます。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;環境を作成し、APIキー用の&lt;code&gt;GEMINI_API_KEY&lt;/code&gt;変数を追加します。&lt;/li&gt;
&lt;li&gt;次のリクエストを作成します。
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;   POST https://generativelanguage.googleapis.com/v1beta/interactions
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;ヘッダーを追加します。
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;   x-goog-api-key: {{GEMINI_API_KEY}}
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;
&lt;code&gt;model&lt;/code&gt;、&lt;code&gt;input&lt;/code&gt;、&lt;code&gt;response_format&lt;/code&gt;を含むJSONボディを貼り付け、&lt;strong&gt;Send&lt;/strong&gt;をクリックします。&lt;/li&gt;
&lt;li&gt;レスポンス後スクリプトに、ステータスと画像ブロックを検証するアサーションを追加します。
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="nx"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;status is 200&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;to&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;have&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;status&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;

&lt;span class="nx"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;response contains an image block&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;steps&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nx"&gt;steps&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="p"&gt;[];&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;hasImage&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;steps&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;some&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
      &lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;type&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;model_output&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;
      &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;s&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;content&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="p"&gt;[]).&lt;/span&gt;&lt;span class="nf"&gt;some&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;c&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;c&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;type&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;image&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;c&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;);&lt;/span&gt;

  &lt;span class="nx"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;hasImage&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;to&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;be&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;リクエストを複製し、&lt;code&gt;model&lt;/code&gt;を&lt;code&gt;gemini-3.1-flash-image&lt;/code&gt;へ変更します。&lt;/li&gt;
&lt;li&gt;同じプロンプトで両方のリクエストを実行します。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;これでNano Banana 2.1とNano Banana 2を並行比較できます。実行ごとのステータス、応答時間、レスポンスサイズを確認してください。より広い機能比較は&lt;a href="https://apidog.com/jp/blog/nano-banana-2-1-vs-nano-banana-2-vs-pro?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2.1 vs Nano Banana 2 vs Pro&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  コスト
&lt;/h2&gt;

&lt;p&gt;以下は、2026年10月7日時点のGoogle料金ページに基づく有料ティアの料金です。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;モデル&lt;/th&gt;
&lt;th&gt;入力 / 1M&lt;/th&gt;
&lt;th&gt;1K画像&lt;/th&gt;
&lt;th&gt;2K画像&lt;/th&gt;
&lt;th&gt;4K画像&lt;/th&gt;
&lt;th&gt;バッチ 1K&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Nano Banana 2.1&lt;/td&gt;
&lt;td&gt;$1.50&lt;/td&gt;
&lt;td&gt;$0.0336&lt;/td&gt;
&lt;td&gt;$0.0504&lt;/td&gt;
&lt;td&gt;$0.0756&lt;/td&gt;
&lt;td&gt;$0.0168&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Nano Banana 2&lt;/td&gt;
&lt;td&gt;$0.50&lt;/td&gt;
&lt;td&gt;$0.067&lt;/td&gt;
&lt;td&gt;$0.101&lt;/td&gt;
&lt;td&gt;$0.151&lt;/td&gt;
&lt;td&gt;$0.034&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Nano Banana Pro&lt;/td&gt;
&lt;td&gt;$2.00&lt;/td&gt;
&lt;td&gt;$0.134&lt;/td&gt;
&lt;td&gt;$0.134&lt;/td&gt;
&lt;td&gt;$0.24&lt;/td&gt;
&lt;td&gt;$0.067&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Nano Banana 2.1の画像出力は100万トークンあたり30ドルです。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;1K画像: 1,120トークン&lt;/li&gt;
&lt;li&gt;2K画像: 1,680トークン&lt;/li&gt;
&lt;li&gt;4K画像: 2,520トークン&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;テキストと思考の出力は100万トークンあたり7.50ドルです。検索グラウンディングには、Gemini 3.xモデル全体で共有される月5,000件の無料リクエストが含まれ、それ以降は1,000件ごとに14ドルかかります。&lt;/p&gt;

&lt;h3&gt;
  
  
  コスト計算例
&lt;/h3&gt;

&lt;p&gt;短いテキストプロンプト（各100入力トークン程度）から2Kの製品画像を1,000枚生成する場合:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;出力: &lt;code&gt;1,000 x $0.0504 = $50.40&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;入力: &lt;code&gt;100,000トークン x $1.50 / 1M = $0.15&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;合計: 約&lt;strong&gt;$50.55&lt;/strong&gt;。これに思考テキストトークンが加算されます。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Nano Banana 2で同じ処理を行う場合は約101ドルです。Batch APIを使うと、2.1の2K画像価格は0.0252ドルまで下がるため、出力コストは25.20ドルになります。&lt;/p&gt;

&lt;p&gt;バッチジョブはより高いレート制限を利用できる一方、処理完了まで最大24時間かかります。Nano Banana 2の料金詳細は、&lt;a href="https://apidog.com/jp/blog/nano-banana-2-api-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2 API料金内訳&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  よくあるエラー
&lt;/h2&gt;

&lt;p&gt;以下はGemini APIで一般的に発生するエラーであり、Nano Banana 2.1固有のものではありません。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;エラー&lt;/th&gt;
&lt;th&gt;考えられる原因&lt;/th&gt;
&lt;th&gt;修正&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;400 INVALID_ARGUMENT&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;image_size&lt;/code&gt;が小文字、未対応の比率、不正な&lt;code&gt;input&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;2k&lt;/code&gt;ではなく&lt;code&gt;2K&lt;/code&gt;を使う。対応比率と入力形式を確認する。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;403 PERMISSION_DENIED&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;APIキーが不正、またはプロジェクトで請求未設定&lt;/td&gt;
&lt;td&gt;APIキーを確認し、請求を有効化する。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;404 NOT_FOUND&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;モデルIDの入力ミス&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;gemini-nano-banana-2.1&lt;/code&gt;を正確に指定する。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;429 RESOURCE_EXHAUSTED&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;レート制限に到達&lt;/td&gt;
&lt;td&gt;バックオフして再試行するか、バッチを使用する。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;500&lt;/code&gt; / &lt;code&gt;503&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;一時的なサーバー障害&lt;/td&gt;
&lt;td&gt;指数関数的バックオフで再試行する。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;200だが画像なし&lt;/td&gt;
&lt;td&gt;プロンプトがブロックされた、またはテキストのみで応答された&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;"type": "image"&lt;/code&gt;を設定し、プロンプトを見直す。&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;指数関数的バックオフは、たとえば次のように実装できます。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;time&lt;/span&gt;

&lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;attempt&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="nf"&gt;range&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;5&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
    &lt;span class="k"&gt;try&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="n"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
            &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gemini-nano-banana-2.1&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Generate a product image&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="k"&gt;break&lt;/span&gt;
    &lt;span class="k"&gt;except&lt;/span&gt; &lt;span class="nb"&gt;Exception&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;attempt&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
            &lt;span class="k"&gt;raise&lt;/span&gt;
        &lt;span class="n"&gt;time&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;sleep&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt; &lt;span class="o"&gt;**&lt;/span&gt; &lt;span class="n"&gt;attempt&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  よくある質問
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Nano Banana 2.1 APIに無料枠はありますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
いいえ。GoogleはAPIの無料枠を「利用不可」と記載しています。AI Studio Playgroundは2.1にリンクされていますが、無料利用の上限は公開されていません。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;2.1はNano Banana 2のドロップイン代替ですか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
多くの場合は可能です。モデルIDを&lt;code&gt;gemini-nano-banana-2.1&lt;/code&gt;に置き換えてください。ただし、512pxティアは利用できず、入力トークンも高価になるため、参照画像を多用する編集ではコストを確認してください。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;生成画像には透かしが入りますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
はい。すべての出力にはSynthID透かしが含まれます。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;動画から画像を生成できますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
はい。2.1はテキストプロンプトとともに、YouTube URLのような&lt;code&gt;video&lt;/code&gt;入力ブロックを受け入れます。&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;古いNano Banana 2 APIガイドはまだ使えますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
概念は引き続き適用できます。旧モデルについては&lt;a href="https://apidog.com/jp/blog/nano-banana-2-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2 APIガイド&lt;/a&gt;を参照してください。&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  まとめ
&lt;/h2&gt;

&lt;p&gt;Nano Banana 2.1は、Nano Banana 2の画像あたり半分の価格で、同じInteractions API形式を使いながらより良い画像を約束します。&lt;/p&gt;

&lt;p&gt;まずは課金を有効化したAPIキーを設定し、1枚の画像を生成してください。次に、ステータスと画像ブロックを検証するアサーション付きでリクエストを&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;へ保存します。最後に古いモデルIDでリクエストを複製して比較すれば、Nano Banana 2.1へ切り替える価値があるかを短時間で判断できます。&lt;/p&gt;

</description>
    </item>
    <item>
      <title>ナノバナナ 2.1 を無料で使う方法</title>
      <dc:creator>Akira</dc:creator>
      <pubDate>Tue, 06 Oct 2026 17:23:03 +0000</pubDate>
      <link>https://dev.to/aakira/nanobanana-21-wowu-liao-deshi-ufang-fa-lpg</link>
      <guid>https://dev.to/aakira/nanobanana-21-wowu-liao-deshi-ufang-fa-lpg</guid>
      <description>&lt;p&gt;Googleは2026年10月6日、Nano Banana 2.1をリリースしました。Google AI Studioアカウントからの投稿では、この画像モデルが「これまでのモデルをあらゆる面で凌駕している」と述べられ、「ai.studioで今日から試してみてください」と呼びかけました。ほとんどの人が最初に尋ねた質問は、「無料ですか？」でした。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;今すぐApidogを試す&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;正直な答えは「部分的」です。Gemini APIには2.1の無料枠がありません。Google AI Studioは無料で利用できますが、無料アカウントでどれだけの2.1が利用できるかはGoogleから発表されていません。GeminiアプリとGoogle Flowは無料の画像生成を提供していますが、どちらのヘルプページにもまだ2.1は掲載されていません。&lt;/p&gt;

&lt;p&gt;このガイドでは、利用可能なすべてのルートを確認し、無料利用が終わった場合の最も安価な有料パスも整理します。&lt;/p&gt;

&lt;p&gt;コードからモデルを呼び出す場合は、再試行で無駄な料金を発生させずにリクエストを検証する方法も必要です。&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;を使うと、リクエストの保存、環境変数によるキー管理、レスポンス検証をまとめて行えます。&lt;/p&gt;

&lt;h2&gt;
  
  
  要するに：2026年10月7日時点での全ルート
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;ルート&lt;/th&gt;
&lt;th&gt;無料ですか？&lt;/th&gt;
&lt;th&gt;制限&lt;/th&gt;
&lt;th&gt;最適な用途&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Google AI Studioプレイグラウンド&lt;/td&gt;
&lt;td&gt;AI Studioは無料。2.1への無料アクセスは未確認&lt;/td&gt;
&lt;td&gt;無料プランでは「控えめなクォータ」が得られるが、具体的な数値は非公開&lt;/td&gt;
&lt;td&gt;支払い前にプロンプトを試す&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Gemini API無料枠&lt;/td&gt;
&lt;td&gt;いいえ&lt;/td&gt;
&lt;td&gt;「利用不可」&lt;/td&gt;
&lt;td&gt;なし&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Geminiアプリ&lt;/td&gt;
&lt;td&gt;2.1は未確認&lt;/td&gt;
&lt;td&gt;Nano Banana 2は全ユーザーが利用可能&lt;/td&gt;
&lt;td&gt;カジュアルな画像&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Google Flow&lt;/td&gt;
&lt;td&gt;2.1は未確認&lt;/td&gt;
&lt;td&gt;Nano Banana 2 Liteは無料&lt;/td&gt;
&lt;td&gt;動画プロジェクト用の画像&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Google Cloud $300トライアル（Vertex AI）&lt;/td&gt;
&lt;td&gt;可能性あり、未確認&lt;/td&gt;
&lt;td&gt;90日間、請求アカウントが必要&lt;/td&gt;
&lt;td&gt;新規Google Cloudアカウント&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;サードパーティサイト&lt;/td&gt;
&lt;td&gt;検証済みはなし&lt;/td&gt;
&lt;td&gt;不明&lt;/td&gt;
&lt;td&gt;推奨しない&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;バッチAPI（有料）&lt;/td&gt;
&lt;td&gt;いいえ。ただし安価&lt;/td&gt;
&lt;td&gt;1K画像あたり$0.0168、最大24時間の処理時間&lt;/td&gt;
&lt;td&gt;一括生成&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  ルート1：Google AI Studio、最も可能性の高い無料オプション
&lt;/h2&gt;

&lt;p&gt;Google AI StudioはGeminiモデルのWebプレイグラウンドであり、Googleがリリース日にユーザーを誘導した場所です。Gemini APIの料金ページにある2.1のカードにも「Google AI Studioで試す」というリンクがあります。&lt;/p&gt;

&lt;p&gt;料金ページには「Google AI Studioの利用は、すべての利用可能地域で無料です」と記載されています。請求に関するFAQには、「有料機能へのアクセスに有料APIキーをリンクしない限り、無料のままである」という条件が追加されています。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fy3vxkimytzdj0cwcqiue.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fy3vxkimytzdj0cwcqiue.jpg" alt="Nano Banana 2.1のポスター" width="800" height="1071"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;注意点はクォータです。GoogleのAIプランページでは、無料アカウントには「基本的な制限とアクセス」を伴う「控えめなクォータ」が与えられると説明されています。Google AI Proでは、より高いクォータと「Gemini Pro、Nano Banana、Lyriaのようなプレミアムモデルへのアクセス」が提供されます。&lt;/p&gt;

&lt;p&gt;同ページには、ProとUltraが「Google AI Studioプレイグラウンドで有料モデルとより高いレート制限を解除する」とも記載されています。ただし、Googleは無料アカウントで2.1を実行できるか、何枚の画像を生成できるかについては明言していません。&lt;/p&gt;

&lt;h3&gt;
  
  
  試す手順
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;code&gt;ai.studio&lt;/code&gt; にサインインします。&lt;/li&gt;
&lt;li&gt;プレイグラウンドを開きます。&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;Gemini Nano Banana 2.1&lt;/code&gt; を選択します。&lt;/li&gt;
&lt;li&gt;プロンプトを実行します。&lt;/li&gt;
&lt;li&gt;画像が生成されれば、そのアカウントではGoogleのクォータ内で無料アクセスが可能です。&lt;/li&gt;
&lt;li&gt;アップグレードまたは有料キーのリンクが表示された場合、そのアカウントでは無料ルートを利用できません。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;a href="https://apidog.com/jp/blog/how-to-use-google-ai-studio-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Google AI Studioを無料で使う方法&lt;/a&gt;では、プレイグラウンドの使い方を詳しく解説しています。&lt;/p&gt;

&lt;p&gt;次の2点にも注意してください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;無料利用はGoogleのモデルのトレーニングに役立ちます。&lt;/strong&gt; 料金ページでは、無料枠のデータは「製品改善に使用：はい」、有料枠のデータは「いいえ」と記載されています。クライアントの写真や未公開の製品画像は、無料アカウントにアップロードしないでください。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;プレイグラウンドへのアクセスはAPIアクセスではありません。&lt;/strong&gt; Googleは、AIプランの特典は「Google AI Studio Webインターフェース内でのみ適用される」と説明しています。コードから利用する場合は、有料APIを使用します。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  ルート2：Gemini APIの無料枠（存在しない）
&lt;/h2&gt;

&lt;p&gt;料金ページでは、&lt;code&gt;gemini-nano-banana-2.1&lt;/code&gt; の無料枠は入力・出力ともに「利用不可」と記載されています。Nano Banana 2、2 Lite、Proも同様です。&lt;/p&gt;

&lt;p&gt;つまり、無料のAPIキーでは2.1の画像を生成できません。課金を有効にする必要があります。新規アカウントの場合、請求に関するFAQでは、アップグレードに「最低5ドルのクレジットを前払いする」必要があるとされています。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/jp/blog/google-gemini-api-key-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini APIキーを無料で取得する&lt;/a&gt;ための手順は、テキストモデルには引き続き有効です。ただし、2.1の画像生成には適用されません。&lt;/p&gt;

&lt;h2&gt;
  
  
  ルート3：Geminiアプリ（2.1は未確認）
&lt;/h2&gt;

&lt;p&gt;GoogleのGeminiヘルプページには、全ユーザー向けのNano Banana 2と、Google AI Plus以上のユーザー向けのNano Banana Proが記載されています。2.1については言及されていません。&lt;/p&gt;

&lt;p&gt;Nokia Power Userは10月6日、2.1が「Geminiアプリ内で直接利用可能になり始めた」と報じましたが、Googleはこれを確認していません。&lt;/p&gt;

&lt;p&gt;モデル名にこだわらず画像を生成したいだけなら、Nano Banana 2を搭載した無料のGeminiアプリを利用できます。&lt;a href="https://apidog.com/jp/blog/use-nano-banana-2-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2の無料ガイド&lt;/a&gt;も参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  ルート4：Google Flow（2.1は未確認）
&lt;/h2&gt;

&lt;p&gt;GoogleのAIクリエイティブスタジオであるFlowは、2.1が最初に登場した場所です。Googleがモデルを一時的に停止し、翌日に正式リリースする前の10月5日に、ユーザーがモデルピッカーでそれを見つけました。&lt;/p&gt;

&lt;p&gt;Flowのヘルプページでは、Nano Banana 2 Liteを「無料で利用可能なデフォルトモデル」、Nano Banana 2を標準モデル、ProをAI Ultra加入者向けのデフォルトとしています。10月7日現在、2.1はリストにありません。&lt;/p&gt;

&lt;p&gt;報告には矛盾があります。Nokia Power Userは、Flowでの2.1生成が「標準のサブスクリプションクレジットを消費する」と述べています。一方、OrcaRouterは、クレジットがゼロと表示されたユーザーのスクリーンショットについて、そのアカウントのプランを反映したものであり、公式料金ではないと指摘しています。&lt;/p&gt;

&lt;p&gt;生成前に、Flowのモデルピッカーでクレジット費用を確認してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  ルート5：Vertex AIでのGoogle Cloudトライアルクレジット（未確認）
&lt;/h2&gt;

&lt;p&gt;Nano Banana 2.1は、Google CloudのGemini Enterprise Agent Platform（旧Vertex AI）にもモデルページがあり、従量課金制とプロビジョニングされたスループットの選択肢があります。&lt;/p&gt;

&lt;p&gt;新規のGoogle Cloud顧客は、90日後に失効する300ドルのウェルカムクレジットを受け取ることができます。&lt;/p&gt;

&lt;p&gt;確認されている点は次のとおりです。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;請求に関するFAQでは、「2026年3月より、Gemini APIの利用料金は、300ドルのGoogle Cloud無料トライアルプログラムから具体的に除外されます」と説明されています。&lt;/li&gt;
&lt;li&gt;無料トライアルページ（2026年10月5日更新）では、このクレジットは「AI StudioでのGemini APIの費用には充当できない」と記載されています。また、マネージドAPIとして提供されるパートナーモデルにも使用できません。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;どちらのページも、Enterprise Agent Platform上で提供されるGoogle自身のモデルを明示的には除外していません。そのため、クレジットが2.1に適用される可能性はあります。&lt;/p&gt;

&lt;p&gt;ただし、Googleのページはこのモデルについて適用を確認していません。試す場合は少数のテスト呼び出しを実行し、Cloudの請求レポートでクレジットが適用されたかを確認してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  ルート6：サードパーティサイト
&lt;/h2&gt;

&lt;p&gt;Nano Bananaの名前を使用しているサイトは、すでに2.1のページを公開しており、一部では無料生成を宣伝しています。&lt;/p&gt;

&lt;p&gt;ただし、それらがGoogleの2.1モデルを実行しているか、アップロードされたデータをどのように扱っているかは確認できませんでした。いずれもGoogle製品ではありません。&lt;/p&gt;

&lt;p&gt;試す場合でも、個人的な画像や機密性の高い画像はアップロードしないでください。&lt;/p&gt;

&lt;h2&gt;
  
  
  最も安価な有料ルート：バッチAPI、画像1枚あたり$0.0168
&lt;/h2&gt;

&lt;p&gt;2.1の画像出力は、スタンダードでは100万トークンあたり30ドルかかり、1K画像は1,120トークンです。バッチAPIでは、その料金が半額になります。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;解像度&lt;/th&gt;
&lt;th&gt;スタンダード&lt;/th&gt;
&lt;th&gt;バッチ&lt;/th&gt;
&lt;th&gt;1ドルあたりの画像数（バッチ）&lt;/th&gt;
&lt;th&gt;5ドルあたりの画像数（バッチ）&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;1K&lt;/td&gt;
&lt;td&gt;$0.0336&lt;/td&gt;
&lt;td&gt;$0.0168&lt;/td&gt;
&lt;td&gt;約59&lt;/td&gt;
&lt;td&gt;約297&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2K&lt;/td&gt;
&lt;td&gt;$0.0504&lt;/td&gt;
&lt;td&gt;$0.0252&lt;/td&gt;
&lt;td&gt;約39&lt;/td&gt;
&lt;td&gt;約198&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4K&lt;/td&gt;
&lt;td&gt;$0.0756&lt;/td&gt;
&lt;td&gt;$0.0378&lt;/td&gt;
&lt;td&gt;約26&lt;/td&gt;
&lt;td&gt;約132&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;最低5ドルの前払いにより、バッチレートで約297枚の1K画像を生成できます。Nano Banana 2はスタンダードで1K画像あたり0.067ドルかかるため、2.1は共有されるすべての解像度でその半額です。&lt;/p&gt;

&lt;p&gt;利用時は次の3点を把握しておいてください。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;入力コストは高くなります。&lt;/strong&gt; 入力トークン100万個あたり1.50ドルで、Nano Banana 2の3倍です。複数の参照画像（最大14枚）を使用した編集では、コストが増えます。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;テキストと推論の出力&lt;/strong&gt;は、100万トークンあたり7.50ドルです。画像のみの応答形式では、テキスト応答は削除されます。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;バッチは遅いです。&lt;/strong&gt; Googleのドキュメントには「最大24時間の処理時間」と記載されています。リアルタイム機能ではなく、一括アセット生成に使ってください。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;モデルの比較は&lt;a href="https://apidog.com/jp/blog/nano-banana-2-1-vs-nano-banana-2-vs-pro?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2.1 vs Nano Banana 2 vs Pro&lt;/a&gt;、コード実装は&lt;a href="https://apidog.com/jp/blog/nano-banana-2-1-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2.1 APIガイド&lt;/a&gt;を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  クレジットを無駄にせずAPIをテストする
&lt;/h2&gt;

&lt;p&gt;2.1への呼び出しが成功するたびに課金されます。&lt;/p&gt;

&lt;p&gt;Googleの請求に関するFAQによると、&lt;code&gt;400&lt;/code&gt; または &lt;code&gt;500&lt;/code&gt; で失敗したリクエストはトークンに対して課金されません。ただし、クォータには計上されるため、不注意な再試行は時間とレート制限を消費します。&lt;/p&gt;

&lt;p&gt;まず、GoogleのREST例を実行できる状態にします。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="nt"&gt;-s&lt;/span&gt; &lt;span class="nt"&gt;-X&lt;/span&gt; POST &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/interactions"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"x-goog-api-key: &lt;/span&gt;&lt;span class="nv"&gt;$GEMINI_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "gemini-nano-banana-2.1",
    "input": [
      {
        "type": "text",
        "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"
      }
    ]
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Apidogでの設定手順
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;新しいリクエストに&lt;strong&gt;cURLコマンドをインポート&lt;/strong&gt;します。ApidogがURL、ヘッダー、ボディを自動入力します。これを「既知の正常なリファレンス」として保存します。&lt;/li&gt;
&lt;li&gt;APIキーを&lt;strong&gt;環境変数&lt;/strong&gt;（&lt;code&gt;GEMINI_API_KEY&lt;/code&gt;）として保存し、&lt;code&gt;x-goog-api-key&lt;/code&gt; ヘッダーから参照します。保存済みリクエストにキーを含めずに済み、テスト環境と本番環境を切り替えやすくなります。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;アサーションを追加&lt;/strong&gt;します。少なくとも&lt;code&gt;200&lt;/code&gt;ステータスと、レスポンスボディに画像ブロックが含まれることを検証してください。最初の成功レスポンスの生JSONを確認し、正確なフィールドパスを指定します。&lt;/li&gt;
&lt;li&gt;1K、2K、参照画像編集の&lt;strong&gt;バリアントを保存&lt;/strong&gt;します。設定を毎回書き換えずに、意図した条件でコストを比較できます。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Apidogが画像生成を無料にするわけではありません。送信ごとに課金対象の呼び出しになります。Apidogは、その呼び出しに関する設定ミスや当て推量を減らすためのツールです。&lt;/p&gt;

&lt;h2&gt;
  
  
  よくある質問
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Nano Banana 2.1は無料ですか？&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Gemini APIでは無料枠が「利用不可」であるため、無料ではありません。AI Studioの利用は無料ですが、Googleは2.1の無料クォータを確認していません。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Geminiアプリで2.1は無料ですか？&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;未確認です。Googleのヘルプページには全ユーザー向けのNano Banana 2が記載されていますが、2.1には言及されていません。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Flowは2.1に対してクレジットを請求しますか？&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Googleは明言していません。Flowのモデルピッカーでコストを確認してください。Nano Banana 2 LiteはFlowで無料です。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;300ドルのGoogle Cloudクレジットは使えますか？&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Gemini APIやAI Studioでは使えません。Enterprise Agent Platformでは適用される可能性がありますが、2.1については未確認です。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;大量の画像を生成する最も安価な方法は？&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;バッチAPIです。1K画像あたり0.0168ドルで、1ドルあたり約59枚を生成できます。&lt;/p&gt;

&lt;h2&gt;
  
  
  結論
&lt;/h2&gt;

&lt;p&gt;Google AI Studioでは、Nano Banana 2.1を無料で試せる可能性が最も高いといえます。これはGoogle自身が推奨しているルートです。&lt;/p&gt;

&lt;p&gt;ただし、無料利用を前提とした運用計画は立てないでください。Googleは無料クォータを公開しておらず、AIプランページではNano Bananaをサブスクライバー向けのプレミアムモデルとしてリストしています。GeminiアプリとFlowには無料の画像モデルがありますが、2.1はいずれのドキュメントにもまだ記載されていません。&lt;/p&gt;

&lt;p&gt;無料利用が終わった場合、バッチAPIはNano Banana 2の半額で、1ドルあたり約59枚の1K画像を提供します。&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;でリクエストを一度設定し、キーを環境変数に保存し、アサーションで設定ミスを検出してから本格的に料金を使うようにしましょう。&lt;/p&gt;

&lt;p&gt;モデルの変更点については、&lt;a href="https://apidog.com/jp/blog/nano-banana-2-1?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2.1とは何か&lt;/a&gt;を参照してください。&lt;/p&gt;

</description>
    </item>
    <item>
      <title>ナノバナナ2.1 リリース：ナノバナナ2の半額、テキスト機能が遂に改善</title>
      <dc:creator>Akira</dc:creator>
      <pubDate>Tue, 06 Oct 2026 17:21:29 +0000</pubDate>
      <link>https://dev.to/aakira/nanobanana21-ririsunanobanana2noban-e-tekisutoji-neng-gasui-nigai-shan-5g1d</link>
      <guid>https://dev.to/aakira/nanobanana21-ririsunanobanana2noban-e-tekisutoji-neng-gasui-nigai-shan-5g1d</guid>
      <description>&lt;p&gt;Googleは2026年10月6日にNano Banana 2.1を静かにリリースしました。ローンチに関するブログ投稿もベンチマークチャートもありませんでした。このモデルは10月5日にGoogle Flowのモデルピッカーに表示され、一度消えた後、翌日には&lt;a href="https://x.com/GoogleAIStudio/status/2107501303890915550" rel="noopener noreferrer"&gt;@GoogleAIStudio&lt;/a&gt;からの短い投稿とともに再登場し、「以前のモデルをあらゆる面で上回る」と述べられました。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;今すぐApidogを試す&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;画像生成に料金を支払っている人にとって重要なのは、料金ページです。Nano Banana 2.1は、Nano Banana 2と共通のすべての解像度において、画像1枚あたりのコストが半分になり、Googleのドキュメントではアップグレード点として「正確なテキストレンダリング」が挙げられています。何が変わり、いくらかかり、そしてローンチ投稿で触れられていない注意点について説明します。&lt;/p&gt;

&lt;h2&gt;
  
  
  TL;DR
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;概要:&lt;/strong&gt; Gemini Nano Banana 2.1、モデルID &lt;code&gt;gemini-nano-banana-2.1&lt;/code&gt; は、Nano Banana 2（Gemini 3.1 Flash Image）のアップデート版です。Googleのドキュメントでは、画像生成および編集における「主要な高効率主力モデル」とされています。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Googleが改善した点:&lt;/strong&gt; より優れたビジュアルデザイン、マスクベースの編集、被写体の一貫性、より自然な見た目の画像（ローンチ投稿より）、さらにテキストレンダリング、複数ターンのキャラクターの一貫性、検索グラウンディング（ドキュメントより）。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;価格:&lt;/strong&gt; 1K画像あたり0.0336ドル、2K画像あたり0.0504ドル、4K画像あたり0.0756ドル。これは各サイズでNano Banana 2の半額です。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;注意点:&lt;/strong&gt; 入力トークンはNano Banana 2の3倍のコストがかかり、512pxのティアがなく、Gemini APIには無料ティアがなく、Googleは2.1のベンチマークを公開していません。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;試用場所:&lt;/strong&gt; Google AI Studio、Gemini API（Interactions API）、Vertex AI。最初にGoogle Flowにも登場しました。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Nano Banana 2.1とは
&lt;/h2&gt;

&lt;p&gt;Nano Bananaは、Geminiファミリーの画像モデルに対するGoogleの名称です。オリジナルのNano Banana（&lt;code&gt;gemini-2.5-flash-image&lt;/code&gt;）は現在レガシーモデルとなっています。&lt;a href="https://apidog.com/jp/blog/nano-banana-2?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2&lt;/a&gt;（&lt;code&gt;gemini-3.1-flash-image&lt;/code&gt;）は高速なデフォルトモデルとなり、Nano Banana 2 Liteは予算重視の枠を占め、Nano Banana Pro（&lt;code&gt;gemini-3-pro-image&lt;/code&gt;）はプロフェッショナルなアセット作業をカバーします。&lt;/p&gt;

&lt;p&gt;Nano Banana 2.1は、Nano Banana 2のアップデートとして位置づけられています。Googleの&lt;a href="https://ai.google.dev/gemini-api/docs/image-generation" rel="noopener noreferrer"&gt;画像生成ドキュメント&lt;/a&gt;では、「視覚品質の向上、複数ターンのキャラクターの一貫性、正確なテキストレンダリング、および1K、2K、4K解像度での検索に基づいた生成機能を備えた、高効率な画像生成および会話型編集のために構築された」と説明されています。&lt;/p&gt;

&lt;h3&gt;
  
  
  主な仕様
&lt;/h3&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;機能&lt;/th&gt;
&lt;th&gt;Nano Banana 2.1&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;モデルID&lt;/td&gt;
&lt;td&gt;&lt;code&gt;gemini-nano-banana-2.1&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;出力解像度&lt;/td&gt;
&lt;td&gt;1K、2K、4K&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;入力&lt;/td&gt;
&lt;td&gt;テキスト、画像、動画（音声なし）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;参照画像&lt;/td&gt;
&lt;td&gt;最大14枚&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;思考&lt;/td&gt;
&lt;td&gt;デフォルトでオン、APIでは無効化不可&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;中間「思考画像」&lt;/td&gt;
&lt;td&gt;最大2枚、課金なし&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;検索グラウンディング&lt;/td&gt;
&lt;td&gt;Googleウェブ検索およびGoogle画像検索&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;ウォーターマーク&lt;/td&gt;
&lt;td&gt;すべての出力にSynthID&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  Googleが改善したと述べている点
&lt;/h2&gt;

&lt;p&gt;ローンチ投稿では、より優れたビジュアルデザイン、マスクベースの編集、被写体の一貫性、より自然な見た目の画像が挙げられています。ドキュメントでは、複数ターンのキャラクターの一貫性、正確なテキストレンダリング、Google画像検索グラウンディングが追加されています。&lt;/p&gt;

&lt;h3&gt;
  
  
  テキストレンダリング
&lt;/h3&gt;

&lt;p&gt;文字化けした文字は、長年にわたりAI画像の特徴でした。ドキュメントでは、Nano Bananaファミリーを「インフォグラフィック、メニュー、図、マーケティングアセット向けに判読可能でスタイル化されたテキストを生成できる」と説明しており、特に2.1の改善点として正確なテキストレンダリングを挙げています。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fp2zf9jy7kgic4vsc6u82.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fp2zf9jy7kgic4vsc6u82.png" alt="Nano Banana 2.1のテキストレンダリング例" width="800" height="1071"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;これはGoogleの主張であり、測定された結果ではありません。2.1のテキスト精度に関するベンチマークは公開されていません。本番トラフィックを切り替える前に、実際のコピーを含むメニュー、ポスター、UIモックアップを自分のプロンプトでテストしてください。&lt;/p&gt;

&lt;p&gt;実装時は、少なくとも以下のケースを比較します。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;短い見出し&lt;/li&gt;
&lt;li&gt;複数行の説明文&lt;/li&gt;
&lt;li&gt;数字、価格、日付&lt;/li&gt;
&lt;li&gt;日本語・英語など複数言語の混在&lt;/li&gt;
&lt;li&gt;UI内のボタンやラベル&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  マスクベースの編集
&lt;/h3&gt;

&lt;p&gt;Googleはこれを「セマンティックマスキング」と呼んでいます。マスクを描くのではなく、プロンプトで変更対象を説明します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;提供された画像を使用し、背景の空だけを夕焼けに変更してください。
人物、服装、構図、その他の要素はすべてそのままにしてください。
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;モデルは変更すべき領域を推測し、残りの部分を維持します。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F6rqhfptgx8bt9y4fdcp8.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F6rqhfptgx8bt9y4fdcp8.png" alt="Nano Banana 2.1のマスクベース編集例" width="800" height="1192"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;変更範囲を安定させるには、次のようにプロンプトを具体化します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;[要素] のみを [新しい状態] に変更してください。
色、照明、カメラアングル、人物、背景、テキストは変更しないでください。
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  被写体とキャラクターの一貫性
&lt;/h3&gt;

&lt;p&gt;キャラクター、製品、マスコットは、一連の編集全体で同じ状態を保つ必要があります。APIでは、&lt;code&gt;previous_interaction_id&lt;/code&gt; を使用して編集を連結し、最大14枚の参照画像を組み合わせることができます。&lt;/p&gt;

&lt;p&gt;実装では、最初の生成結果のIDを保存し、後続の編集で再利用します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;edited&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gemini-nano-banana-2.1&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;previous_interaction_id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;interaction&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nb"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;バナナのサングラスだけを赤いフレームに変更してください。他は変更しないでください。&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;複数ターン編集では、各ターンの画像・プロンプト・&lt;code&gt;interaction.id&lt;/code&gt;・使用トークンを記録しておくと、品質劣化やコスト増加を追跡できます。&lt;/p&gt;

&lt;h3&gt;
  
  
  検索グラウンディング
&lt;/h3&gt;

&lt;p&gt;Nano Banana 2.1と3.1 Flash Imageは、ウェブ検索だけでなくGoogle画像検索にも基づいて情報を取得でき、最近のイベント、天気図、株価チャートなどに役立ちます。&lt;/p&gt;

&lt;p&gt;ただし、ウェブ検索から取得した現実の人々の画像はグラウンディングに使用できません。&lt;/p&gt;

&lt;h2&gt;
  
  
  価格: Nano Banana 2の画像1枚あたりの半額
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://ai.google.dev/gemini-api/docs/pricing" rel="noopener noreferrer"&gt;Googleの料金ページ&lt;/a&gt;からの有料ティアGemini API価格、2026年10月7日時点（標準、バッチなし）です。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;モデル&lt;/th&gt;
&lt;th&gt;入力（100万トークンあたり）&lt;/th&gt;
&lt;th&gt;画像出力（100万トークンあたり）&lt;/th&gt;
&lt;th&gt;0.5K&lt;/th&gt;
&lt;th&gt;1K&lt;/th&gt;
&lt;th&gt;2K&lt;/th&gt;
&lt;th&gt;4K&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Nano Banana 2.1&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;$1.50&lt;/td&gt;
&lt;td&gt;$30&lt;/td&gt;
&lt;td&gt;該当なし&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;$0.0336&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;$0.0504&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;$0.0756&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Nano Banana 2&lt;/td&gt;
&lt;td&gt;$0.50&lt;/td&gt;
&lt;td&gt;$60&lt;/td&gt;
&lt;td&gt;$0.045&lt;/td&gt;
&lt;td&gt;$0.067&lt;/td&gt;
&lt;td&gt;$0.101&lt;/td&gt;
&lt;td&gt;$0.151&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Nano Banana 2 Lite&lt;/td&gt;
&lt;td&gt;$0.25&lt;/td&gt;
&lt;td&gt;$30&lt;/td&gt;
&lt;td&gt;該当なし&lt;/td&gt;
&lt;td&gt;$0.0336&lt;/td&gt;
&lt;td&gt;該当なし&lt;/td&gt;
&lt;td&gt;該当なし&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Nano Banana Pro&lt;/td&gt;
&lt;td&gt;$2.00&lt;/td&gt;
&lt;td&gt;$120&lt;/td&gt;
&lt;td&gt;該当なし&lt;/td&gt;
&lt;td&gt;$0.134&lt;/td&gt;
&lt;td&gt;$0.134&lt;/td&gt;
&lt;td&gt;$0.24&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;注目すべきポイントは以下です。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;画像1枚あたりの価格が半額。&lt;/strong&gt; 画像出力トークンは100万あたり60ドルから30ドルに下がり、画像1枚あたりのトークン数は両モデルで同じです（1Kで1,120、2Kで1,680、4Kで2,520）。1Kで1,000枚を生成する場合、2.1では33.60ドル、Nano Banana 2では67ドルです。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Liteと同価格で全機能。&lt;/strong&gt; 1Kでは2.1とNano Banana 2 Liteのコストは同じですが、Liteは1Kのみです。2.1では2Kと4Kも利用できます。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;1KではProの約4分の1。&lt;/strong&gt; 0.0336ドル対0.134ドルです。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;バッチ処理でさらに半額。&lt;/strong&gt; 2.1のバッチ料金は、1Kで0.0168ドル、2Kで0.0252ドル、4Kで0.0378ドルです。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;検索グラウンディングは別途課金されます。Gemini 3.xモデル全体で月5,000件の無料検索リクエストがあり、それ以降は1,000件あたり14ドルです。Nano Banana 2の詳細については、&lt;a href="https://apidog.com/jp/blog/nano-banana-2-pricing?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2料金ガイド&lt;/a&gt;をご覧ください。&lt;/p&gt;

&lt;h2&gt;
  
  
  注意点
&lt;/h2&gt;

&lt;h3&gt;
  
  
  入力コストが3倍に
&lt;/h3&gt;

&lt;p&gt;入力トークンは100万あたり0.50ドルから1.50ドルに、テキストおよび思考の出力は100万あたり3ドルから7.50ドルに上昇しました。テキストから画像へのプロンプトではほとんど影響がありませんが、複数の参照画像を伴う編集リクエストでは影響があります。&lt;/p&gt;

&lt;p&gt;Googleの価格で簡単に計算すると、入力のみの場合、2.1はNano Banana 2より100万トークンあたり1ドル高くなります。1Kでは画像1枚あたり約0.033ドル節約できます。そのため、単一のリクエストが約33,000入力トークンを超えるまでは2.1の方が安価です。&lt;/p&gt;

&lt;p&gt;4Kでは、画像1枚あたりの節約額が大きく（約0.075ドル）、損益分岐点は約75,000入力トークンに移動します。課金される思考テキストはその差を縮めるため、自分の &lt;code&gt;usage&lt;/code&gt; 数を確認してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  512pxティアなし
&lt;/h3&gt;

&lt;p&gt;Nano Banana 2は0.5K（512px）サイズを0.045ドルで提供しています。ドキュメントには、このサイズは「Gemini Nano Banana 2.1ではサポートされていません」と記載されています。&lt;/p&gt;

&lt;p&gt;サムネイルの場合、2.1の1K価格（0.0336ドル）はNano Banana 2の512px価格よりも安価ですが、より大きなファイルになります。配信コストや保存容量に制約がある場合は、生成後のリサイズ工程も含めて設計してください。&lt;/p&gt;

&lt;h3&gt;
  
  
  APIに無料ティアなし
&lt;/h3&gt;

&lt;p&gt;Googleの料金ページでは、Gemini APIの無料ティアは2.1では「利用不可」と記載されており、これはNano Banana 2、Lite、Proと同様です。&lt;/p&gt;

&lt;p&gt;モデルカードはGoogle AI Studioのプレイグラウンドにリンクしていますが、無料アカウントでどれだけ生成できるかはGoogleは言及していません。APIを呼び出すコードには有料キーが必要です。無料でのNano Banana 2.1の利用方法については、&lt;a href="https://apidog.com/jp/blog/how-to-use-nano-banana-2-1-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;こちら&lt;/a&gt;で説明しています。&lt;/p&gt;

&lt;h3&gt;
  
  
  ベンチマークはまだ
&lt;/h3&gt;

&lt;p&gt;「以前のモデルをあらゆる面で上回る」という主張には、公開された数値や公式ブログ投稿が伴っていません。品質向上はあり得るものの、未証明であると考えるべきです。&lt;/p&gt;

&lt;p&gt;移行判断は、ベンダーの主張ではなく、自分の評価セットで行ってください。たとえば以下を同一プロンプト・同一アスペクト比・同一出力サイズで比較します。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;文字の正確性&lt;/li&gt;
&lt;li&gt;被写体の一貫性&lt;/li&gt;
&lt;li&gt;編集対象以外の保持率&lt;/li&gt;
&lt;li&gt;レスポンス時間&lt;/li&gt;
&lt;li&gt;入出力トークン数&lt;/li&gt;
&lt;li&gt;1枚あたりの総コスト&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  静かなロールアウト
&lt;/h3&gt;

&lt;p&gt;このモデルはAPI発表前にGoogle Flowに登場しました。サードパーティのレポートによると、Flow（サブスクリプションクレジットを使用）で利用可能であり、Geminiアプリにも登場し始めているとのことですが、GoogleはGeminiアプリへのロールアウトを公式には確認していません。&lt;/p&gt;

&lt;h2&gt;
  
  
  切り替えるべき人
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;今すぐ切り替えるべき場合:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;テキストから画像への生成でNano Banana 2を1K、2K、または4Kで実行している場合。Googleがアップグレードと呼ぶモデルで、画像1枚あたりのコストを半分に削減できます。&lt;/li&gt;
&lt;li&gt;Nano Banana 2 Liteを使用しているが、1Kと同じ価格で2Kまたは4Kの出力が必要な場合。&lt;/li&gt;
&lt;li&gt;生成する画像に実際のテキスト（製品ラベル、メニュー、スライドグラフィックなど）が含まれる場合。Googleが最大の改善点としている部分なので、テストしてください。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;見送るべき場合:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;パイプラインが512pxの出力に依存している場合。&lt;/li&gt;
&lt;li&gt;リクエストの入力が重く、呼び出しごとに多くの参照画像が含まれる場合。自分のトークン数で損益分岐点を計算してください。&lt;/li&gt;
&lt;li&gt;最終的なマーケティングアセットにProレベルの品質が必要な場合。&lt;a href="https://apidog.com/jp/blog/nano-banana-2-1-vs-nano-banana-2-vs-pro?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2.1 vs Nano Banana 2 vs Proの比較&lt;/a&gt;で違いを追跡しています。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  API経由でNano Banana 2.1を試す
&lt;/h2&gt;

&lt;p&gt;Nano Banana 2.1はGemini Interactions APIで動作します。まず、APIキーを環境変数に設定します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;export &lt;/span&gt;&lt;span class="nv"&gt;GEMINI_API_KEY&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"your_api_key"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;最小限の画像生成リクエストは以下のとおりです。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="nt"&gt;-s&lt;/span&gt; &lt;span class="nt"&gt;-X&lt;/span&gt; POST &lt;span class="s2"&gt;"https://generativelanguage.googleapis.com/v1beta/interactions"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"x-goog-api-key: &lt;/span&gt;&lt;span class="nv"&gt;$GEMINI_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "gemini-nano-banana-2.1",
    "input": [
      {
        "type": "text",
        "text": "A ripe banana wearing tiny sunglasses on a beach towel, bold hand-lettered sign that reads OPEN"
      }
    ]
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;画像はbase64データとして返されます。Pythonの場合は以下のように保存できます。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;from&lt;/span&gt; &lt;span class="n"&gt;google&lt;/span&gt; &lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;genai&lt;/span&gt;
&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;base64&lt;/span&gt;

&lt;span class="n"&gt;client&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;genai&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Client&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;

&lt;span class="n"&gt;interaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;interactions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gemini-nano-banana-2.1&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nb"&gt;input&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;A ripe banana wearing tiny sunglasses on a beach towel&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;response_format&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;mime_type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image/png&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;aspect_ratio&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;16:9&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;image_size&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;2K&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;with&lt;/span&gt; &lt;span class="nf"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;banana.png&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;wb&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;as&lt;/span&gt; &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;write&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;base64&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;b64decode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;interaction&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;output_image&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;type&lt;/code&gt; を &lt;code&gt;image&lt;/code&gt; に設定すると、画像のみが返され、テキストは省略されます。&lt;/p&gt;

&lt;p&gt;追跡編集を行うには、新しい &lt;code&gt;input&lt;/code&gt; と &lt;code&gt;previous_interaction_id=interaction.id&lt;/code&gt; を指定して &lt;code&gt;create&lt;/code&gt; を再度呼び出します。検索に基づいて情報を取得するには、&lt;code&gt;tools=[{"type": "google_search"}]&lt;/code&gt; を追加します。&lt;/p&gt;

&lt;p&gt;スクリプトを書かずにモデルを比較したい場合は、&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;がこのようなサイドバイサイドテストに適しています。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;リクエストを保存します。&lt;/strong&gt; Interactionsエンドポイントへの &lt;code&gt;POST&lt;/code&gt; を作成し、キーを環境変数として保存します。ヘッダーは &lt;code&gt;x-goog-api-key: {{GEMINI_API_KEY}}&lt;/code&gt; とします。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;モデルごとにクローンします。&lt;/strong&gt; リクエストを複製し、&lt;code&gt;model&lt;/code&gt; のみを &lt;code&gt;gemini-3.1-flash-image&lt;/code&gt; に変更します。同じプロンプトで両方を送信し、応答、遅延、トークン使用量を比較します。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;アサーションを追加します。&lt;/strong&gt; &lt;code&gt;200&lt;/code&gt; ステータスであることを確認し、応答に画像出力ブロックが含まれていることを確認します。テストシナリオとして保存すると、このペアはGoogleがモデルを更新するたびに再実行できる回帰チェックになります。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;画像編集、複数ターンチェーン、コスト追跡を含むステップバイステップのバージョンは、&lt;a href="https://apidog.com/jp/blog/nano-banana-2-1-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Nano Banana 2.1 APIガイド&lt;/a&gt;にあります。まだキーが必要な場合は、まず&lt;a href="https://apidog.com/jp/blog/google-gemini-api-key-for-free?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Gemini APIキーを取得&lt;/a&gt;してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  よくある質問
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Nano Banana 2.1のモデルIDは何ですか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;code&gt;gemini-nano-banana-2.1&lt;/code&gt;です。正式名称はGemini Nano Banana 2.1です。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Nano Banana 2.1はNano Banana 2よりも安価ですか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
画像1枚あたりでは安価です。1K、2K、4Kで半額です。入力トークンのコストは3倍なので、入力が非常に多い編集リクエストでは、その差が縮まるか、なくなる可能性があります。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Nano Banana 2.1はテキストを正しくレンダリングしますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Googleは「正確なテキストレンダリング」を提供すると述べています。Googleはまだそれを裏付けるベンチマークを公開していないため、自分のテキストが多いプロンプトでテストしてください。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Nano Banana 2.1は無料ですか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Gemini APIでは無料ではありません。無料ティアは利用不可と記載されています。GoogleはこれをAI Studioプレイグラウンドにリンクしていますが、2.1の無料制限については公開していません。&lt;/p&gt;

&lt;h2&gt;
  
  
  結論
&lt;/h2&gt;

&lt;p&gt;Nano Banana 2.1は、画像開発者にとって明確な値下げです。Nano Banana 2と同じ画像あたりのトークン数で、トークンあたりの出力価格は半額です。さらに、Nano Banana 2 Liteの1K価格で2Kおよび4K出力が可能です。&lt;/p&gt;

&lt;p&gt;Googleはテキストレンダリング、編集、一貫性のすべてが改善されたと述べていますが、これらはベンチマークが登場するまではGoogleの主張です。多くの参照画像を送信する場合は3倍の入力価格に注意し、欠落している512pxティアについて計画を立ててください。&lt;/p&gt;

&lt;p&gt;その後、&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;で両方のモデルに対して自分のプロンプトを実行し、結果・遅延・トークン使用量を測定して、より優れた方へトラフィックを切り替えてください。&lt;/p&gt;

</description>
      <category>ai</category>
      <category>google</category>
      <category>news</category>
    </item>
    <item>
      <title>Mistral Large 4 API の使い方</title>
      <dc:creator>Akira</dc:creator>
      <pubDate>Tue, 06 Oct 2026 16:10:44 +0000</pubDate>
      <link>https://dev.to/aakira/mistral-large-4-api-noshi-ifang-4a7a</link>
      <guid>https://dev.to/aakira/mistral-large-4-api-noshi-ifang-4a7a</guid>
      <description>&lt;p&gt;Mistral Large 4は、オープンウェイト公開の3週間前である2026年10月6日にMistral APIで稼働を開始しました。1兆パラメータの「Le Chonk」を今すぐ試すにはAPIが唯一の方法であり、現時点では最も安価な方法でもあります。Mistralはパブリックプレビュー期間中、&lt;strong&gt;入力トークン100万あたり0.68ドル、出力トークン100万あたり2.09ドル&lt;/strong&gt;を提示しています。これは定価の1.36ドル／4.18ドルの半額です。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com/?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation" class="crayons-btn crayons-btn--primary"&gt;今すぐApidogを試す&lt;/a&gt;
&lt;/p&gt;

&lt;p&gt;このガイドでは、約5分で最初のAPI呼び出しを実行し、その後に実装でつまずきやすい推論チャンク、画像入力、関数呼び出し、JSON出力、費用を扱います。&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;を使うと、リクエストを保存・再実行できるため、Large 4と現在使っているモデルを同じ条件で比較できます。&lt;/p&gt;

&lt;p&gt;モデル自体について初めて知る場合は、ベンチマークやサイバー関連のヘッドラインの背景を解説した「&lt;a href="https://apidog.com/jp/blog/mistral-large-4?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Mistral Is Back: Le Chonk Beats GPT-6 Astra and Claude at Cyber&lt;/a&gt;」も参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  必要なもの
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;項目&lt;/th&gt;
&lt;th&gt;値&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;ベースURL&lt;/td&gt;
&lt;td&gt;&lt;code&gt;https://api.mistral.ai/v1&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;認証&lt;/td&gt;
&lt;td&gt;&lt;code&gt;Authorization: Bearer $MISTRAL_API_KEY&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;モデルID&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;mistral-large-4&lt;/code&gt;（エイリアス: &lt;code&gt;mistral-large-4-0&lt;/code&gt;）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;メインエンドポイント&lt;/td&gt;
&lt;td&gt;&lt;code&gt;POST /v1/chat/completions&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;コンテキストウィンドウ&lt;/td&gt;
&lt;td&gt;1Mトークン&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;入力タイプ&lt;/td&gt;
&lt;td&gt;テキスト、画像&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Python SDK&lt;/td&gt;
&lt;td&gt;&lt;code&gt;pip install mistralai&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;TypeScript SDK&lt;/td&gt;
&lt;td&gt;&lt;code&gt;npm install @mistralai/mistralai&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  ステップ1：APIキーを取得する
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;a href="https://console.mistral.ai/" rel="noopener noreferrer"&gt;Mistral Studio&lt;/a&gt;（旧La Plateforme）にサインインします。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;API Keys&lt;/strong&gt; を開き、新しいキーを作成します。&lt;code&gt;local-dev&lt;/code&gt; や &lt;code&gt;ci-staging&lt;/code&gt; のように用途がわかる名前を付けてください。&lt;/li&gt;
&lt;li&gt;作成直後にキーをコピーします。Studioでは再表示されません。&lt;/li&gt;
&lt;li&gt;シェルの環境変数に設定します。
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;export &lt;/span&gt;&lt;span class="nv"&gt;MISTRAL_API_KEY&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"your-key-here"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;キーはGitなどのバージョン管理システムにコミットしないでください。複数のツールでキーを扱う場合は、&lt;a href="https://apidog.com/jp/blog/api-key-management-best-practices?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;APIキー管理のベストプラクティス&lt;/a&gt;を参照し、ローテーションとスコープ設定を整備してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ2：最初の呼び出しを行う
&lt;/h2&gt;

&lt;p&gt;まずはcurlで接続、認証、モデルIDをまとめて確認します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl https://api.mistral.ai/v1/chat/completions &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"Authorization: Bearer &lt;/span&gt;&lt;span class="nv"&gt;$MISTRAL_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "mistral-large-4",
    "messages": [
      {
        "role": "user",
        "content": "ページネーションAPIでテストすべき3つのエッジケースを教えてください。"
      }
    ]
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;成功時は、回答を含む &lt;code&gt;choices[0].message.content&lt;/code&gt; と、以下を含む &lt;code&gt;usage&lt;/code&gt; ブロックが返ります。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;prompt_tokens&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;completion_tokens&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;total_tokens&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;よくある初回エラーは次のとおりです。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;401&lt;/code&gt;: APIキーが間違っている、または環境変数にエクスポートされていない&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;404&lt;/code&gt;: モデルIDのタイプミスであることが多い&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Pythonで呼び出す
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;pip &lt;span class="nb"&gt;install &lt;/span&gt;mistralai
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;os&lt;/span&gt;
&lt;span class="kn"&gt;from&lt;/span&gt; &lt;span class="n"&gt;mistralai&lt;/span&gt; &lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;Mistral&lt;/span&gt;

&lt;span class="n"&gt;client&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;Mistral&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;api_key&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;environ&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;MISTRAL_API_KEY&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;

&lt;span class="n"&gt;response&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;chat&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;complete&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;mistral-large-4&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;role&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;user&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;content&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;ページネーションAPIでテストすべき3つのエッジケースを教えてください。&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;],&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choices&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  TypeScriptで呼び出す
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm &lt;span class="nb"&gt;install&lt;/span&gt; @mistralai/mistralai
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;Mistral&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@mistralai/mistralai&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;client&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Mistral&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
  &lt;span class="na"&gt;apiKey&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;MISTRAL_API_KEY&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;response&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;chat&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;complete&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
  &lt;span class="na"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;mistral-large-4&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="na"&gt;role&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;user&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="na"&gt;content&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;ページネーションAPIでテストすべき3つのエッジケースを教えてください。&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;],&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;

&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;choices&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;content&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  ステップ3：Apidogに保存する
&lt;/h2&gt;

&lt;p&gt;モデル比較を始めると、curlコマンドを毎回書き換える方法では管理しづらくなります。Apidogでは、同じ入力を使った比較用リクエストを保存できます。&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;新しいHTTPリクエストを作成します。
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;   POST https://api.mistral.ai/v1/chat/completions
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;環境変数 &lt;code&gt;MISTRAL_API_KEY&lt;/code&gt; を追加します。&lt;/li&gt;
&lt;li&gt;ヘッダーに次を設定します。
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;   Authorization: Bearer {{MISTRAL_API_KEY}}
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;ステップ2のJSONボディを貼り付けて送信します。&lt;/li&gt;
&lt;li&gt;リクエストを複製し、&lt;code&gt;model&lt;/code&gt; を現在利用中のモデル（例: &lt;code&gt;mistral-medium-3-5&lt;/code&gt;）に変更します。&lt;/li&gt;
&lt;li&gt;両方のリクエストを実行し、結果を比較します。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;これで、同一プロンプトを使う2つの保存済みリクエストを作成できます。Apidogではレスポンスボディ、ステータス、タイミング、サイズを確認できるため、スクリプトなしで回答品質、レイテンシ、&lt;code&gt;usage&lt;/code&gt; のトークン数を比較できます。&lt;/p&gt;

&lt;p&gt;さらに、&lt;code&gt;choices[0].message.content&lt;/code&gt; が空でないことを確認するレスポンス後アサーションを追加してください。Mistralがプレビューを更新した際に再実行できるスモークテストになります。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ4：推論のオン／オフを切り替える
&lt;/h2&gt;

&lt;p&gt;Large 4はハイブリッドモデルです。高速な回答と段階的な推論を、&lt;code&gt;reasoning_effort&lt;/code&gt; パラメータで切り替えます。&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;値&lt;/th&gt;
&lt;th&gt;挙動&lt;/th&gt;
&lt;th&gt;用途&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;"none"&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;最小限の思考。レスポンスに思考チャンクなし&lt;/td&gt;
&lt;td&gt;チャット、抽出、分類、低レイテンシが必要な処理&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;"high"&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;最終回答の前に完全な思考チャンクを返す&lt;/td&gt;
&lt;td&gt;デバッグ、多段階計画、数学、コードレビュー&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl https://api.mistral.ai/v1/chat/completions &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"Authorization: Bearer &lt;/span&gt;&lt;span class="nv"&gt;$MISTRAL_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "mistral-large-4",
    "messages": [
      {
        "role": "user",
        "content": "当社のAPIは、負荷がかかると空のボディで200を返します。可能性のある原因を確率の高い順にリストしてください。"
      }
    ],
    "reasoning_effort": "high"
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  &lt;code&gt;reasoning_effort: "high"&lt;/code&gt; でパーサーが壊れる理由
&lt;/h3&gt;

&lt;p&gt;&lt;code&gt;reasoning_effort: "high"&lt;/code&gt; を指定すると、&lt;code&gt;message.content&lt;/code&gt; は文字列ではなくチャンクのリストになります。リストには次の要素が含まれます。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;推論トレースを持つ &lt;code&gt;thinking&lt;/code&gt; チャンク&lt;/li&gt;
&lt;li&gt;最終回答を持つ &lt;code&gt;text&lt;/code&gt; チャンク&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;そのため、&lt;code&gt;response.choices[0].message.content&lt;/code&gt; をそのまま表示すると、回答ではなくリストが出力されます。&lt;code&gt;text&lt;/code&gt; チャンクだけを明示的に抽出してください。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;response&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;chat&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;complete&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;mistral-large-4&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;role&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;user&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;content&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;なぜ200レスポンスが空のボディを持つことがありますか？&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;],&lt;/span&gt;
    &lt;span class="n"&gt;reasoning_effort&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;high&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="n"&gt;content&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choices&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;

&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="nf"&gt;isinstance&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
    &lt;span class="n"&gt;answer&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;content&lt;/span&gt;
&lt;span class="k"&gt;else&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;answer&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sh"&gt;""&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt; &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;content&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nb"&gt;type&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;answer&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;思考トークンは出力トークンとして課金されます。通常は &lt;code&gt;"none"&lt;/code&gt; をデフォルトにし、深い推論が必要な呼び出しだけ &lt;code&gt;"high"&lt;/code&gt; に切り替えてください。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ5：画像を送信する
&lt;/h2&gt;

&lt;p&gt;Large 4は16億パラメータのビジョンエンコーダーを搭載するネイティブなマルチモーダルモデルです。画像はテキストと同じ &lt;code&gt;content&lt;/code&gt; 配列に含めます。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl https://api.mistral.ai/v1/chat/completions &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"Authorization: Bearer &lt;/span&gt;&lt;span class="nv"&gt;$MISTRAL_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "mistral-large-4",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "これは弊社のAPIエラーダッシュボードのスクリーンショットです。どのエンドポイントが最も頻繁に失敗しており、エラーコードは何ですか？"
          },
          {
            "type": "image_url",
            "image_url": "https://example.com/dashboard.png"
          }
        ]
      }
    ]
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;ローカルファイルを送る場合は、base64データURLを &lt;code&gt;image_url&lt;/code&gt; に設定します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"image_url"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"image_url"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"data:image/png;base64,&amp;lt;encoded&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Mistralは、Dense 200のビジュアルグラウンディングベンチマークでLarge 4が42%を記録し、GPT-6 Astraの41%をわずかに上回ったと報告しています。そのため、ダッシュボード、グラフ、UI状態のスクリーンショット分析は適した用途です。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ6：関数呼び出し
&lt;/h2&gt;

&lt;p&gt;関数呼び出しは、Large 4のエージェント用途を実装する基本機能です。ツールを定義すると、モデルが呼び出すべきタイミングと引数を決定します。実際のAPI呼び出しはアプリケーション側で実行します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;tools&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;function&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;function&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;name&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;get_order_status&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;description&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;注文IDで注文のステータスを検索します。&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;parameters&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
                &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;object&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;properties&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
                    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;order_id&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
                        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;string&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;description&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;注文ID、例: ORD-1042&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                    &lt;span class="p"&gt;}&lt;/span&gt;
                &lt;span class="p"&gt;},&lt;/span&gt;
                &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;required&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;order_id&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
            &lt;span class="p"&gt;},&lt;/span&gt;
        &lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;

&lt;span class="n"&gt;messages&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;role&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;user&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;content&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;注文ORD-1042はどこにありますか？&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;

&lt;span class="n"&gt;response&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;chat&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;complete&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;mistral-large-4&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;tools&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;tools&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;tool_choice&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;auto&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="n"&gt;tool_call&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choices&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;tool_calls&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;

&lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;tool_call&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;function&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;tool_call&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;function&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;arguments&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;次に、アプリケーション側で関数を実行し、同じ &lt;code&gt;tool_call_id&lt;/code&gt; を付けて結果をモデルへ返します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;

&lt;span class="n"&gt;result&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;order_id&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;ORD-1042&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;status&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;shipped&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;eta&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;2026-10-09&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choices&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;role&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;tool&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;name&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;get_order_status&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;content&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;dumps&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;result&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;tool_call_id&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;tool_call&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nb"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="n"&gt;final&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;chat&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;complete&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;mistral-large-4&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;tools&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;tools&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;final&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choices&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;ツールスキーマは通常のJSON Schemaです。既存APIにOpenAPI仕様があるなら、各操作のリクエストスキーマを &lt;code&gt;parameters&lt;/code&gt; に組み込めます。Apidogで先に仕様を設計しておくと、ツール定義と実際のAPIを同期しやすくなります。&lt;/p&gt;

&lt;h2&gt;
  
  
  ステップ7：JSONを返す
&lt;/h2&gt;

&lt;p&gt;機械可読な出力が必要な場合は、&lt;code&gt;response_format&lt;/code&gt; を指定します。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl https://api.mistral.ai/v1/chat/completions &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"Authorization: Bearer &lt;/span&gt;&lt;span class="nv"&gt;$MISTRAL_API_KEY&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{
    "model": "mistral-large-4",
    "messages": [
      {
        "role": "user",
        "content": "GET /v1/users/42 returned 404 から、メソッド、パス、ステータスコードを抽出してください。JSONで返答してください。"
      }
    ],
    "response_format": {
      "type": "json_object"
    }
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;JSON出力を使う場合は、プロンプトと &lt;code&gt;response_format&lt;/code&gt; の両方でJSONを要求してください。&lt;/p&gt;

&lt;p&gt;より厳密な形式が必要な場合、Mistralは完全なスキーマを持つ以下の形式もサポートしています。&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"json_schema"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"json_schema"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"..."&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"..."&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Apidogでは、レスポンスにJSON Schemaアサーションを追加できます。形式がずれた場合、下流サービスで障害を起こす前にテストを明確に失敗させられます。&lt;/p&gt;

&lt;h2&gt;
  
  
  費用
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;利用内容&lt;/th&gt;
&lt;th&gt;プレビュー価格&lt;/th&gt;
&lt;th&gt;定価&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;入力、100万トークンあたり&lt;/td&gt;
&lt;td&gt;$0.68&lt;/td&gt;
&lt;td&gt;$1.36&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;キャッシュ済み入力、100万トークンあたり&lt;/td&gt;
&lt;td&gt;$0.07&lt;/td&gt;
&lt;td&gt;$0.14&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;出力、100万トークンあたり&lt;/td&gt;
&lt;td&gt;$2.09&lt;/td&gt;
&lt;td&gt;$4.18&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;たとえば、1日10,000回の呼び出しを行うエージェントを考えます。各呼び出しは3,000入力トークンと500出力トークンで、入力の多くはキャッシュ済みシステムプロンプトとツール定義です。&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;入力&lt;/strong&gt;: 3,000万トークン
各3,000トークンのうち2,500トークンがキャッシュ済みの場合、2,500万トークンが$0.07、500万トークンが$0.68で課金されます。合計は&lt;strong&gt;1日あたり約$5.15&lt;/strong&gt;です。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;出力&lt;/strong&gt;: 500万トークン
$2.09で課金されるため、合計は&lt;strong&gt;1日あたり約$10.45&lt;/strong&gt;です。&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;合計&lt;/strong&gt;: プレビュー価格では&lt;strong&gt;1日あたり約$15.60&lt;/strong&gt;、定価では約$31です。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;同じワークロードをGPT-6 Astra（100万トークンあたり$10／$50、キャッシュ割引前）で実行すると、1日数百万ドルかかります。Mistralはプレビュー価格の終了時期を明言していないため、予算は定価を基準に見積もってください。&lt;/p&gt;

&lt;h2&gt;
  
  
  よくあるエラー
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;エラー&lt;/th&gt;
&lt;th&gt;考えられる原因&lt;/th&gt;
&lt;th&gt;解決策&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;401 Unauthorized&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;キーがない、または間違っている&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;echo $MISTRAL_API_KEY&lt;/code&gt; と &lt;code&gt;Bearer&lt;/code&gt; プレフィックスを確認&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;404&lt;/code&gt; / 無効なモデル&lt;/td&gt;
&lt;td&gt;モデルIDのタイプミス&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;mistral-large-4&lt;/code&gt; を正確に指定&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;422 Unprocessable Entity&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;不正なリクエストボディ。特に &lt;code&gt;tools&lt;/code&gt; スキーマが多い&lt;/td&gt;
&lt;td&gt;各ツールの &lt;code&gt;parameters&lt;/code&gt; にあるJSON Schemaを検証&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;429 Too Many Requests&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;ワークスペースティアのレート制限&lt;/td&gt;
&lt;td&gt;バックオフして再試行するか、Studioで制限を上げる&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;回答がリストとして表示される&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;reasoning_effort: "high"&lt;/code&gt; がチャンクを返す&lt;/td&gt;
&lt;td&gt;ステップ4のように &lt;code&gt;text&lt;/code&gt; チャンクを抽出&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  よくある質問
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Mistral Large 4はOpenAI互換ですか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
リクエスト形式は非常に似ています。&lt;code&gt;model&lt;/code&gt;、&lt;code&gt;messages&lt;/code&gt;、&lt;code&gt;tools&lt;/code&gt;、&lt;code&gt;tool_choice&lt;/code&gt;、&lt;code&gt;response_format&lt;/code&gt; は期待どおりに動作します。安全のため、Mistral SDKまたはプレーンなHTTPを使用してください。推論出力はMistral独自のチャンク形式です。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;いつローカルで実行できますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Mistralによると、ウェイトは2026年10月末までにリリース予定です。合計1.05兆パラメータのため、マルチGPUサーバーハードウェアが必要です。それまでの小型モデルのローカル実行については、「&lt;a href="https://apidog.com/jp/blog/run-mistral-3-locally?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Mistral 3をローカルで実行する&lt;/a&gt;」ガイドを参照してください。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;プレビュー版は本番環境に十分安定していますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
まだです。このモデルはパブリックプレビューであり、ウェイトリリース前に変更される可能性があります。テストを固定し、Mistralがモデルを更新するたびに再実行してください。また、フォールバックモデルも設定しておくべきです。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;既存のMistralコードでLarge 4を使用できますか？&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
はい。同じベースURL、認証、SDKを使えます。&lt;code&gt;model&lt;/code&gt; 文字列を &lt;code&gt;mistral-large-4&lt;/code&gt; に変更してください。Medium 3.5から移行する場合は、「&lt;a href="https://apidog.com/jp/blog/mistral-medium-3-5-api?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Mistral Medium 3.5 APIガイド&lt;/a&gt;」を参照してください。&lt;/p&gt;

&lt;h2&gt;
  
  
  まとめ
&lt;/h2&gt;

&lt;p&gt;5分あれば、Large 4への動作するAPI呼び出しを作成できます。次の1時間は、実際のプロンプトをLarge 4と現在のモデルで並行実行し、品質・レイテンシ・トークン使用量を比較する時間に使ってください。&lt;/p&gt;

&lt;p&gt;&lt;a href="https://apidog.com?utm_source=dev.to&amp;amp;utm_medium=wanda&amp;amp;utm_content=n8n-post-automation"&gt;Apidog&lt;/a&gt;に両方のリクエストを保存し、ステータスとレスポンス形式のアサーションを追加すれば、プレビュー価格が半額である間に、Le Chonkをスタックへ追加する価値があるか判断できます。&lt;/p&gt;

</description>
    </item>
  </channel>
</rss>
