初心者ガイド

API とは

API（Application Programming Interface） は、外部サービスの機能やデータを、あなたのアプリから呼び出すための窓口です。 たとえば「天気予報を取得する」「画像を AI で説明させる」「クレジットカード決済を実行する」などの処理を、HTTP リクエスト 1 本で外部サービスに依頼できます。

API は apihub で扱う 4 種類のリソースの中で最も中心的な存在です。

RSS / データフィード とは

RSS は、ブログ・ニュースサイト・リリースノートなどの更新情報を、機械が読み取れる形式で配信する仕組みです。 「記事一覧を取得する」ような用途に向いており、ニュースアグリゲーションや情報収集自動化で使われます。

Webhook とは

API は「こちらから相手に問い合わせる」のに対し、Webhook は「相手からイベント発生時にこちらに通知が届く」仕組みです。 たとえば「決済が完了したら通知する」「GitHub に push があったら通知する」といったイベント駆動処理に使います。

API と組み合わせて使うことが多く、リアルタイム性が必要な連携で必須です。

MCP Server とは

MCP (Model Context Protocol) Server は、AI エージェント（Claude など）が外部ツールやデータソースに接続するための標準プロトコルを実装したサーバーです。 2024 年以降に Anthropic が公開し、AI エージェント時代の外部ツール連携の標準になりつつあります。

たとえば「Claude がローカルファイルを読み書きする」「Claude が Web 検索を実行する」といった機能は MCP Server 経由で実現されます。

無料枠とは

多くの API には「無料で試せる範囲」があります。これを無料枠と呼びます。

• 試用クレジット型: 新規登録時に○○ドル分の使用権が配布される。期限あり。
• 月次枠型: 毎月○○リクエストまで無料。超過したら従量課金または停止。
• 永久無料 Tier 型: 制限付きだが永続的に無料。

個人開発や検証段階では、月次枠型が最も使いやすい傾向があります。

商用利用で見るべきポイント

有料サービスに組み込む場合、無料枠があっても商用利用できないケースがあります。以下を必ず確認してください。

• 利用規約に 商用利用の可否 が明記されているか
• 出力物の 権利帰属（生成画像の著作権は誰に帰属するか等）
• 再配布・SaaS 組み込みに関する条項
• データの取り扱い（学習利用されるか等）

リソース選定で失敗しやすい点

• 料金の桁を見誤る: 「1K tokens あたり」と「1M tokens あたり」を混同して月末の請求に驚く
• Rate Limit の見落とし: 初期 Tier では自動化用途に耐えられないケースがある
• 英語ドキュメントの仕様未読: 商用利用条件や出力物の帰属が英語版にしか書かれていない
• 公式 SDK 以外の非公式クライアント: メンテが止まっていて依存地獄に
• バージョン廃止: 旧 API のサポート終了で急な移行が必要になる

AI 系 API と一般 API の違い

AI 系 API には一般 API とは違う特有の考慮点があります。

• トークン課金: 入力と出力でレートが異なる。プロンプトを工夫するだけでコストが数倍変わる
• レイテンシ: 生成系は応答が数秒〜数十秒かかる。ストリーミング対応が重要
• 安定性: 新モデルはレート制限が厳しく、deprecation も早い
• 品質の揺れ: 同じ入力でも結果が毎回異なる（決定論ではない）
• データ学習利用の有無: 一部事業者は入力データをモデル改善に利用する条項がある

次のステップ

実際のリソースを眺めてみましょう。

• リソース一覧を見る
• API から探す