主要AI APIの使い方まとめ
目的
OpenAI、Grok(xAI)、Gemini の各APIを使って、Pythonから質問を送り、回答を取得するための最小限の方法をまとめる。
1. OpenAI API
1.1 APIキーの取得方法
- OpenAI Platform にログインする
- API Keys ページを開く
- Create new secret key を押す
- 表示されたAPIキーをコピーする
- 環境変数
OPENAI_API_KEYに設定する
1.2 環境変数の設定
Mac / Linux:
export OPENAI_API_KEY="コピーしたAPIキー"
Windows PowerShell:
$env:OPENAI_API_KEY = "コピーしたAPIキー"
※ $env:... は、現在開いているPowerShellですぐ使える一時的な設定。
永続化したい場合:
setx OPENAI_API_KEY "コピーしたAPIキー"
※ setx は次回以降に開くPowerShellで有効になる。
1.3 SDKのインストール
pip install openai
1.4 最小限のPythonコード
from openai import OpenAI
client = OpenAI()
response = client.responses.create(
model="gpt-4.1-mini", # 利用可能なモデル名に置き換えてください
input="日本で一番高い山は?"
)
print(response.output_text)
2. Grok(xAI)API
2.1 APIキーの取得方法
- xAI Console にログインする
- 必要なら Billing / Credits で支払い設定をする
- API Keys ページを開く
- Create API Key を押す
- 表示されたAPIキーをコピーする
- 環境変数
XAI_API_KEYに設定する
2.2 環境変数の設定
Mac / Linux:
export XAI_API_KEY="コピーしたAPIキー"
Windows PowerShell:
$env:XAI_API_KEY = "コピーしたAPIキー"
※ $env:... は、現在開いているPowerShellですぐ使える一時的な設定。
永続化したい場合:
setx XAI_API_KEY "コピーしたAPIキー"
※ setx は次回以降に開くPowerShellで有効になる。
2.3 SDKのインストール
pip install openai
2.4 最小限のPythonコード
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
response = client.responses.create(
model="grok-4.3", # 利用可能なモデル名に置き換えてください
input="日本で一番高い山は?"
)
print(response.output_text)
3. Gemini API
3.1 APIキーの取得方法
-
Google AI Studio にアクセスする
https://aistudio.google.com/app/apikey -
Googleアカウントでログインする
-
Create API key を押す
-
Google Cloud プロジェクトを選ぶ
なければ新規作成する -
表示されたAPIキーをコピーする
-
環境変数
GEMINI_API_KEYに設定する
3.2 環境変数の設定
Mac / Linux:
export GEMINI_API_KEY="コピーしたAPIキー"
Windows PowerShell:
$env:GEMINI_API_KEY = "コピーしたAPIキー"
※ $env:... は、現在開いているPowerShellですぐ使える一時的な設定。
永続化したい場合:
setx GEMINI_API_KEY "コピーしたAPIキー"
※ setx は次回以降に開くPowerShellで有効になる。
3.3 SDKのインストール
pip install -U google-genai
3.4 最小限のPythonコード
from google import genai
client = genai.Client()
response = client.models.generate_content(
model="gemini-3-flash-preview", # 利用可能なモデル名に置き換えてください
contents="日本で一番高い山は?"
)
print(response.text)
4. APIキーの扱いに関する注意点
APIキーはパスワードと同じように扱う。
やってはいけないこと
- GitHubなどの公開リポジトリに貼る
- SNSやチャットにそのまま送る
- コード内に直接書いて共有する
推奨される管理方法
- 環境変数に保存する
.envファイルを使う場合は.gitignoreに追加する- 万が一漏れた場合は、すぐにAPIキーを削除して作り直す
5. 3つのAPIの比較
| サービス | 環境変数名 | Python SDK | 主なポイント |
|---|---|---|---|
| OpenAI | OPENAI_API_KEY |
openai |
Responses API を使う |
| Grok(xAI) | XAI_API_KEY |
openai |
OpenAI互換APIとして base_url を指定する |
| Gemini | GEMINI_API_KEY |
google-genai |
Google公式SDKを使う |
6. 補足:OpenAIの旧形式について
OpenAI SDKでは、以前からある Chat Completions API の形式も見かけることがある。
旧形式の例:
from openai import OpenAI
client = OpenAI()
response = client.chat.completions.create(
model="gpt-4.1-mini",
messages=[
{"role": "user", "content": "日本で一番高い山は?"}
]
)
print(response.choices[0].message.content)
ただし、現在の最小コードとしては、Responses API の形式を優先する。
推奨形式:
response = client.responses.create(
model="gpt-4.1-mini",
input="日本で一番高い山は?"
)
print(response.output_text)
7. まとめ
PythonからAI APIを使う基本の流れは、どのサービスでもほぼ同じ。
- APIキーを取得する
- APIキーを環境変数に設定する
- SDKをインストールする
- Pythonコードから質問を送る
- 回答テキストを表示する
最小限の構成では、まず「1つの質問を送って、回答を表示する」ところまで動かせれば十分。
その後、必要に応じて以下のような機能に拡張できる。
- チャット履歴の保持
- ストリーミング出力
- 画像入力
- ファイル入力
- ツール呼び出し
- WebアプリやSlack Botへの組み込み