当サイトはアフィリエイト広告(Amazonアソシエイト含む)を利用しています
PR

ChatGPT APIをPythonで使う方法|初心者向け完全ガイド

AIプログラミング・開発

ChatGPT APIをPythonで使ってみたいけど、プログラミング経験が少なくて不安。そんな初心者の方に向けて、環境構築からコードの実行まで、ステップバイステップで解説します。

Pythonの基礎がわかる程度のスキルがあれば、短時間でChatGPT APIを動かせるケースが多いです(所要時間は環境によって異なります)。この記事のコードは、モデル名などを現行のものに合わせれば動かせる想定です。まずは手を動かしてみてください。

ナビ助
ナビ助
Pythonは「英語に近い自然な文法」で書けるプログラミング言語だよ。AI開発でよく使われているから、API操作の入門に向いているんだ。

事前準備:必要なもの

ChatGPT APIをPythonで使うために必要なものは3つだけです。

  • Python(3.9以上):プログラミング言語。Python公式サイトから無料でダウンロード
  • OpenAI APIキー:OpenAIプラットフォームで取得(クレジットカード登録が必要)
  • テキストエディタ:VS CodeやPyCharmなど、お好みのエディタ
APIキーの管理について

APIキーは「sk-」で始まる長い文字列です。パスワードと同様に厳重に管理し、絶対にGitHubなどの公開リポジトリにアップロードしないでください。流出すると第三者に悪用され、高額な請求が発生するリスクがあります。

ステップ1:Python環境の確認

まず、Pythonがインストールされているか確認します。コマンドプロンプト(Windows)またはターミナル(Mac)で以下を実行してください。

python --version

「Python 3.9」以上のバージョンが表示されればOKです。表示されない場合は、Python公式サイトからインストールしてください。

ステップ2:OpenAIライブラリのインストール

OpenAI公式のPythonライブラリをインストールします。コマンドラインで以下を実行してください。

pip install openai

正常にインストールされたか確認するには:

pip show openai

バージョン情報が表示されればインストール完了です。

この先のコードはコピペで動きますが、「なぜこう書くのか」がわからないままだと自分で改造できません。Pythonの文法にまだ自信がない方は、手元に1冊置いて分からない箇所を引きながら進める方法があります。

関連商品をCheck!!👉 「Pythonの入門書」を見る
Amazon 楽天 Yahoo!
ナビ助
ナビ助
pipはPythonのパッケージ管理ツールだよ。「pip install ○○」でライブラリを簡単にインストールできるんだ。

Pythonの文法に自信がない段階で、質問できる相手がほしい方には、Python Winnerというオンラインスクールもあります。Python特化で、講師とのマンツーマンレッスン(1回30分)が中心です。クラウド上の開発環境を使うため、環境構築でつまずきにくい設計と案内されています。詳しくは公式サイトで確認できます。

Python Winner

Python Winnerの特徴を確認する

Python Winnerの特徴・料金|未経験からPythonを学ぶカリキュラムと受講の流れ
※本記事はアフィリエイト広告(PR)を含みます。AIやデータ分析の仕事では、プログラミング言語のPythonがよく使われています。ChatGPTにコードを書いてもらう場面でも、出てきたコードを読んで直せるかどうかで、仕事への使いやすさは変わ...

ステップ3:APIキーの設定

APIキーをコードに直接書くのはセキュリティ上のリスクがあります。環境変数に設定するのがベストプラクティスです。

Windowsの場合

コマンドプロンプトで以下を実行します。

setx OPENAI_API_KEY "sk-あなたのAPIキー"

Mac/Linuxの場合

ターミナルで以下を実行します。

export OPENAI_API_KEY="sk-あなたのAPIキー"

永続化するには、.bashrcや.zshrcに追記してください。

ステップ4:最初のAPIリクエスト

いよいよコードを書いてAPIを呼び出します。以下のコードをコピーして、Pythonファイル(例:chat.py)として保存してください。モデル名(gpt-4.1-mini)は例です。提供状況は変わるため、OpenAIの公式モデル一覧で現行のモデル名を確認し、必要に応じて差し替えてください。

サンプルコード

from openai import OpenAI

client = OpenAI()

response = client.chat.completions.create(
    model="gpt-4.1-mini",
    messages=[
        {"role": "system", "content": "あなたは親切なアシスタントです。"},
        {"role": "user", "content": "Pythonの魅力を3つ教えてください。"}
    ]
)

print(response.choices[0].message.content)

ファイルを保存したら、コマンドラインで実行します。

python chat.py

ChatGPTからの回答がターミナルに表示されれば成功です。

ナビ助
ナビ助
最初のAPIレスポンスが返ってきた瞬間は、ちょっと感動するよ。ここから「自分だけのAIアプリ」を作る第一歩が始まるんだ。

コードの解説

先ほどのコードを一行ずつ解説します。

  • from openai import OpenAI:OpenAIライブラリからクライアントクラスをインポート
  • client = OpenAI():APIクライアントを初期化(環境変数からAPIキーを自動取得)
  • client.chat.completions.create(…):チャット補完APIを呼び出す
  • model:使用するAIモデルを指定
  • messages:会話の履歴をリスト形式で渡す
  • role: “system”:AIの振る舞いを定義するシステムメッセージ
  • role: “user”:ユーザーからの質問
  • response.choices[0].message.content:AIの回答テキストを取得

実践例:便利な活用パターン

パターン1:対話形式のチャットボット

会話の履歴を保持して、対話形式のチャットボットを作れます。messagesリストに過去のやり取りを追加していくことで、文脈を踏まえた回答が得られます。

コードのポイントは、ユーザーの入力とAIの回答を交互にmessagesリストに追加していくことです。これにより、AIは過去の会話を踏まえた回答を生成できます。

パターン2:テキストファイルの要約

テキストファイルを読み込んで、ChatGPT APIで要約するスクリプトも簡単に作れます。Pythonの標準ライブラリでファイルを読み込み、その内容をAPIに送信するだけです。

パターン3:CSVデータの分析

PythonのpandasライブラリとChatGPT APIを組み合わせれば、CSVデータの分析レポートを自動生成できます。データの傾向をAIが文章にまとめてくれます(内容の正確さは人間が確認してください)。

ただし、AIに渡す前のデータ整形はpandas側の仕事です。この工程に慣れると自動化できる範囲が広がるため、pandasを扱った書籍が参考になります。AIとPythonを学べる講座の選び方は、以下の記事でまとめています。

AI×Pythonの入門講座はどれがいい?目的別おすすめ7選と選び方のコツ
「AI・Pythonを学びたいけど、講座が多すぎてどれを選べばいいかわからない」――これは初心者が最初に直面する悩みです。Udemy、Aidemy、Progate、YouTubeと、AI×Python入門講座は数え切れないほどあります。しか...
関連商品をCheck!!👉 「pandasでデータ分析の本」を見る
Amazon 楽天 Yahoo!
ナビ助
ナビ助
APIの活用パターンはいろいろあるよ。まずは簡単なチャットボットから始めて、慣れてきたらファイル処理や自動化に挑戦してみるといいね。

エラーへの対処法

API利用時によく遭遇するエラーと対処法をまとめます。

AuthenticationError(認証エラー)

APIキーが正しく設定されていない場合に発生します。環境変数の設定を確認し、APIキーに余計な空白や改行が含まれていないかチェックしてください。

RateLimitError(レート制限エラー)

短時間に大量のリクエストを送信すると発生します。リクエスト間にtime.sleep()で待機時間を入れるか、リトライ処理を実装してください。

insufficient_quota(クォータ不足エラー)

APIの利用上限に達した、またはクレジット残高が不足している場合に発生します(現在のライブラリではRateLimitErrorの一種として表示されることがあります)。OpenAIダッシュボードで残高を確認し、必要に応じてチャージしてください。

BadRequestError(不正リクエストエラー)

モデル名のタイプミスや、トークン数の超過などで発生します。リクエストの内容を見直してください。

エラー対処の基本

エラーメッセージをよく読むことが基本です。OpenAIのエラーメッセージは何が問題かを示してくれます。メッセージをそのままChatGPTに貼り付けて「このエラーの原因と対処法を教えて」と聞く方法もあります(APIキーなどの秘密情報は伏せてください)。

セキュリティの注意点

APIを使う上で、セキュリティは重要な考慮事項の一つです。

  • APIキーをコードにハードコーディングしない:環境変数や.envファイルを使用
  • .gitignoreに.envを追加:誤ってGitHubにアップロードされるのを防止
  • APIキーのローテーション:定期的にキーを再生成する
  • 利用上限の設定:万が一の流出に備えて、ダッシュボードで月間上限額を設定

セキュリティに関する詳細はOpenAIのセキュリティベストプラクティスも参考にしてください。

次のステップ

基本的なAPIの使い方を覚えたら、次のステップに進みましょう。

  • Streamingレスポンス:回答をリアルタイムで少しずつ表示する(ユーザー体験の向上)
  • Function Calling:AIに外部関数を呼び出させる(天気APIの取得、DB検索など)
  • Embeddings:テキストをベクトル化して類似検索を実装
  • RAG(検索拡張生成):自社のドキュメントをAIに参照させて回答に反映させる

これらの機能を組み合わせることで、実用的なAIアプリケーションを構築できます。

このあたりまで来ると、断片的な情報を拾い集めるより1冊通しで読む方法もあります。RAGやFunction Callingを含めてアプリ全体の設計を扱った書籍も出ているので、次の教材として検討してみてください。

関連商品をCheck!!👉 「LLMアプリ開発の本」を見る
Amazon 楽天 Yahoo!

Pythonの基礎から体系的に学び直したい方には、デイトラのPythonコース(単独コースとして99,800円と公式サイトに表示)という選択肢もあります。公式サイトによると、自習形式で、わからない点はメンターにDiscordで質問でき、課題の添削や1年間の質問サポートも付くと案内されています。質問できるのは教材の範囲内の技術的な内容です。詳しくは公式サイトで確認できます。

デイトラ

デイトラの詳細を見る

AIスキルを仕事につなげる学習ルート|デイトラ・ウズウズIT・Midworks・クラウドワークス テックの選び方
ChatGPTやCursorなどのAIツールを触っているうちに、「これを仕事に活かせないか」と考え始める方は少なくありません。ただ、副業を始めたいのか、転職したいのか、フリーランスとして働きたいのかで、必要になる学び方もサービスも大きく変わ...

まとめ

ChatGPT APIをPythonで使う手順を振り返ります。

  1. Python環境の確認(3.9以上)
  2. OpenAIライブラリのインストール(pip install openai)
  3. APIキーの取得と環境変数への設定
  4. サンプルコードの実行
  5. エラー対処とセキュリティ対策

ここまでの作業は、環境が整っていれば短時間で進められます。まずは小さなスクリプトから始めてみてください。

📦 この記事で紹介した商品

👉 「Pythonの入門書」を見る
Amazon 楽天 Yahoo!

👉 「pandasでデータ分析の本」を見る
Amazon 楽天 Yahoo!

👉 「LLMアプリ開発の本」を見る
Amazon 楽天 Yahoo!

ナビ助
ナビ助
「プログラミング経験がないから」と尻込みする必要はないよ。PythonとChatGPT APIの組み合わせは、初心者でも取り組みやすいよ。まず動かしてみてから考えるのも一つの学び方だね。
タイトルとURLをコピーしました