お使いのツールを、APIキー1つで。

キーの漏えい

お客様のキーが公開のGitHubリポジトリに掲載されると、GitHubから数秒以内に当サイトへ通知が届き、そのキーは直ちに無効化されます。その後、アカウントのメールアドレス宛に、該当のキーと見つかった場所を記載したメールが送信されます。

無効化されたキーは直ちに使えなくなり、そのキーを含むリクエストにはすべて401 unauthorizedが返されます。アカウント、残高、ほかのキーには影響しません。

次に行うこと

1. コンソールで代わりのキーを作成し、アプリケーションに設定してください。
2. コードから古いキーを削除してください。該当の行を消すだけでは不十分です。キーはリポジトリの履歴に残るため、履歴を書き換えるか、そのキーを恒久的に公開されたものとして扱ってください。
3. キーをソースコードに含めないようにしてください。環境変数やシークレット管理サービスから読み込み、キーを保存したファイルは.gitignoreに記載します。

漏えいにご自身で気づいた場合

コンソールでキーをご自身で無効化し（即時に反映されます）、代わりのキーを作成してください。第三者に使われた可能性がある場合は、お問い合わせください。そのキーのリクエスト履歴を一緒に確認します。

ストリーミング

streamをtrueに設定すると、OpenAI APIと同じ形式のサーバー送信イベントとして応答が返されます。公式クライアントはいずれも、そのまま対応しています。

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="/v1")
stream = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

ストリーミングでも課金方法は同じです。最後のチャンクに使用量が含まれ、送信したテキストと受信したテキストから計算されます。大型モデルではこの値をもとに課金額が計算され、無料モデルは課金されません。

画像

画像を読み取れるモデルには、ユーザーメッセージの中で画像を渡します。テキストと各画像をcontentの要素として指定し、画像はそれぞれbase64のデータURLにします。

{
  "model": "MODEL_ID",
  "messages": [{
    "role": "user",
    "content": [
      { "type": "text", "text": "What is in this picture?" },
      { "type": "image_url",
        "image_url": { "url": "data:image/jpeg;base64,/9j/4AAQ..." } }
    ]
  }]
}

現在、画像を読み取れるモデル： 一覧を読み込み中…

大型モデルでは、画像を含むリクエストごとに、テキストとは別に画像1枚あたり一定額が課金されます。無料モデルでは画像は課金されません。1回のリクエストに含められる画像は最大8枚で、いずれもPNG、JPEG、WebP、GIFのいずれかの形式、3MB以下である必要があります。画像を読み取れないモデルに画像を送ると、model_no_visionで拒否され、課金されません。画像は応答の生成のためにモデルの提供元に渡され、当サイトには保存されません。

モデル

現在呼び出せるモデルは次のとおりです。無料モデルは課金されず、呼び出し回数に上限があります。それ以外のモデルの費用の列は約束された金額ではなく実測値で、1回の応答にかかった費用（ドル）の30日間の平均です。そのため、長い応答では高くなり、短い応答では低くなります。

モデルは独立した第三者の提供元を通じて提供されますが、リクエストの形式は共通です。そのため、モデルを切り替えるときにコード内で変更するのは文字列1つだけです。一覧は予告なく変わることがあります。名前をコードに直接書かず、実行時にモデルのエンドポイントから取得してください。

各モデルの提供元を含む同じ一覧は、モデルページにあります。コードから一覧を取得するには、キーを指定してモデルのエンドポイントを呼び出します。

curl "/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

課金と上限

残高は米ドルで計算され、チャージによってのみ加算されます。お支払い金額がそのまま残高になり、有効期限はありません。Claude、GPTなどの大型モデルは、送受信した画面に表示されるテキストの量から計算された利用量に応じて残高から課金されます。DeepSeekのコーディング用ラインは、DeepSeekがその呼び出しに対して請求した金額で課金されます。無料モデルは課金されず、呼び出し回数に上限があります。長いメッセージは複数回として数えられます。長さはリクエストで送信するすべての内容（それまでの会話、ペルソナ、ファイルのテキストを含む）で数え、漢字、ひらがな、カタカナ、全角の句読点は1文字を1、半角の英数字、スペース、記号は4文字を1として数え、50,000ごとに（端数も含めて）1回になります。課金対象のモデルへの1回のAPIリクエストで、初めて高額になる見込みの場合、当サイトはそのリクエストを実行せず、見積額を記載した通常の応答を返します。この場合、課金はされません。同じリクエストをもう一度送ると、通常どおり実行されます。この規模のリクエストについては再度の通知は行わず、1回のリクエストの見込み額が10倍になったときにのみ、あらためて通知します。

各モデルの料金は料金ページに掲載しています。チャージもこちらから行えます。

残高はマイページまたはコードからいつでも確認できます。レスポンスの残高は当サイト内部の単位で返されるため、GET /api/infoのmoney.unitsPerUsdで割るとドルになります。

curl "/api/me" \
  -H "Authorization: Bearer YOUR_API_KEY"

エラー

すべてのエラーは、固定のcodeフィールドを持つJSONで返されます。判定にはメッセージの文面ではなくコードを使用してください。メッセージは人が読むためのもので、変更されることがあります。エラー本文の金額は当サイト内部の単位です。needやbalanceを含む場合は、同じ金額をドルで示すneedUsdやbalanceUsdも含まれます。同じリクエストを再送しても同じ理由で失敗する場合（無効なキー、残高不足、上限に達した場合など）は、レスポンスにx-should-retry: falseヘッダーも含まれます。再試行する価値があるのは、408、409、429、5xxのみです。拒否されるたびに再送するツール（Codex、omp、または拒否の数秒以内にそのまま再送されるストリーミングリクエスト）には、拒否の理由を記した通常の応答として返されるため、再送が止まります。

{
  "error": {
    "code": "not_enough_credit",
    "balance": 6000,
    "balanceUsd": 0.01,
    "need": 15000,
    "needUsd": 0.025,
    "message": "Insufficient balance: this request needs about $0.025 and your balance is $0.01. Top up, or switch to a free model."
  }
}

よくある質問