コンテンツにスキップ

Top

主要AI APIの使い方まとめ

目的

OpenAI、Grok(xAI)、Gemini の各APIを使って、Pythonから質問を送り、回答を取得するための最小限の方法をまとめる。


1. OpenAI API

1.1 APIキーの取得方法

  1. OpenAI Platform にログインする
  2. API Keys ページを開く
  3. Create new secret key を押す
  4. 表示されたAPIキーをコピーする
  5. 環境変数 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キーの取得方法

  1. xAI Console にログインする
  2. 必要なら Billing / Credits で支払い設定をする
  3. API Keys ページを開く
  4. Create API Key を押す
  5. 表示されたAPIキーをコピーする
  6. 環境変数 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キーの取得方法

  1. Google AI Studio にアクセスする
    https://aistudio.google.com/app/apikey

  2. Googleアカウントでログインする

  3. Create API key を押す

  4. Google Cloud プロジェクトを選ぶ
    なければ新規作成する

  5. 表示されたAPIキーをコピーする

  6. 環境変数 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を使う基本の流れは、どのサービスでもほぼ同じ。

  1. APIキーを取得する
  2. APIキーを環境変数に設定する
  3. SDKをインストールする
  4. Pythonコードから質問を送る
  5. 回答テキストを表示する

最小限の構成では、まず「1つの質問を送って、回答を表示する」ところまで動かせれば十分。

その後、必要に応じて以下のような機能に拡張できる。

  • チャット履歴の保持
  • ストリーミング出力
  • 画像入力
  • ファイル入力
  • ツール呼び出し
  • WebアプリやSlack Botへの組み込み