API クイックスタート
以下の例でアプリやスクリプトから API を呼び出せます。Claude Code や Codex などはツール設定ガイドをご覧ください。
- ウォレットにチャージして、API キーを作成します。
- モデル一覧から、使用するエンドポイントに対応したモデルを選びます。
- 以下の手順で
CODEBYAI_API_KEYを設定し、MODEL_IDを選択したモデルに置き換えて実行します。成功したリクエストは残高を消費します。キーを公開しないでください。
Messages は Claude に対応します。Responses は GPT・Codex・Claude に対応し、Chat Completions は Grok にも対応します。Gemini は専用エンドポイントを使います。未知の ID は HTTP 400 になります。デフォルトモデルを使うために省略できるのは、Messages・Responses・Chat Completions の JSON の model フィールドのみです。Gemini URL にはモデル ID が必須です。
ターミナルの準備
curl 7.76+、Python 3.10+ または Node.js 20+ を使用します。SDK のインストールは不要です。設定コマンドの YOUR_API_KEY を自分のキーに置き換え、CODEBYAI_API_KEY という名前は変更しません。リクエストを実行するターミナルで設定してください。新しいターミナルでは再設定が必要です。
macOS / Linux (bash / zsh):
1 export CODEBYAI_API_KEY="YOUR_API_KEY"
Windows PowerShell(Python と JavaScript の例用):
1 $env:CODEBYAI_API_KEY="YOUR_API_KEY"
生成したサンプルの実行
ホームページの生成ツールでプロトコル、モデル、言語を選び、例をコピーします。スクリプトはプレーンテキストで保存し、キーを設定した同じターミナルでファイルのフォルダーに移動して実行してください。
| 言語 | 保存名 | 実行方法 |
|---|---|---|
| curl | 不要 | bash / zsh に貼り付け |
| Python | request.py | python3 request.py |
| JavaScript | request.mjs | node request.mjs |
Windows の Python は python request.py で実行します。Node.js のコマンドは同じです。curl の例は bash / zsh 構文なので、Windows では Git Bash または WSL を使用してください。Python や JavaScript のコードを直接 shell に貼り付けないでください。以下の curl の例も同じ環境変数を使用します。
Set CODEBYAI_API_KEY と表示されたら、同じターミナルでキーを再設定してください。HTTP エラー時はステータスとエラー内容が表示されます。原因を確認してから再実行してください。
Anthropic Messages
1 curl --fail-with-body --max-time 120 https://www.codebyai.net/api/agent/v1/messages \2 -H "x-api-key: ${CODEBYAI_API_KEY:?Set CODEBYAI_API_KEY}" \3 -H "anthropic-version: 2023-06-01" \4 -H "content-type: application/json" \5 -d '{"model":"MODEL_ID","max_tokens":256,"messages":[{"role":"user","content":"Hello"}]}'
Claude モデルのみです。このエンドポイントは最初に x-api-key を読みます。anthropic-version は Claude チャネルへ転送されます。
OpenAI Responses
1 curl --fail-with-body --max-time 120 https://www.codebyai.net/api/agent/v1/responses \2 -H "Authorization: Bearer ${CODEBYAI_API_KEY:?Set CODEBYAI_API_KEY}" \3 -H "content-type: application/json" \4 -d '{"model":"MODEL_ID","input":"Hello"}'
GPT と Codex、それに claude-* も扱います。claude-* は Claude チャネルへ転送され、Claude の料金で課金されます。
OpenAI Chat Completions
1 curl --fail-with-body --max-time 120 https://www.codebyai.net/api/agent/v1/chat/completions \2 -H "Authorization: Bearer ${CODEBYAI_API_KEY:?Set CODEBYAI_API_KEY}" \3 -H "content-type: application/json" \4 -d '{"model":"MODEL_ID","messages":[{"role":"user","content":"Hello"}]}'
Chat Completions は GPT・Codex・Claude・Grok に対応します。Responses では Grok を利用できません。OpenAI SDK の base URL は https://www.codebyai.net/api/agent/v1 または https://www.codebyai.net/api/agent です。
Gemini
1 curl --fail-with-body --max-time 120 "https://www.codebyai.net/api/agent/v1beta/models/MODEL_ID:generateContent" \2 -H "x-goog-api-key: ${CODEBYAI_API_KEY:?Set CODEBYAI_API_KEY}" \3 -H "content-type: application/json" \4 -d '{"contents":[{"role":"user","parts":[{"text":"Hello"}]}]}'
Gemini モデルのみです。キーのヘッダーは x-goog-api-key です。
レスポンスを確認
成功すると HTTP 200 が返ります。生成テキストとトークン使用量は以下のフィールドで確認できます。レスポンスの詳細はモデルによって異なります。
| プロトコル | 生成テキスト | トークン使用量 |
|---|---|---|
| Messages | content[].text | usage |
| Responses | output[].content[].text | usage |
| Chat Completions | choices[].message.content | usage |
| Gemini | candidates[].content.parts[].text | usageMetadata |
400 の場合はモデル ID とエンドポイントを確認してください。認証や残高の問題はよくあるエラーをご覧ください。