ChatGPT APIをcurlで試す – Windowsで最も簡単な呼び出し方法

はじめに
「ChatGPTをAPIで使ってみたいけど、どう始めればいいのか分からない」
そんな方のために、最もシンプルな方法でChatGPT APIをcurlから呼び出す手順をまとめました。
この記事では、OpenAIのAPIキーの取得から、実際にcurlで呼び出してAIの応答を得るまでを、Windows環境に合わせて丁寧に解説します。

必要なもの
・OpenAIのアカウント（無料で作成可能）
・APIキー（後述）
・Windows 10以降（標準でcurlコマンドが使えます）

  1. OpenAIのAPIキーを取得する方法
    まず、OpenAIの公式サイト（https://platform.openai.com/）にアクセスしてログインします。
    「API Keys」メニューから新しいキーを作成し、表示された「sk-」で始まるAPIキーをコピーして安全に保存します。
    ※このキーは一度しか表示されません。再表示はできないため、忘れないよう注意してください。
  2. curlでChatGPT APIを呼び出す（Windows用）
    以下のコマンドをコマンドプロンプトに貼り付けて実行します。
    「YOUR_API_KEY」の部分を、自分の取得したAPIキーに置き換えてください。
curl https://api.openai.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"model\": \"gpt-3.5-turbo\", \"messages\": [{\"role\": \"user\", \"content\": \"こんにちは、自己紹介して\"}]}"

API keyの部分はBearer sk-proj-xxxxxxxのようにBearerは残します。

この1行を実行すると、ChatGPTが返答を含むJSON形式の結果を返してくれます。

  1. 実行結果の一例
{
  "id": "chatcmpl-xxxxx",
  "object": "chat.completion",
  "created": xxxxx,
  "model": "gpt-3.5-turbo-0125",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "います。\n\n私はAIアシスタントです。自然言語処理や機械学習を活用して、ユーザーの質問や要望に応じた情報を提供することができます。日本語にも対応しており、さまざまなトピックに関する知識やアドバイスを提供することができます。どうぞお気軽にご質問やお話しをしてください。お手伝いできることがあれば、喜んで対応させていただきます。よろしくお願いいたします。",
        "refusal": null,
        "annotations": []
      },
      "logprobs": null,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 16,
    "completion_tokens": 178,
    "total_tokens": 194,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "audio_tokens": 0
    },
    "completion_tokens_details": {
      "reasoning_tokens": 0,
      "audio_tokens": 0,
      "accepted_prediction_tokens": 0,
      "rejected_prediction_tokens": 0
    }
  },
  "service_tier": "default",
  "system_fingerprint": null
}

ChatGPTが「こんにちは、私はAIアシスタントです…」といった返答を返してくるのが確認できます。

  1. Windowsで注意するポイント
    ・Linuxのコマンド例では複数行で書かれることがありますが、Windowsのコマンドプロンプトではすべて1行で書く必要があります。
    ・JSON文字列の中に使うダブルクォートは、” のようにエスケープが必要です。
    ・シングルクォート（’）はWindowsのcmdでは使えないため、必ずダブルクォート（”）を使います。
  2. セキュリティの注意
    APIキーはあなた専用の認証情報です。
    他人に見られたり、誤ってネットに公開したりしないように十分注意してください。
    無料プランにはトークン使用量の上限があるため、利用状況はOpenAIのダッシュボードで確認できます。

まとめ
ChatGPT APIは、curlを使えば数分で動作確認ができます。
手元のPCから簡単にAPIにアクセスし、AIの応答を得ることができる体験は非常にわかりやすく、今後の応用にもつながります。
初めての方でもこの記事を参考にすれば、安心して第一歩を踏み出せるはずです。

関連リンク
OpenAI API公式ドキュメント：https://platform.openai.com/docs
API使用状況の確認：https://platform.openai.com/account/usage

タイトルとURLをコピーしました