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

はじめに

ChatGPTのようなAI(人工知能)が返してくれる文章を、自分の作ったアプリから呼び出してみたいと思ったことはありませんか。実はAI開発企業の多くは「API(エーピーアイ)」と呼ばれる仕組みを公開しています。これを使えば、自分のプログラムからAIに質問を送り、回答を受け取ることができます。APIとは、あるプログラムが別のプログラムの機能を呼び出すための「窓口」のようなものです。この記事では、Android開発などでも人気のプログラミング言語Kotlin(コトリン)を使って、AI APIを呼び出す基本の流れを解説します。

AI APIを呼び出す仕組みをざっくり理解する

AI APIとのやり取りは、多くの場合「HTTP通信」で行われます。HTTP通信とは、Webブラウザがサーバーにページを要求するときと同じ仕組みで、プログラム同士がインターネット経由でデータをやり取りする方法です。手順を簡単にまとめると、次のようになります。

  • 質問したい内容を「JSON」という形式のテキストにまとめる
  • それをAPIの窓口(URL)に向けて送信する(これを「リクエスト」と呼びます)
  • AI側が回答をJSON形式で返してくる(これを「レスポンス」と呼びます)
  • 受け取ったJSONの中から、必要な文章部分だけを取り出す

JSONとは、データを「キー」と「値」のペアで表す、多くのプログラミング言語で読み書きしやすいテキスト形式です。KotlinでもJSONを扱うためのライブラリ(便利な機能をまとめた部品)が用意されているので、難しく考える必要はありません。

Kotlinで通信する準備

Kotlinで外部のAPIと通信する場合、代表的な方法としてOkHttp(オーケーエイチティーティーピー)というライブラリを使う方法があります。OkHttpはHTTP通信を簡単に行うための定番ツールで、Android開発でも広く使われています。ビルドツール(プログラムの部品を管理する仕組み)であるGradleの設定ファイルに、次のように依存関係を追加します。

implementation("com.squareup.okhttp3:okhttp:4.12.0")

これでOkHttpの機能がプロジェクト内で使えるようになります。

実際にリクエストを送るコード例

実際にAI APIへリクエストを送る処理のイメージは、次のようなコードになります(APIキーやURLは各サービスの仕様に合わせて置き換えてください)。

val client = OkHttpClient()

val json = """
    {"model": "gpt-3.5-turbo", "messages": [{"role": "user", "content": "こんにちは"}]}
""".trimIndent()

val body = json.toRequestBody("application/json".toMediaType())

val request = Request.Builder()
    .url("https://api.example.com/v1/chat/completions")
    .addHeader("Authorization", "Bearer YOUR_API_KEY")
    .post(body)
    .build()

client.newCall(request).execute().use { response ->
    println(response.body?.string())
}

ここで登場する「APIキー」とは、そのサービスを使う権利を証明するための、いわば合言葉のような文字列です。APIキーはコードに直接書き込まず、環境変数や設定ファイルに分けて管理し、他人に見える場所(GitHubなど)にうっかり公開しないよう注意しましょう。

Kotlinならではのポイント

Kotlinには、他言語と比べて意識しておきたい特徴がいくつかあります。ひとつは「null安全」という仕組みです。KotlinはAPIのレスポンスに値が入っていない可能性がある場所を型で明示できます。?.や?:といった記法を使うことで、値が空だった場合の対処をコンパイル時(プログラムを実行前に確認する段階)に強制してくれます。これにより「値が空っぽで処理が止まってしまう」という不具合を未然に防ぎやすくなります。

もうひとつは「コルーチン」という非同期処理の仕組みです。AI APIへの通信は、回答が返ってくるまで数秒かかることもあり、その間アプリの画面が固まってしまっては困ります。コルーチンを使うと、通信を待っている間も他の処理を進められるようなコードを、比較的シンプルな書き方で実現できます。慣れないうちは難しく感じるかもしれませんが、「待ち時間のある処理を裏側でこなす仕組み」という理解でまずは十分です。

まとめ

AI APIの呼び出しは、仕組みだけ見ると「JSONを送って、JSONを受け取る」というシンプルなやり取りです。Kotlinで扱う際は、OkHttpのようなライブラリを使って通信します。null安全やコルーチンといったKotlinらしい機能を活かすと、より安全で扱いやすいコードになります。まずは簡単なリクエストを送ってレスポンスを表示するところから試してみて、少しずつ自分のアプリに組み込んでいくとよいでしょう。

関連記事

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

参考書籍(PR)

Kotlinをもっと学びたい方には「やさしいKotlin入門」がおすすめです。

コメント

コメントを投稿

このブログの人気の投稿

#11 Rustで学ぶエラーハンドリングの基本

Rustのエラーハンドリングは、他の言語のような「例外」という仕組みを持たず、`Result`という型を使った独自の考え方が中心になります。この記事では、Rustにおけるエラーハンドリングの基本を解説します。 Result型という考え方 失敗する可能性がある処理は、`Result`という「成功か失敗かを表す型」を返します。 fn divide(a: i32, b: i32) -> Result<i32, String> { if b == 0 { return Err(String::from("0では割れません")); } Ok(a / b) } 成功時は`Ok`、失敗時は`Err`という形で結果を包んで返します。 matchで結果を扱う match divide(10, 0) { Ok(result) => println!("結果: {}", result), Err(message) => println!("エラー: {}", message), } ?という便利な記号 Rustには、`Result`がエラーだった場合に、その場で関数の呼び出し元にエラーを伝えて処理を中断できる`?`という記号があります。 fn calculate() -> Result<i32, String> { let result = divide(10, 0)?; Ok(result) } Rustならではの注意点 他の言語の「エラーが起きても気づかずに進んでしまう」という問題を防ぐため、Rustは`Result`の中身を確認しない限り、警告を出す仕組みになっています。エラーの可能性を無視できない設計こそが、Rustの安全性を支えています。 まとめ Rustのエラーハンドリングは`Result`型が中心で、`match`や`?`を使って結果を扱います。エラーの可能性を無視できない設計に慣れていきましょう。 本ページはプロモーションを含みます。 参考書籍(PR) Rustをもっと学びたい方には「 実践Rust入門[言語仕様から開発手法まで] 」がおすすめです。...
続きを読む

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

TypeScriptの辞書に相当する仕組みは、JavaScriptと同じですが、キーと値の型をあらかじめ決めておけるのが特徴です。この記事では、TypeScriptにおける辞書の扱い方を解説します。 型付きのオブジェクト interface Person { name: string; age: number; } const person: Person = { name: "太郎", age: 20 }; キーの型が決まっていない辞書 キーの名前が事前に決まっていない辞書のような使い方をしたい場合は、次のように書きます。 const scores: { [key: string]: number } = {}; scores["太郎"] = 90; Mapを使う場合 const person = new Map<string, string>(); person.set("name", "太郎"); `Map<string, string>`のように、キーと値それぞれの型を指定できます。 TypeScriptならではの注意点 型付きのオブジェクト(`interface`)を使うと、存在しないキーにアクセスしようとした際に、実行前の段階でエラーとして教えてもらえます。データの形が決まっている場合は、キーが自由な辞書よりも`interface`を使うほうが安全です。 まとめ TypeScriptの辞書は、形が決まっているなら`interface`、自由なキーを扱うなら`{ [key: string]: 型 }`や`Map`を使います。用途に応じて型の付け方を選びましょう。 本ページはプロモーションを含みます。 参考書籍(PR) TypeScriptをもっと学びたい方には「 プロを目指す人のためのTypeScript入門 」がおすすめです。
続きを読む

#19 Goで学ぶテスト(単体テスト)の基本

Goはシンプルな文法が魅力ですが、書いたコードが正しく動くかどうかは別問題です。この記事では、Goで書いたコードを自動でチェックする「テスト」の基本を解説します。 なぜテストを書くのか コードを修正するたびに、関連する機能が壊れていないかを手作業で確認するのは大変です。テストを用意しておけば、コマンド一つで動作確認ができ、安心してコードを直せるようになります。 Go標準のテスト機能 Goには追加のライブラリを入れなくても使える testing パッケージが標準で備わっています。テスト対象のファイルと同じディレクトリに、名前の末尾が _test.go のファイルを作ります。 // add.go package main func add(a int, b int) int { return a + b } // add_test.go package main import "testing" func TestAdd(t *testing.T) { result := add(2, 3) if result != 5 { t.Errorf("add(2, 3) = %d; want 5", result) } } テスト関数の名前は Test から始める決まりです。ターミナルで go test と実行すると、 _test.go 内の Test から始まる関数がすべて自動で実行されます。 複数パターンをまとめてテストする Goでは、複数の入力パターンをスライス(配列のようなもの)にまとめて、まとめてテストする書き方(テーブル駆動テスト)がよく使われます。 func TestAddCases(t *testing.T) { cases := []struct{ a, b, want int }{ {2, 3, 5}, {0, 0, 0}, {-1, 1, 0}, } for _, c := range cases { if got := add(c.a, c.b); got != c.want { t.Errorf("add(%d,...
続きを読む