Errors

{ "error": "out of credit — top up via POST /deposits" }

type ApiError = {
  status: number;
  message: string;
  code?: string;
  retryAfter?: number;
};

async function apiError(res: Response): Promise<ApiError> {
  let body: any = null;
  try {
    body = await res.json();
  } catch {
    // empty body
  }

  const error = body?.error;
  const retryAfter =
    Number(res.headers.get("retry-after") || 0) || undefined;

  if (typeof error === "string") {
    return { status: res.status, message: error, retryAfter };
  }
  if (error && typeof error === "object") {
    return {
      status: res.status,
      message: error.message ?? "request failed",
      code: error.code,
      retryAfter,
    };
  }
  return {
    status: res.status,
    message: res.statusText || "request failed",
    retryAfter,
  };
}

400  invalid input
400  invalid email
400  invalid email domain
400  <provider> addresses can sign up   (provider not on the server allowlist)
400  disposable email addresses are not accepted
400  that email domain cannot receive mail
400  that email domain is too new — use a longer-standing address
400  captcha token missing
400  captcha failed — try again
409  an account already exists for this address
429  an account was already created from this network today
429  an account was already created from this device today

{ "error": "prompt is too long: ~1,200,000 tokens exceeds the 1,000,000 token context window of <id>" }

{ "error": "daily input limit reached for this model: 690,000/700,000 tokens used today (resets at 00:00 UTC)" }

{ "error": "daily output limit reached for this model: 300,000/300,000 tokens used today (resets at 00:00 UTC)" }