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

SwiftアプリからAI API(ChatGPT等)を呼び出してみよう

最近は、アプリの中にChatGPTのような「AI(人工知能)」の機能を組み込む場面が増えてきました。実は、SwiftでもiPhoneアプリ(iOS)やMacアプリ(macOS)から、インターネット越しにAIサービスへ質問を送り、回答を受け取ることができます。この記事では、SwiftからAI APIを呼び出す基本的な流れと、初心者がつまずきやすいポイントを解説します。

そもそも「API」とは何か

API(エーピーアイ、Application Programming Interfaceの略)とは、あるプログラムやサービスの機能を、外部のプログラムから利用できるようにした「窓口」のようなものです。ChatGPTのようなAIサービスの多くは、インターネット上に用意された窓口(APIエンドポイント)にデータを送ると、AIが処理した結果を返してくれる仕組みになっています。

この「データを送って結果を受け取る」やり取りは、Web APIと呼ばれる形式で行われることが多くあります。SwiftアプリからもHTTP通信(Webページの読み込みなどに使われる通信方式)を使ってやり取りします。

SwiftでHTTP通信を行う基本:URLSession

Swiftで外部のサーバーと通信するときは、標準ライブラリに含まれるURLSessionというクラスを使うのが基本です。URLSessionは、URLを指定して通信リクエストを送り、結果を受け取るための仕組みで、追加のライブラリをインストールしなくても使えます。

Swift 5.5以降では、async/awaitという書き方が使えます。これを使うと、非同期処理(時間のかかる処理を待っている間も他の処理を止めない仕組み)をシンプルに書けるようになりました。以前は「完了したら呼ばれる関数(クロージャ)」を入れ子にして書く必要がありました。しかしasync/awaitのおかげで、あたかも上から下へ順番に処理が進むかのように読みやすいコードになります。JavaScriptのasync/awaitに近い感覚で書けるので、他言語の経験がある人にはなじみやすいはずです。

実際のコード例

以下は、AI API(ChatGPTのようなチャット形式の応答を返すAPI)に質問を送り、回答を受け取る簡単な例です。実際のAPI仕様はサービスによって異なるため、あくまで基本の流れをつかむためのサンプルとして見てください。

import Foundation

// APIに送る質問文からリクエストを組み立てて送信する関数
func askAI(question: String, apiKey: String) async throws -> String {
    let url = URL(string: "https://api.example.com/v1/chat/completions")!

    var request = URLRequest(url: url)
    request.httpMethod = "POST"
    request.setValue("Bearer \(apiKey)", forHTTPHeaderField: "Authorization")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")

    // 送信するデータを辞書型で組み立て、JSON形式に変換する
    let body: [String: Any] = [
        "model": "gpt-4o-mini",
        "messages": [["role": "user", "content": question]]
    ]
    request.httpBody = try JSONSerialization.data(withJSONObject: body)

    // await をつけることで、通信が終わるまで待ってから次に進む
    let (data, response) = try await URLSession.shared.data(for: request)

    guard let httpResponse = response as? HTTPURLResponse,
          httpResponse.statusCode == 200 else {
        throw URLError(.badServerResponse)
    }

    // 受け取ったJSONを扱いやすい形に変換する(簡易的な例)
    let json = try JSONSerialization.jsonObject(with: data) as? [String: Any]
    let choices = json?["choices"] as? [[String: Any]]
    let message = choices?.first?["message"] as? [String: Any]
    return message?["content"] as? String ?? "回答を取得できませんでした"
}

この関数を呼び出す側は、次のようにtry awaitを付けて実行します。

Task {
    do {
        let answer = try await askAI(question: "Swiftとは何ですか?", apiKey: "取得したAPIキー")
        print(answer)
    } catch {
        print("エラーが発生しました: \(error)")
    }
}

ポイントは、try(失敗する可能性のある処理につける印)とawait(結果が返るまで待つ印)をセットで使う点です。SwiftではAPI呼び出しのようにエラーが起こりうる非同期処理を、通常のコードとほぼ同じ見た目で書けるのが大きな特徴です。

APIキーは絶対にコードへ直接書かない

AI APIを使うには、多くの場合「APIキー」と呼ばれる、いわば利用者を識別するための秘密の文字列が必要です。このAPIキーをソースコードに直接書き込んでしまうと、危険です。アプリを解析されたときや、コードをGitHubなどに公開したときに、第三者に盗まれて悪用されるおそれがあります。

実際の開発では、APIキーを次のような方法で管理するのが一般的です。

  • APIキーをアプリ本体には持たせず、自分で用意したサーバー経由でAI APIを呼び出す
  • ローカルでの検証時は、環境変数やXcodeの実行設定(Configuration)など、ソースコードの外に置く仕組みを使う
  • .gitignoreなどでキーを含むファイルをバージョン管理の対象から除外する

特に配布するアプリの場合、APIキーをアプリ内に埋め込む方式は推奨されません。あくまで学習用の検証段階では手元だけで完結させ、公開・配布する際は自分のサーバーを経由する構成を検討しましょう。

まとめ

SwiftからAI APIを呼び出す基本は、URLSessionでHTTPリクエストを組み立てることから始まります。そのあとasync/awaitで結果を待ち受け、返ってきたJSONから必要な情報を取り出す、という流れです。他言語の非同期処理経験があれば、Swiftのasync/awaitはすぐに馴染めるはずです。まずは自分の手元で小さなリクエストを送ってみて、レスポンスの形を確認するところから始めてみてください。APIキーの扱いだけは、学習段階から意識しておくと安心です。

関連記事

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

参考書籍(PR)

Swiftをもっと学びたい方には「これからつくる iPhoneアプリ開発入門」がおすすめです。

コメント

コメントを投稿

このブログの人気の投稿

#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,...
続きを読む