GASでClaude APIの429エラーに強い
自動リトライを実装する方法

// APIキーはコードに直書きせず、スクリプトプロパティに保存しておく
// プロジェクトの設定 > スクリプト プロパティ に CLAUDE_API_KEY を登録
function callClaude(userText) {
  const apiKey = PropertiesService.getScriptProperties()
    .getProperty("CLAUDE_API_KEY");

  const payload = {
    model: "claude-haiku-4-5",
    max_tokens: 512,
    messages: [{ role: "user", content: userText }],
  };

  const res = UrlFetchApp.fetch("https://api.anthropic.com/v1/messages", {
    method: "post",
    contentType: "application/json",
    headers: {
      "x-api-key": apiKey,
      "anthropic-version": "2023-06-01",
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true, // ← これが重要（後述）
  });

  const code = res.getResponseCode();
  const body = JSON.parse(res.getContentText());

  if (code === 200) {
    return body.content[0].text;
  }
  throw new Error("Claude API error " + code + ": " + res.getContentText());
}

// muteHttpExceptions を付けないと、200以外のとき
// UrlFetchApp.fetch() が即座に例外を投げてしまい、
// ステータスコードを見て分岐する前に処理が止まってしまう。

// 付けた場合は、200でも429でも例外を投げずにレスポンスを返すので、
// getResponseCode() で自分で判定できる。
function classifyStatus(code) {
  if (code === 200) return "ok";        // 成功
  if (code === 429) return "retry";     // レート制限 → 待って再送
  if (code >= 500) return "retry";      // サーバー側の一時エラー → 再送
  if (code === 401 || code === 403) return "fatal"; // 認証エラー → 停止
  if (code >= 400) return "fatal";      // リクエスト不正 → 停止
  return "retry";
}

// 指数バックオフ＋ジッター付きの自動リトライ
function callClaudeWithRetry(userText, maxRetries) {
  maxRetries = maxRetries || 5;
  const apiKey = PropertiesService.getScriptProperties()
    .getProperty("CLAUDE_API_KEY");

  const options = {
    method: "post",
    contentType: "application/json",
    headers: {
      "x-api-key": apiKey,
      "anthropic-version": "2023-06-01",
    },
    payload: JSON.stringify({
      model: "claude-haiku-4-5",
      max_tokens: 512,
      messages: [{ role: "user", content: userText }],
    }),
    muteHttpExceptions: true,
  };

  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    const res = UrlFetchApp.fetch(
      "https://api.anthropic.com/v1/messages",
      options
    );
    const code = res.getResponseCode();

    if (code === 200) {
      return JSON.parse(res.getContentText()).content[0].text;
    }

    const kind = classifyStatus(code);
    if (kind === "fatal" || attempt === maxRetries) {
      throw new Error("Claude API error " + code + ": " + res.getContentText());
    }

    // 待機時間 = 基本待機(1秒) × 2^attempt ＋ ジッター
    const base = 1000 * Math.pow(2, attempt); // 1s, 2s, 4s, 8s, 16s
    const jitter = Math.floor(Math.random() * 500); // 0〜0.5秒のズレ
    const waitMs = Math.min(base + jitter, 32000);   // 上限32秒
    Logger.log("attempt " + attempt + " failed (" + code + "). wait " + waitMs + "ms");
    Utilities.sleep(waitMs);
  }
}

// 429のとき、レスポンスヘッダーに retry-after（秒数）が
// 入っていることがある。あればその値を優先して待つ。
function getWaitMs(res, attempt) {
  const headers = res.getAllHeaders();
  // ヘッダー名は環境によって大文字小文字が異なるため両方見る
  const retryAfter = headers["retry-after"] || headers["Retry-After"];

  if (retryAfter) {
    const sec = parseInt(retryAfter, 10);
    if (!isNaN(sec)) {
      return Math.min(sec * 1000 + 250, 32000);
    }
  }

  // ヘッダーが無ければ指数バックオフにフォールバック
  const base = 1000 * Math.pow(2, attempt);
  const jitter = Math.floor(Math.random() * 500);
  return Math.min(base + jitter, 32000);
}

// fetchAll なら複数リクエストを1回のまとめ呼び出しで送れる。
// ただし一度に送りすぎると429を誘発するので、chunkで小分けにする。
function callClaudeBatch(texts, chunkSize) {
  chunkSize = chunkSize || 5; // 一度に送る本数を絞る
  const apiKey = PropertiesService.getScriptProperties()
    .getProperty("CLAUDE_API_KEY");
  const results = [];

  for (let i = 0; i < texts.length; i += chunkSize) {
    const chunk = texts.slice(i, i + chunkSize);

    const requests = chunk.map((text) => ({
      url: "https://api.anthropic.com/v1/messages",
      method: "post",
      contentType: "application/json",
      headers: {
        "x-api-key": apiKey,
        "anthropic-version": "2023-06-01",
      },
      payload: JSON.stringify({
        model: "claude-haiku-4-5",
        max_tokens: 512,
        messages: [{ role: "user", content: text }],
      }),
      muteHttpExceptions: true,
    }));

    const responses = UrlFetchApp.fetchAll(requests);

    responses.forEach((res, j) => {
      if (res.getResponseCode() === 200) {
        results.push(JSON.parse(res.getContentText()).content[0].text);
      } else {
        // 失敗した1件だけ、単発のリトライ関数で送り直す
        results.push(callClaudeWithRetry(chunk[j]));
      }
    });

    Utilities.sleep(1000); // chunk間に間隔を空けて頻度を下げる
  }
  return results;
}