ドキュメント

API クイックスタート

以下の例でアプリやスクリプトから API を呼び出せます。Claude Code や Codex などはツール設定ガイドをご覧ください。

  1. ウォレットにチャージして、API キーを作成します。
  2. モデル一覧から、使用するエンドポイントに対応したモデルを選びます。
  3. 以下の手順で 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 に貼り付け
Pythonrequest.pypython3 request.py
JavaScriptrequest.mjsnode 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 が返ります。生成テキストとトークン使用量は以下のフィールドで確認できます。レスポンスの詳細はモデルによって異なります。

プロトコル生成テキストトークン使用量
Messagescontent[].textusage
Responsesoutput[].content[].textusage
Chat Completionschoices[].message.contentusage
Geminicandidates[].content.parts[].textusageMetadata

400 の場合はモデル ID とエンドポイントを確認してください。認証や残高の問題はよくあるエラーをご覧ください。

次に読む