エラーと制限

GetVibe が/v1/*で生成するエラーには、error.message、error.type、error.codeを含む JSON エンベロープがあります。メッセージテキストやサードパーティサービスのヘッダーを契約として依存しないでください。

{
  "error": {
    "message": "insufficient balance",
    "type": "insufficient_quota",
    "code": 402,
    "request_id": "8d4b6b3a-..."
  }
}

すべてのリクエストエラーには、以下の表にある安定した error.code、該当するフィールドを示す error.param（モデルがフィールド名を指定しなかった場合は null）、および error.message の末尾に対応する行へのリンクが含まれます。CodexなどのCLIではメッセージのみが表示されるため、リンクもそこに表示されます。

遅いストリーム(stream: true)では、接続が切れたように見えないよう、5 秒間の無通信後に 200 と : pv-keepalive のコメントが送信されます。長い非ストリーム リクエストでは、最初のトークン後に 200 と空白が送信されます。以降、ステータスは変更できず、エラーはボディ内で通知されます。クライアントが HTTP エラー時に別のサプライヤーへフォールバックする場合は、x-pv-honest-errors: 1 を送信してください(またはサポートに依頼してアカウントで有効化してもらってください)。その場合、keepalive はなく、最初のレスポンス バイトより前に 200 が返ることもなく、すべての失敗は JSON ボディを伴う通常の HTTP ステータスになります。代償として、最初のトークンまでソケットは無応答になります。ヘッダー タイムアウトはこれをカバーする必要があります。

レスポンスが開始された後のエラーは 1 つの終端イベントです。チャットの場合は event: error で {"error":{message,type,code,status},"choices":[{"finish_reason":"error"}]} に続いて data: [DONE]、/v1/responses の場合は同じ error を持つ event: response.failed、/v1/messages の場合は Anthropic の event: error です。code は機械的な原因で、status はレスポンスが開始される前にエラーが持っていたであろう HTTP ステータスです。

どちらの制限もアカウントの現在の残高によって決まり、そのアカウントのすべてのAPIキーに対して合算で適用されます。ティアは自動的に再計算されます。残高をチャージすると上限が上がり、残高がしきい値を下回るとティアが下がります。1分あたりのトークン数（TPM）の制限はありません。

再試行可能なレスポンスには、まず存在すれば Retry-After を使用してください。ヘッダーがない場合、429 や 503 を自動的に再試行可能と見なさないでください。HTTP ステータスと公開されている error.type を確認し、再試行できない原因を修正し、一時的なエラーにのみ上限付きのバックオフを使用してください。

import time, requests

def call_with_retry(url, headers, payload, max_retries=5):
    for attempt in range(max_retries):
        r = requests.post(url, headers=headers, json=payload)
        if r.status_code == 429:
            # honor Retry-After, otherwise exponential backoff
            wait = int(r.headers.get("Retry-After", 2 ** attempt))
            time.sleep(wait)
            continue
        return r
    return r