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

ChatGPTのような生成AIを、自分のプログラムから呼び出して使ってみたい――そんな興味を持つ人が増えています。実はC#からでも、比較的シンプルなコードでAI API(エーアイ エーピーアイ。AIの機能をインターネット経由で呼び出すための窓口のようなもの)を利用できます。この記事では、C#でAI APIを呼び出す際の基本的な流れと、押さえておきたい注意点を初心者向けに解説します。

AI APIって何をしているの?

AI API(APIはApplication Programming Interfaceの略で、「プログラム同士が会話するための決まりごと」のことです)を使うと、自分のアプリからインターネットを通じて「この文章に返事をください」といったお願いを送れます。すると、AIが考えた答えを受け取ることができます。多くのAIサービスは、この仕組みをHTTP通信(Webサイトを見るときと同じ仕組みの通信)で提供しており、C#からも他の言語と同じように利用できます。

必要なもの

  • 利用したいAIサービスのAPIキー(利用者を識別するための合言葉のような文字列)
  • .NET SDK(C#のプログラムを動かすための開発環境)
  • インターネット接続

C#でAPIを呼び出す基本の書き方

C#には HttpClient というクラス(通信機能をひとまとめにした部品)が標準で用意されており、これを使ってAI APIにリクエスト(要求)を送ります。大まかな流れは次の3ステップです。

  1. 送りたい内容(質問文など)をJSON形式(データをやり取りするための共通フォーマット)に変換する
  2. HttpClientでAPIのアドレスにリクエストを送る
  3. 返ってきたJSONを読み取り、必要な部分(AIの返答文)を取り出す

コードのイメージは以下のようになります(実際のAPIキー・URL・モデル名は利用するAIサービスに合わせて読み替えてください)。

using System.Net.Http.Json;

// apiKeyには事前に取得したAPIキーの文字列を入れておく
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer " + apiKey);

var requestBody = new
{
    model = "gpt-4o-mini",
    messages = new[]
    {
        new { role = "user", content = "C#の初心者に一言アドバイスをください" }
    }
};

var response = await client.PostAsJsonAsync(
    "https://api.example.com/v1/chat/completions", requestBody);

// ChatResponseは、返ってくるJSONの形に合わせて自分で定義するクラス
var result = await response.Content.ReadFromJsonAsync<ChatResponse>();
Console.WriteLine(result?.Choices[0].Message.Content);

ポイントは、通信という「時間がかかる処理」を待つために await(処理の完了を待つ合図のようなキーワード)を使っている点です。C#では非同期処理(他の作業をブロックせずに待つ書き方)が言語レベルでサポートされており、比較的素直に書けるのが特徴です。

C#ならではの注意点

受け取るデータの型をしっかり決める

PythonやJavaScriptでは、返ってきたJSONをそのまま辞書のように扱えることが多いですが、C#は「静的型付け言語」と呼ばれ、変数の型をあらかじめ決めて使うのが基本です。そのため、APIから返ってくるJSONの形に合わせて class や record(データの入れ物を定義する書き方)をあらかじめ用意し、System.Text.Json という標準機能で自動的に変換してもらうのが一般的です。最初は手間に感じるかもしれませんが、型が決まっている分、あとから「どんなデータが入っているか分からない」というミスに気づきやすくなります。

HttpClientは使い回す

C#では、通信のたびに new HttpClient()を作り直すと、内部的なリソース(通信用の接続口)を無駄に消費してしまうことがあります。実際のアプリでは、IHttpClientFactoryという仕組みを使って使い回すのが推奨されていますが、まずは「毎回作り直さない」という意識だけでも覚えておくとよいでしょう。

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

APIキーはいわば合言葉であり、他人に知られると勝手に使われてしまう可能性があります。ソースコードに直接書き込んでGitHubなどに公開してしまうと、第三者に悪用されるおそれがあります。そのため、環境変数や設定ファイル(appsettings.jsonなど、公開リポジトリに含めないファイル)から読み込む形にしましょう。これはC#に限らずどの言語でも共通する基本マナーです。

まとめ

C#からAI APIを呼び出す流れは、他の言語と同じく「JSONを送って、JSONを受け取る」というシンプルなものです。C#ならではの特徴としては、async/awaitによる分かりやすい非同期処理の書き方、そして型をきちんと定義してデータを扱う静的型付けの考え方が挙げられます。最初は少し準備が多く感じるかもしれませんが、慣れてくると「何が返ってくるか分からない不安」が減り、安心してAI機能を組み込めるようになります。まずは小さなコンソールアプリで、質問を送って返事を表示するだけの簡単なプログラムから試してみてください。

関連記事

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

参考書籍(PR)

C#をもっと学びたい方には「確かな力が身につくC#「超」入門 第2版」がおすすめです。

コメント

コメントを投稿

このブログの人気の投稿

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