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

ChatGPTのようなAI(人工知能)が提供する「API」を、自分のプログラムから呼び出してみたいと思ったことはありませんか。APIとは「Application Programming Interface」の略で、あるサービスが持つ機能を、外部のプログラムから使えるようにする窓口のことです。今回は、Googleが開発したプログラミング言語「Dart」を使って、AI APIを呼び出す基本の流れを見ていきます。Dartは主にスマートフォンアプリ開発フレームワーク「Flutter」で使われる言語ですが、単体のプログラムとしても動かせます。

AI APIを呼び出すとはどういうことか

ChatGPTなどのAIサービスの多くは、「HTTPリクエスト」という仕組みでやり取りできる窓口(API)を用意しています。HTTPリクエストとは、インターネット上のサーバーに対して「このデータをください」「この内容を処理してください」とお願いする通信の形式です。私たちがブラウザでWebページを見るときも、裏側では同じ仕組みが使われています。

AI APIの場合、こちらから「こんな質問をします」という文章(プロンプトと呼びます)をサーバーに送ります。すると、AIが考えた返事がデータとして返ってくる、という流れになります。つまり、プログラムからAPIを呼び出すというのは、この「送って、受け取る」という一連の通信処理をコードで書くことに他なりません。

Dartでの基本の書き方

Dartには標準でdart:ioというHTTP通信用のライブラリが含まれています。ただし実務では、もう少し使いやすいhttpという外部パッケージ(他の人が作って公開している便利な部品集)を使うのが一般的です。パッケージはpubspec.yamlというファイルに依存関係として書き加え、dart pub getコマンドで取り込みます。

実際にAPIを呼び出すコードのイメージは、次のようになります。

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<void> askAI(String question) async {
  final url = Uri.parse('https://api.example.com/chat');
  final response = await http.post(
    url,
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_API_KEY',
    },
    body: jsonEncode({'message': question}),
  );

  if (response.statusCode == 200) {
    final data = jsonDecode(response.body);
    print(data['answer']);
  } else {
    print('エラーが発生しました: ${response.statusCode}');
  }
}

ここで登場するasyncとawaitは、「非同期処理」を扱うためのキーワードです。非同期処理とは、時間のかかる処理(この場合はネット越しの通信)の完了を待つ間、プログラムの他の部分を止めずに進められる仕組みのこと。APIからの返事はすぐには返ってこないことが多いため、待っている間に画面がフリーズしないよう、こうした書き方が欠かせません。Dartの非同期処理はFutureという型を中心に設計されており、JavaScriptのPromiseに近い感覚で扱えます。

他言語との違いとDartらしいポイント

Pythonなど他の言語でAPIを呼び出す場合も基本的な流れは同じですが、Dartでは非同期処理が言語の核となる仕組みとして組み込まれている点が特徴です。asyncを付けた関数は必ずFuture型を返す、というルールが明確に決まっています。そのため、コードを読んだときに「これは時間がかかる処理だ」とひと目で分かりやすいというメリットがあります。

また、受け取ったデータはJSON形式(キーと値の組み合わせで表現される、APIのやり取りでよく使われるデータ形式)であることがほとんどです。これを扱う際は、jsonDecodeで一度Map型に変換してから中身を取り出すのが基本の流れです。Dartは型に厳格な言語なので、取り出した値の型が想定と違うとエラーになりやすく、慣れないうちは戸惑うかもしれません。ですが、これはバグを早期に発見しやすいという利点でもあります。

APIキーの取り扱いに関する注意

AI APIを利用する際は、多くの場合「APIキー」と呼ばれる、利用者を識別するための秘密の文字列が必要になります。このAPIキーは、サービスへのアクセス権そのものと言える大切な情報です。コードの中に直接書き込んだまま公開のリポジトリ(ソースコードを保存・共有する場所)にアップロードしてしまうと危険です。第三者に不正利用され、想定外の利用料金が発生する恐れがあります。環境変数(OS側で管理する設定値)や、Gitの管理対象から外す設定ファイルなどを使って、キーをコードから切り離して管理することを心がけましょう。

まとめ

DartからAI APIを呼び出す基本は、①httpパッケージなどでリクエストを送る、②async・awaitで非同期処理を扱う、③返ってきたJSONデータを取り出す、という3つの流れで理解できます。Dartは非同期処理の書き方が言語仕様としてはっきりしているため、一度パターンを覚えてしまえば、他のAPIを呼び出す際にも応用が利きます。まずは小さなサンプルコードを実際に動かしてみて、リクエストとレスポンスのやり取りを体感してみてください。

関連記事

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

参考書籍(PR)

Dartをもっと学びたい方には「ゼロから学ぶFlutterアプリ開発」がおすすめです。

コメント

コメントを投稿

このブログの人気の投稿

#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 を有効にす...
続きを読む