#25 PHPで学ぶAI API(ChatGPT等)の呼び出し方の基本

ChatGPTのようなAI(人工知能)が回答を生成してくれる仕組みを、自分のプログラムから呼び出せたら便利だと思いませんか。実はそれほど難しいことではなく、PHPからでも数十行のコードでAI API(AIの機能をインターネット経由で使えるようにした窓口)を呼び出すことができます。この記事では、PHPを使ってAI APIにアクセスする基本の流れを、初めての方にもわかるように解説します。

AI APIとは何か

API(Application Programming Interface)とは、あるプログラムが別のプログラムの機能を呼び出すための「窓口」のようなものです。AI APIは、ChatGPTのような対話型AIの機能を、インターネット経由でリクエスト(依頼)を送ることで使えるようにしたサービスです。自分のパソコンでAIモデルを動かす必要はなく、質問文を送るとAIが考えた回答が返ってくる、という仕組みになっています。

PHPからAI APIを呼び出す準備

APIキーとは

AI APIを使うには、多くの場合「APIキー」と呼ばれる文字列が必要です。これは、誰がどれだけAPIを使ったかを識別するための、いわば「合言葉」のようなものです。AIサービスの提供元(例えばOpenAI社)のサイトでアカウントを作成すると、このAPIキーを発行してもらえます。

APIキーの安全な管理方法

APIキーはパスワードと同じくらい大切な情報です。もし他人に知られてしまうと、勝手にAPIを使われて利用料金が発生してしまう恐れがあります。そのため、APIキーをソースコードの中に直接書き込むのは避けましょう。代わりに、環境変数(プログラムの外側で管理する設定値)や、Gitの管理対象から外した.envファイルに保存し、プログラムから読み込む方法が一般的です。もしGitHubなどにコードを公開する場合は、.gitignoreファイルに.envを必ず追加しておきましょう。

cURLで実際に呼び出してみる

PHPには「cURL」という、外部のWebサービスと通信するための仕組みが標準で備わっています。ここでは、OpenAIのAPIを例に、簡単な質問を送って回答を受け取るコードを見てみましょう。

<?php
// APIキーは環境変数から読み込む(直接書き込まない)
$apiKey = getenv('OPENAI_API_KEY');

// 送信するデータをPHPの配列で用意する
$data = [
    'model' => 'gpt-4o-mini',
    'messages' => [
        ['role' => 'user', 'content' => 'PHPの初心者に一言アドバイスをください']
    ],
];

// cURLセッションを初期化する
$ch = curl_init('https://api.openai.com/v1/chat/completions');

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 結果を文字列として受け取る
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey,
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

// リクエストを送信し、結果を受け取る
$response = curl_exec($ch);
curl_close($ch);

// JSON形式の結果をPHPの配列に変換する
$result = json_decode($response, true);

echo $result['choices'][0]['message']['content'];

流れとしては、送りたい内容を配列にまとめ、それをJSON(データをやり取りするための共通フォーマット)に変換し、cURLでAPIサーバーに送信します。そして、返ってきたJSONの結果を再びPHPの配列に戻して、中身を取り出しています。APIキーはAuthorizationという項目に「Bearer」という接頭辞をつけて渡すのが決まりです。

PHPならではの書き方・注意点

PythonやJavaScriptではAPI呼び出し専用の便利なライブラリ(公式・非公式問わず)がよく使われます。PHPでも同様に、Composer(PHPのパッケージ管理ツール)経由でSDK(開発を助けてくれる部品セット)を導入すれば、コードをより簡潔に書けます。ただ、この記事で紹介したように、標準機能のcURLだけでも十分にAPIは呼び出せるのがPHPの特徴です。追加のインストール作業なしにすぐ試せる手軽さは、他言語と比べたPHPの強みと言えるでしょう。

また、AI APIの呼び出しには通信にかかる時間(レイテンシ)があるため、Webページの表示中に呼び出す場合は、ユーザーを待たせすぎないような工夫(タイムアウトの設定や、非同期処理の検討)も合わせて考えておくとよいでしょう。

まとめ

PHPからAI APIを呼び出す基本は、(1)APIキーを安全に管理する、(2)cURLでリクエストを送る、(3)返ってきたJSONを配列に変換して中身を使う、という3ステップです。難しい専用ツールがなくても、標準機能だけで十分試せるのがPHPの手軽さです。まずは無料枠や少額の範囲で、簡単な質問を送るところから試してみてください。

関連記事

本ページはプロモーションを含みます。

参考書籍(PR)

PHPをもっと学びたい方には「10日でおぼえるPHP入門教室 第4版」がおすすめです。

コメント

コメントを投稿

このブログの人気の投稿

#25 Rustで学ぶAI API(ChatGPT等)の呼び出し方の基本

ChatGPTのようなAI(人工知能)の機能を自分のアプリに組み込みたいとき、多くの場合は「AI API」と呼ばれる仕組みを使います。APIとは「Application Programming Interface」の略です。簡単に言えば、「あるサービスの機能を、プログラムから呼び出せるようにした窓口」のことです。この記事では、Rustから外部のAI APIをHTTPリクエストで呼び出す基本的な流れを、初心者向けに解説します。 AI APIを呼び出すとはどういうことか ChatGPTを提供するOpenAI社などは、インターネット経由でAIに質問を送り、回答を受け取れる「AI API」を公開しています。これはWebブラウザで検索するときのように、決まった宛先(URL)にデータを送信し、返ってきた結果を受け取る仕組みです。この「データを送って結果を受け取る」通信方式を、HTTPリクエストと呼びます。Rustのプログラムからこの通信を行うことで、自分のアプリの中でAIに質問し、回答を取得できるようになります。 reqwestクレートを使う Rustには標準でHTTP通信の機能は含まれていません。そこで使うのが「クレート」と呼ばれる外部ライブラリです。クレートはPythonのライブラリやJavaScriptのパッケージに近いもので、 Cargo.toml というファイルに追記するだけで簡単に導入できます。HTTP通信でよく使われるのが reqwest というクレートです。 Cargo.toml に次のように追記します(バージョン番号は執筆時点の例なので、実際に使う際は最新版を確認してください)。 [dependencies] reqwest = { version = "0.11", features = ["json"] } tokio = { version = "1", features = ["full"] } serde_json = "1.0" ここで tokio という見慣れないクレートも一緒に入れています。これは「非同期処理」と呼ばれる、通信の待ち時間の間に他の処理を進められる仕組みを扱うためのものです。ネットワーク通信は結果が返ってくるまで時間...
続きを読む

#8 C++で学ぶ文字列操作の基本

C++の文字列操作は、`std::string`という型を使うのが現代的な基本の書き方です。この記事では、C++における文字列操作の基本と、注意しておきたい落とし穴を解説します。 文字列を連結する std::string greeting = "こんにちは、" + name + "さん"; `std::string`同士であれば、`+`を使った連結がそのまま使えます。既存の文字列に追加する場合は`+=`や`append`メソッドも使えます。 greeting += "。よろしくお願いします。"; よく使う文字列操作 name.length() 文字数を調べる(バイト数であることに注意、後述) name.substr(0, 3) 一部分を取り出す(開始位置と長さを指定) name.find("A") 特定の文字の位置を探す(見つからなければ`std::string::npos`) name.replace(0, 2, "XX") 一部分を置き換える 文字列を数値に変換する 文字列を数値に変換したい場合は`std::stoi`(整数)や`std::stod`(小数)、逆に数値を文字列にしたい場合は`std::to_string`を使います。 int num = std::stoi("123"); std::string s = std::to_string(456); 文字列を分割する C++の標準ライブラリには、他言語の`split`のような文字列分割の関数が長らく用意されていませんでした。`std::stringstream`を使うのが伝統的な方法です。 #include <sstream> std::stringstream ss("a,b,c"); std::string item; while (std::getline(ss, item, ',')) { std::cout << item << std::endl; } C++ならではの注意点 C++には、古くからある`char`の配列を...
続きを読む

#16 TypeScriptで学ぶ辞書型(マップ)の基本

TypeScriptの辞書に相当する仕組みは、JavaScriptと同じですが、キーと値の型をあらかじめ決めておけるのが特徴です。この記事では、TypeScriptにおける辞書の扱い方と、用途別の型の選び方を解説します。 型付きのオブジェクト interface Person { name: string; age: number; } const person: Person = { name: "太郎", age: 20 }; キーの型が決まっていない辞書 キーの名前が事前に決まっていない辞書のような使い方をしたい場合は、次のように書きます。 const scores: { [key: string]: number } = {}; scores["太郎"] = 90; 同じ意味を Record というユーティリティ型で簡潔に書くこともできます。 const scores: Record = {}; Mapを使う場合 const person = new Map (); person.set("name", "太郎"); console.log(person.get("name")); Map<string, string> のように、キーと値それぞれの型を指定できます。 Object と違い、キーの数を person.size で正確に取得できる、キーの型を文字列以外にもできるといった利点があります。 値が存在しないかもしれない場合 キーが実在するとは限らない辞書の場合、値の型に | undefined を含めておくと、より正確な型になります。 const scores: { [key: string]: number | undefined } = {}; const value = scores["三郎"]; // number | undefined 型 こうしておくと、存在しないキーへのアクセスがコンパイル時に見過ごされにくくなります。 存在しないキーへのアクセスを防ぐ tsconfig.json で noUncheckedIndexedAccess を有効にす...
続きを読む