DrAI API クイックスタート
アカウントを作成して API キーを取得し、curl・Python・JavaScript で gpt-5-mini に最初のリクエストを送るまでを 5 分でご案内します。
-
アカウントを作成して API キーを取得する
DrAI ダッシュボード にメールアドレスでサインインし、API キー を開いて キーを作成 をクリックします。キーは一度しか表示されないため、必ずコピーしておきましょう。
キーは秘密にしてください。 キーがあればサブスクリプションの利用枠にアクセスできます。環境変数やシークレットマネージャーで管理し、フロントエンドのコードに埋め込まないでください。 -
curl で最初のリクエストを送る
ターミナルを開いて、次のコマンドを実行します:
curl https://api.dr-ai.top/v1/chat/completions \ -H "Authorization: Bearer ***" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5-mini", "messages": [ {"role": "system", "content": "You are a concise assistant."}, {"role": "user", "content": "Say hello in one sentence."} ], "max_tokens": 200 }'1〜2 秒で JSON レスポンスが返ってきます:
{ "id": "chatcmpl-9xK2mQ7r...", "object": "chat.completion", "model": "gpt-5-mini", "choices": [{ "index": 0, "message": { "role": "assistant", "content": "Hello! I'm here to help." }, "finish_reason": "stop" }], "usage": {"prompt_tokens": 24, "completion_tokens": 9, "total_tokens": 33} }これが最初の AI レスポンスです。🎉 他のエンドポイントも同じように使えます。詳しくは API リファレンス をご覧ください。
-
Python SDK
公式の
openaiパッケージがそのまま使えます。変更するのはbase_urlだけです。pip install openaifrom openai import OpenAI client = OpenAI( api_key="«redacted:sk-…»", base_url="https://api.dr-ai.top/v1", ) resp = client.chat.completions.create( model="gpt-5-mini", messages=[ {"role": "system", "content": "You are a helpful assistant."}, {"role": "user", "content": "What is 12 * 12?"}, ], temperature=0.7, ) print(resp.choices[0].message.content)本番環境では環境変数を使いましょう。
OPENAI_API_KEYをエクスポートしてclient = OpenAI(base_url="https://api.dr-ai.top/v1")と書けば、SDK が自動で読み込みます。 -
JavaScript / Node.js
Node.js 用の公式 SDK も、たった 1 行の変更で使えます:
npm install openaiimport OpenAI from "openai"; const client = new OpenAI({ apiKey: "«redacted:sk-…»", baseURL: "https://api.dr-ai.top/v1", }); const resp = await client.chat.completions.create({ model: "gpt-5-mini", messages: [{ role: "user", content: "Hello from Node.js!" }], }); console.log(resp.choices[0].message.content);ストリーミングも簡単です。
stream: trueを追加してfor await (const chunk of resp)で受信できます。 -
次のステップ
- 最適なモデルを選ぶ — モデルカタログを見る
- ストリーミング対応 — SSE ストリーミングのリファレンス
- エラーハンドリング — エラーコード表
- コスト試算 — モデル価格インデックス
よくある質問
初日に開発者から最もよく寄せられる質問です。
どのベース URL を使えばいいですか?
すべてのリクエストで https://api.dr-ai.top/v1 を使用します。API は OpenAI 互換なので、このベース URL を指定するだけで既存の OpenAI SDK がそのまま動作します。
API キーはどうやって取得しますか?
ai.dr-ai.top にサインインし、ダッシュボードの API キー でキーを作成します。キーは sk- で始まり、一度しか表示されないため、サーバー側で保管してください。
最初にどのモデルを使うべきですか?
gpt-5-mini が最速かつ最安のデフォルトモデルです(入力 100 万トークンあたり $0.15)。より難しい推論タスクには gpt-5 または claude-opus-4 をお使いください。
ストリーミングは使えますか?
はい。stream: true を指定するとサーバー送信イベント(SSE)で応答を受信できます。詳細は API リファレンスのストリーミングの節 をご覧ください。
さっそく作り始めましょう
無料アカウントの作成は 30 秒で完了します。1 つのキーで 18 以上のモデルが使えます。
無料で始める API リファレンスを見る