メインコンテンツへスキップ
AMPL/ dev
開発系講座一覧

API とは

作品の中で Claude に答えを書かせるには、API という窓口を通します。作品から頼みごと(リクエスト)を送り、答え(レスポンス)を受け取る。作るときに使う Claude Code とは、別の使い方です。

閉店後の店の奥で、お父さんが、いつものノートに鉛筆で売れ残りを書いています。豆大福 4、どら焼き 2、栗まんじゅう 0。

佐藤さん(商店街の和菓子店を手伝う、架空の人物)は、そのノートを見ながら、第4部で作った「売れ残り帳」に、+と−で数を入れ直します。第5部で、売れ残り帳は記録とともに GitHub に置けるようになりました。でも、ノートから打ち直す手間は、まだ残っています。

第3部で決めた3行の最後は、「写真を撮るだけで、数を読み取る」でした。Claude のチャットにノートの写真を渡せば、数を読み取ってくれることは、第3部で見ました。でもそれは、佐藤さんが Claude に話しかけたときの話です。お父さんが、売れ残り帳で写真を撮ったときの話ではありません。

問い

佐藤さんの疑問

お父さんが売れ残り帳で写真を撮ったら、その場で Claude が数を読んでくれるようにしたい。自分の作品の中から Claude に頼むには、どうしたらいいんだろう。

第6部では、この疑問に、10回かけて答えます。この回は、その入口です。

2つの Claude

誰が頼み、どこから払うか

作るときの Claude と、作品の中の Claude

作るときの Claude(ここまで) 佐藤さん 作る人 Claude Code 作品を作る Claude のプラン 月ごとの定額 頼む 払う 作品の中の Claude(第6部) 売れ残り帳 お父さんが撮るたび Claude API 写真を読む API の利用分 使った分だけ 頼む 払う 作るときの Claude(ここまで) 佐藤さん 作る人 Claude Code 作品を作る Claude のプラン 月ごとの定額 頼む 払う 作品の中の Claude(第6部) 売れ残り帳 お父さんが撮るたび Claude API 写真を読む API の利用分 使った分だけ 頼む 払う
図1作るときは佐藤さんが頼み、プランで払います。作品の中では作品が頼み、使った分を払います。

ここまで使ってきた Claude Code は、作品を作るための Claude でした。佐藤さんが話しかけ、Claude がファイルを作ります。

これから足すのは、作品の中で働く Claude です。お父さんが写真を撮ると、作品が Claude に写真を送り、読み取った数を受け取ります。話しかけるのは、佐藤さんではなく、作品です。払うところも、Claude のプランではなく、API の利用分(第2部の第10回)になります。

API:作品と Claude をつなぐ窓口

壁の受付窓口と、その台に置かれた1枚の紙の挿絵。

第1部の第10回で、作品から Claude に頼みごとを送り、答えを受け取るための、決まった受付窓口を API と呼ぶ、と説明しました。ウェブの作り方を解説している MDN というサイトには、こう書かれています。

DOCUMENTATION

“An API (Application Programming Interface) is a set of features and rules that exist inside a software program (the application) enabling interaction with it through software - as opposed to a human user interface.”

API は、ソフトウェア(アプリ)の中にある機能と決まりのまとまりで、人が画面を操作するのとは違い、ソフトウェアどうしでやり取りできるようにするものです。

MDN Web DocsAPI(MDN Glossary)

お店で言えば、注文を受け付ける窓口のようなものです。決まった書き方の注文票を出せば、決まった形で品物が返ってきます。

リクエストとレスポンス

窓口に出す頼みごとを、リクエスト(request、英語で「頼みごと」)と呼びます。返ってくる答えを、レスポンス(response、英語で「返事」)と呼びます。

佐藤さんの作品なら、こうなります。

  • リクエスト:ノートの写真と、「この写真から、お菓子の名前と、売れ残りの数を読み取ってください」という頼みごと
  • レスポンス:「豆大福 4、どら焼き 2、栗まんじゅう 0…」という答え

作品が、Claude に頼む

架空の例。上から下へ時間が進む

作品の中のやり取り お父さん 使う人 売れ残り帳 作品 Claude API 読んで答える ノートの写真を撮る この写真から、お菓子の名前と 売れ残りの数を読み取って (リクエスト) 豆大福 4、どら焼き 2、栗まんじゅう 0… (レスポンス) 表に数が入る 作品の中のやり取り お父さん 使う人 売れ残り帳 作品 Claude API 読んで答える ノートの 写真を撮る この写真から、 お菓子の名前と 売れ残りの数を 読み取って (リクエスト) 豆大福 4、 どら焼き 2、 栗まんじゅう 0… (レスポンス) 表に 数が入る
図2作品が窓口(API)に頼み、Claude の答えを受け取ります。

Claude API の公式の説明でも、作品が決まった送り先にリクエストを送ると、Claude の答えを含んだレスポンスが返る、という形で始め方が説明されています。リクエストには、どのモデル(AI の中身の版)を使うか、答えの長さの上限、頼みごとの中身を入れます。

platform.claude.com/docs/ja/get-started
Claude Platform Docs の「Claudeを使い始める」のページ。最初の API 呼び出しまでの手順が、番号つきで並んでいる。
Claude API の公式の説明の、最初のページ(日本語、2026年11月9日に撮影)。
Claude を使い始める(Claude API Docs)
Claude API にリクエストを送り、答えを受け取る最初の手順。日本語。
Claude API の公式の説明 · platform.claude.com

作品の中で Claude を動かすには、API という窓口に、リクエストを送り、レスポンスを受け取ります。

注意

ただし、作品の中の Claude は、使うたびにお金がかかる

Claude Code は、Claude のプランの中で使えました。作品の中の Claude は、第2部の第10回で見たとおり、プランとは別の財布、API の利用分から支払います。お父さんが写真を撮るたびに、少しずつ使います。

どのくらいかかるのか、使いすぎをどう防ぐのかは、この第6部の中で見ていきます。

次回の問い

佐藤さんの次の疑問です。作品が API を使うとき、窓口は、どうやって「使ってよい相手」かを見分けているのでしょうか。

参考

はじめてのリクエスト(Claude APIで道具を作る)
API にリクエストを送る流れを、もう少しくわしく。
AMPL · Web

このレッスンは役に立ちましたか?