ai-zero-token 2.0.5 → 2.0.7

package/dist/server/app.js

@@ -3,17 +3,33 @@ import { randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { Readable } from "node:stream";
+import { promisify } from "node:util";
 import { fileURLToPath } from "node:url";
+import {
+  brotliDecompress,
+  gunzip,
+  inflate,
+  zstdDecompress
+} from "node:zlib";
 import Fastify from "fastify";
 import cors from "@fastify/cors";
 import { z } from "zod";
 import { createGatewayContext } from "../core/context.js";
-import { requestText } from "../core/providers/http-client.js";
+import { isTransientHttpError, requestText } from "../core/providers/http-client.js";
 import { streamOpenAICodex } from "../core/providers/openai-codex/chat.js";
+import { generateChatGPTWebImage } from "../core/providers/openai-codex/chatgpt-web-image.js";
 const packageRoot = path.dirname(fileURLToPath(new URL("../../package.json", import.meta.url)));
 const adminUiDistDir = path.join(packageRoot, "admin-ui", "dist");
 const adminUiIndexPath = path.join(adminUiDistDir, "index.html");
+const BYTES_PER_MIB = 1024 * 1024;
 const MAX_GATEWAY_REQUEST_LOGS = 100;
+const MAX_CODEX_RESPONSE_PROFILE_BINDINGS = 5e3;
+const DEFAULT_ROUTE_BODY_LIMIT_BYTES = 128 * BYTES_PER_MIB;
+const CODEX_COMPACT_BODY_LIMIT_BYTES = 256 * BYTES_PER_MIB;
+const gunzipAsync = promisify(gunzip);
+const inflateAsync = promisify(inflate);
+const brotliDecompressAsync = promisify(brotliDecompress);
+const zstdDecompressAsync = typeof zstdDecompress === "function" ? promisify(zstdDecompress) : null;
 const assetContentTypes = {
   ".css": "text/css; charset=utf-8",
   ".gif": "image/gif",
@@ -31,6 +47,35 @@ const assetContentTypes = {
 function getContentType(filePath) {
   return assetContentTypes[path.extname(filePath).toLowerCase()] ?? "application/octet-stream";
 }
+async function decodeJsonRequestBody(body, contentEncoding) {
+  const encodings = (Array.isArray(contentEncoding) ? contentEncoding.join(",") : contentEncoding ?? "").split(",").map((item) => item.trim().toLowerCase()).filter((item) => item && item !== "identity");
+  let decoded = body;
+  for (const encoding of encodings.reverse()) {
+    if (encoding === "gzip" || encoding === "x-gzip") {
+      decoded = await gunzipAsync(decoded);
+    } else if (encoding === "deflate") {
+      decoded = await inflateAsync(decoded);
+    } else if (encoding === "br") {
+      decoded = await brotliDecompressAsync(decoded);
+    } else if (encoding === "zstd") {
+      if (!zstdDecompressAsync) {
+        throw new Error("\u5F53\u524D Node.js \u8FD0\u884C\u65F6\u4E0D\u652F\u6301 zstd \u8BF7\u6C42\u4F53\u89E3\u538B\uFF0C\u8BF7\u5347\u7EA7\u8FD0\u884C\u65F6\u540E\u91CD\u8BD5\u3002");
+      }
+      decoded = await zstdDecompressAsync(decoded);
+    } else {
+      throw new Error(`\u4E0D\u652F\u6301\u7684\u8BF7\u6C42\u4F53\u538B\u7F29\u683C\u5F0F: ${encoding}`);
+    }
+  }
+  return decoded;
+}
+async function parseJsonRequestBody(request, body) {
+  const rawBody = typeof body === "string" ? Buffer.from(body) : body;
+  if (rawBody.length === 0) {
+    return {};
+  }
+  const decoded = await decodeJsonRequestBody(rawBody, request.headers["content-encoding"]);
+  return JSON.parse(decoded.toString("utf8"));
+}
 async function readAdminUiAsset(assetPath) {
   const normalized = path.normalize(assetPath).replace(/^(\.\.(\/|\\|$))+/, "");
   const filePath = path.resolve(adminUiDistDir, normalized);
@@ -114,6 +159,9 @@ const settingsUpdateSchema = z.object({
   runtime: z.object({
     quotaSyncConcurrency: z.number().int().min(1).max(32).optional()
   }).optional(),
+  image: z.object({
+    freeAccountWebGenerationEnabled: z.boolean().optional()
+  }).optional(),
   server: z.object({
     port: z.number().int().min(1).max(65535)
   }).optional()
@@ -198,6 +246,82 @@ const imageEditsBodySchema = z.object({
   response_format: z.enum(["b64_json", "url"]).optional(),
   user: z.string().optional()
 }).passthrough();
+function isObjectRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function tokenNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.trunc(value) : null;
+}
+function normalizeTokenUsage(value) {
+  if (!isObjectRecord(value)) {
+    return null;
+  }
+  const inputTokens = tokenNumber(value.input_tokens ?? value.prompt_tokens);
+  const outputTokens = tokenNumber(value.output_tokens ?? value.completion_tokens);
+  const totalTokens = tokenNumber(value.total_tokens) ?? (inputTokens !== null || outputTokens !== null ? (inputTokens ?? 0) + (outputTokens ?? 0) : null);
+  if (inputTokens === null && outputTokens === null && totalTokens === null) {
+    return null;
+  }
+  return {
+    inputTokens,
+    outputTokens,
+    totalTokens
+  };
+}
+function extractTokenUsage(value, depth = 0) {
+  if (depth > 5 || !value) {
+    return null;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      const usage = extractTokenUsage(item, depth + 1);
+      if (usage) {
+        return usage;
+      }
+    }
+    return null;
+  }
+  if (!isObjectRecord(value)) {
+    return null;
+  }
+  const direct = normalizeTokenUsage(value);
+  if (direct) {
+    return direct;
+  }
+  for (const key of ["usage", "response", "events"]) {
+    const usage = extractTokenUsage(value[key], depth + 1);
+    if (usage) {
+      return usage;
+    }
+  }
+  return null;
+}
+function imageUsageToTokenUsage(usage) {
+  if (!usage) {
+    return null;
+  }
+  return {
+    inputTokens: usage.input_tokens,
+    outputTokens: usage.output_tokens,
+    totalTokens: usage.total_tokens
+  };
+}
+function extractUsageErrorType(details, statusCode) {
+  const error = isObjectRecord(details?.error) ? details.error : null;
+  const upstreamErrorCode = error?.upstreamErrorCode;
+  const upstreamStatus = error?.upstreamStatus;
+  const type = error?.type;
+  if (typeof upstreamErrorCode === "string" && upstreamErrorCode.trim()) {
+    return upstreamErrorCode.trim();
+  }
+  if (typeof type === "string" && type.trim()) {
+    return type.trim();
+  }
+  if (typeof upstreamStatus === "number") {
+    return `HTTP ${upstreamStatus}`;
+  }
+  return statusCode >= 400 ? `HTTP ${statusCode}` : void 0;
+}
 function extractTextFromInputContent(content) {
   if (typeof content === "string" && content.trim()) {
     return [content.trim()];
@@ -232,6 +356,49 @@ function extractTextInput(input) {
   }
   return chunks.join("\n").trim();
 }
+function extractImageUrlFromInputPart(part) {
+  if (!isObjectRecord(part)) {
+    return null;
+  }
+  const imageUrl = part.image_url ?? part.imageUrl;
+  if (typeof imageUrl === "string" && imageUrl.trim()) {
+    return imageUrl.trim();
+  }
+  if (isObjectRecord(imageUrl) && typeof imageUrl.url === "string" && imageUrl.url.trim()) {
+    return imageUrl.url.trim();
+  }
+  return null;
+}
+function extractImageInputs(input) {
+  const images = [];
+  const addImage = (imageUrl) => {
+    if (imageUrl && !images.some((item) => item.imageUrl === imageUrl)) {
+      images.push({ imageUrl });
+    }
+  };
+  if (!Array.isArray(input)) {
+    addImage(extractImageUrlFromInputPart(input));
+    return images;
+  }
+  for (const item of input) {
+    addImage(extractImageUrlFromInputPart(item));
+    if (!isObjectRecord(item)) {
+      continue;
+    }
+    const content = item.content;
+    if (Array.isArray(content)) {
+      for (const part of content) {
+        addImage(extractImageUrlFromInputPart(part));
+      }
+    } else {
+      addImage(extractImageUrlFromInputPart(content));
+    }
+  }
+  return images;
+}
+function isFreePlan(profile) {
+  return profile.quota?.planType?.toLowerCase() === "free";
+}
 function normalizeResponseInput(input) {
   if (typeof input === "undefined") {
     return void 0;
@@ -428,14 +595,14 @@ function summarizeToolNames(tools) {
     }
     const record = tool;
     const fn = record.function && typeof record.function === "object" ? record.function : null;
-    return typeof fn?.name === "string" ? fn.name : typeof record.name === "string" ? record.name : "";
+    return typeof fn?.name === "string" ? fn.name : typeof record.name === "string" ? record.name : typeof record.type === "string" ? record.type : "";
   }).filter(Boolean);
 }
-function summarizeResponsesRequest(data) {
+function summarizeResponsesRequest(data, endpoint = "/v1/responses") {
   const input = data.input;
   const toolNames = summarizeToolNames(Array.isArray(data.tools) ? data.tools : void 0);
   return {
-    endpoint: "/v1/responses",
+    endpoint,
     model: data.model ?? "default",
     stream: data.stream ?? false,
     inputKind: typeof input === "string" ? "string" : Array.isArray(input) ? "array" : "override",
@@ -447,9 +614,23 @@ function summarizeResponsesRequest(data) {
     toolNamesTruncated: toolNames.length > 50,
     toolChoice: typeof data.tool_choice === "undefined" ? "default" : typeof data.tool_choice,
     parallelToolCalls: data.parallel_tool_calls,
-    hasReasoning: Boolean(data.reasoning)
+    hasReasoning: Boolean(data.reasoning),
+    hasPreviousResponseId: Boolean(getPreviousResponseId(data))
   };
 }
+function getPreviousResponseId(data) {
+  const direct = data.previous_response_id;
+  if (typeof direct === "string" && direct.trim()) {
+    return direct.trim();
+  }
+  const experimental = data.experimental_codex?.body?.previous_response_id;
+  return typeof experimental === "string" && experimental.trim() ? experimental.trim() : void 0;
+}
+function removePreviousResponseId(body) {
+  const next = { ...body };
+  delete next.previous_response_id;
+  return next;
+}
 function createResponsesCodexBody(data) {
   const experimentalBody = data.experimental_codex?.body ?? {};
   const body = {
@@ -471,6 +652,119 @@ function createCodexPassthroughBody(data, model) {
   delete body.experimental_codex;
   return body;
 }
+function getImageGenerationTool(body) {
+  const tools = Array.isArray(body.tools) ? body.tools : [];
+  for (const tool of tools) {
+    if (isObjectRecord(tool) && tool.type === "image_generation") {
+      return tool;
+    }
+  }
+  return null;
+}
+function hasImageGenerationToolChoice(body) {
+  const choice = body.tool_choice;
+  if (typeof choice === "string") {
+    return choice === "image_generation";
+  }
+  return isObjectRecord(choice) && choice.type === "image_generation";
+}
+function normalizeImageOutputFormat(value) {
+  return value === "png" || value === "webp" || value === "jpeg" ? value : void 0;
+}
+function extractCodexImageGenerationRequest(body) {
+  const imageTool = getImageGenerationTool(body);
+  if (!hasImageGenerationToolChoice(body)) {
+    return null;
+  }
+  return {
+    prompt: extractTextInput(body.input),
+    inputImages: extractImageInputs(body.input),
+    imageModel: typeof imageTool?.model === "string" && imageTool.model.trim() ? imageTool.model.trim() : "gpt-image-2",
+    size: typeof imageTool?.size === "string" && imageTool.size.trim() ? imageTool.size.trim() : void 0,
+    outputFormat: normalizeImageOutputFormat(imageTool?.output_format)
+  };
+}
+async function writeResponsesSseBlock(reply, block) {
+  if (!reply.raw.write(block)) {
+    await new Promise((resolve) => reply.raw.once("drain", resolve));
+  }
+  return Buffer.byteLength(block);
+}
+async function writeResponsesSseEvent(reply, eventName, payload) {
+  return writeResponsesSseBlock(reply, `event: ${eventName}
+data: ${JSON.stringify(payload)}
+
+`);
+}
+async function sendSyntheticCodexImageSse(params) {
+  const responseId = `resp_${randomUUID().replace(/-/g, "")}`;
+  const created = Math.floor(Date.now() / 1e3);
+  const outputFormat = params.result.output_format ?? params.requestedOutputFormat ?? "png";
+  const size = params.result.size ?? params.requestedSize;
+  const output = params.result.data.map((image, index) => ({
+    id: `ig_${randomUUID().replace(/-/g, "")}`,
+    type: "image_generation_call",
+    status: "completed",
+    result: image.b64_json,
+    revised_prompt: image.revised_prompt ?? params.prompt,
+    output_format: outputFormat,
+    ...size ? { size } : {}
+  }));
+  let bytes = 0;
+  params.reply.raw.writeHead(200, {
+    "Content-Type": "text/event-stream; charset=utf-8",
+    "Cache-Control": "no-cache, no-transform",
+    Connection: "keep-alive",
+    "X-Accel-Buffering": "no"
+  });
+  params.reply.raw.flushHeaders?.();
+  bytes += await writeResponsesSseEvent(params.reply, "response.created", {
+    type: "response.created",
+    response: {
+      id: responseId,
+      object: "response",
+      created_at: created,
+      model: params.model,
+      status: "in_progress",
+      output: []
+    }
+  });
+  for (let index = 0; index < output.length; index += 1) {
+    const item = output[index];
+    bytes += await writeResponsesSseEvent(params.reply, "response.output_item.added", {
+      type: "response.output_item.added",
+      output_index: index,
+      item: {
+        id: item.id,
+        type: item.type,
+        status: "in_progress"
+      }
+    });
+    bytes += await writeResponsesSseEvent(params.reply, "response.output_item.done", {
+      type: "response.output_item.done",
+      output_index: index,
+      item
+    });
+  }
+  bytes += await writeResponsesSseEvent(params.reply, "response.completed", {
+    type: "response.completed",
+    response: {
+      id: responseId,
+      object: "response",
+      created_at: created,
+      model: params.model,
+      status: "completed",
+      output,
+      usage: null
+    }
+  });
+  bytes += await writeResponsesSseBlock(params.reply, "data: [DONE]\n\n");
+  params.reply.raw.end();
+  return {
+    bytes,
+    imageCount: output.length
+  };
+}
 function summarizeChatCompletionsRequest(data) {
   const lastUserMessage = [...data.messages].reverse().find((message) => (message.role ?? "user") === "user");
   const toolNames = summarizeToolNames(data.tools);
@@ -507,6 +801,42 @@ function summarizeCodexChatBody(body) {
     hasReasoning: Boolean(body.reasoning)
   };
 }
+async function buildOpenAIModelsResponse(ctx) {
+  return {
+    object: "list",
+    data: (await ctx.modelService.listModels()).map((model) => ({
+      id: model.id,
+      object: "model",
+      owned_by: model.provider
+    }))
+  };
+}
+async function buildCodexModelsResponse(ctx) {
+  const [models, catalog] = await Promise.all([
+    ctx.modelService.listModels(),
+    ctx.modelService.getCatalog()
+  ]);
+  return {
+    fetched_at: catalog.fetchedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    models: models.map((model, index) => ({
+      slug: model.id,
+      display_name: model.name,
+      description: model.name,
+      default_reasoning_level: "medium",
+      supported_reasoning_levels: [
+        { effort: "low", description: "Fast responses with lighter reasoning" },
+        { effort: "medium", description: "Balanced speed and reasoning" },
+        { effort: "high", description: "Deeper reasoning" },
+        { effort: "xhigh", description: "Extra deep reasoning" }
+      ],
+      shell_type: "shell_command",
+      visibility: "list",
+      supported_in_api: true,
+      priority: index,
+      input_modalities: model.input
+    }))
+  };
+}
 function profileLogLabel(profile) {
   return profile?.email || profile?.accountId || profile?.profileId || "-";
 }
@@ -827,18 +1157,35 @@ function getErrorStatusCode(error) {
   }
   return 500;
 }
-function isQuotaLimitError(error) {
-  const normalized = normalizeError(error);
-  const marker = `${normalized.upstreamErrorCode ?? ""} ${normalized.upstreamErrorType ?? ""} ${normalized.message}`.toLowerCase();
-  return normalized.upstreamStatus === 429 || marker.includes("usage_limit_reached");
+function formatBytesAsMiB(bytes) {
+  if (typeof bytes !== "number" || !Number.isFinite(bytes) || bytes <= 0) {
+    return "\u672A\u77E5";
+  }
+  return `${Math.round(bytes / BYTES_PER_MIB * 10) / 10} MB`;
 }
 function createSseStreamStats() {
   return {
     buffer: "",
     bytes: 0,
-    completed: false
+    completed: false,
+    responseIds: /* @__PURE__ */ new Set(),
+    tokenUsage: null
   };
 }
+function extractSseResponseId(value) {
+  if (!isObjectRecord(value)) {
+    return void 0;
+  }
+  const directId = value.id;
+  if (typeof directId === "string" && directId.startsWith("resp_")) {
+    return directId;
+  }
+  const response = value.response;
+  if (isObjectRecord(response) && typeof response.id === "string" && response.id.startsWith("resp_")) {
+    return response.id;
+  }
+  return void 0;
+}
 function trackSseChunk(stats, chunk) {
   const text = typeof chunk === "string" ? chunk : chunk instanceof Uint8Array ? Buffer.from(chunk).toString("utf8") : String(chunk);
   stats.bytes += Buffer.byteLength(text);
@@ -856,6 +1203,14 @@ function trackSseChunk(stats, chunk) {
         if (typeof parsed.type === "string") {
           eventType = parsed.type;
         }
+        const responseId = extractSseResponseId(parsed);
+        if (responseId) {
+          stats.responseIds.add(responseId);
+        }
+        const tokenUsage = extractTokenUsage(parsed);
+        if (tokenUsage) {
+          stats.tokenUsage = tokenUsage;
+        }
       } catch {
       }
     }
@@ -872,14 +1227,40 @@ function trackSseChunk(stats, chunk) {
   }
 }
 function createApp(params) {
+  const defaultBodyLimit = params?.bodyLimit ?? DEFAULT_ROUTE_BODY_LIMIT_BYTES;
+  const codexCompactBodyLimit = Math.max(defaultBodyLimit, CODEX_COMPACT_BODY_LIMIT_BYTES);
   const app = Fastify({
     logger: false,
-    bodyLimit: params?.bodyLimit
+    bodyLimit: defaultBodyLimit
   });
+  app.removeContentTypeParser("application/json");
+  app.addContentTypeParser(
+    /^application\/(?:[\w!#$&^.+-]+\+)?json(?:\s*;.*)?$/i,
+    { parseAs: "buffer" },
+    (request, body, done) => {
+      parseJsonRequestBody(request, Buffer.isBuffer(body) ? body : Buffer.from(body)).then((parsed) => done(null, parsed)).catch((error) => done(error));
+    }
+  );
   const ctx = createGatewayContext();
   const gatewayRequestLogs = [];
+  const codexResponseProfileBindings = /* @__PURE__ */ new Map();
+  function rememberCodexResponseProfile(responseId, profile) {
+    codexResponseProfileBindings.set(responseId, {
+      profileId: profile.profileId,
+      accountId: profile.accountId,
+      seenAt: Date.now()
+    });
+    if (codexResponseProfileBindings.size <= MAX_CODEX_RESPONSE_PROFILE_BINDINGS) {
+      return;
+    }
+    const overflow = codexResponseProfileBindings.size - MAX_CODEX_RESPONSE_PROFILE_BINDINGS;
+    const oldest = Array.from(codexResponseProfileBindings.entries()).sort((left, right) => left[1].seenAt - right[1].seenAt).slice(0, overflow);
+    for (const [key] of oldest) {
+      codexResponseProfileBindings.delete(key);
+    }
+  }
   function pushGatewayRequestLog(log) {
-    gatewayRequestLogs.unshift({
+    const entry = {
       id: log.id ?? randomUUID(),
       time: log.time ?? Date.now(),
       method: log.method,
@@ -890,10 +1271,34 @@ function createApp(params) {
       durationMs: log.durationMs,
       source: log.source,
       details: log.details
-    });
+    };
+    gatewayRequestLogs.unshift(entry);
     if (gatewayRequestLogs.length > MAX_GATEWAY_REQUEST_LOGS) {
       gatewayRequestLogs.length = MAX_GATEWAY_REQUEST_LOGS;
     }
+    const profile = log.usage?.profile ?? void 0;
+    const usageEvent = {
+      id: entry.id,
+      timestamp: entry.time,
+      method: entry.method,
+      endpoint: entry.endpoint,
+      model: entry.model,
+      source: entry.source,
+      statusCode: entry.statusCode,
+      durationMs: entry.durationMs,
+      success: entry.statusCode >= 200 && entry.statusCode < 400,
+      profileId: profile?.profileId,
+      accountId: profile?.accountId,
+      accountLabel: entry.account,
+      planType: profile?.quota?.planType,
+      tokenUsage: log.usage?.tokenUsage,
+      imageCount: log.usage?.imageCount,
+      imageRoute: log.usage?.imageRoute ?? "none",
+      errorType: log.usage?.errorType ?? extractUsageErrorType(log.details, entry.statusCode)
+    };
+    ctx.usageService.record(usageEvent).catch((error) => {
+      console.warn("[gateway:usage] \u7EDF\u8BA1\u5199\u5165\u5931\u8D25", error);
+    });
   }
   void app.register(cors, {
     origin: params?.corsOrigin ?? true,
@@ -902,26 +1307,31 @@ function createApp(params) {
   app.setErrorHandler((error, request, reply) => {
     const normalized = normalizeError(error);
     const statusCode = getErrorStatusCode(normalized);
+    const isBodyTooLarge = statusCode === 413;
+    const message = isBodyTooLarge ? `\u8BF7\u6C42\u4F53\u8FC7\u5927\uFF0C\u5F53\u524D\u7F51\u5173\u9ED8\u8BA4\u4E0A\u9650 ${formatBytesAsMiB(defaultBodyLimit)}\uFF0CCodex compact \u4E0A\u9650 ${formatBytesAsMiB(codexCompactBodyLimit)}\u3002\u5982\u4ECD\u4E0D\u591F\uFF0C\u8BF7\u7528 AZT_BODY_LIMIT_MB \u8C03\u5927\u540E\u91CD\u542F\u7F51\u5173\u3002` : normalized.message;
     console.error("[gateway:error]", {
       method: request.method,
       url: request.url,
       statusCode,
-      message: normalized.message,
+      message,
+      code: normalized.code,
+      upstreamRequestId: normalized.requestId,
       stack: normalized.stack
     });
     reply.code(statusCode);
     return {
       error: {
         type: "gateway_error",
-        message: normalized.message
+        message
       }
     };
   });
   app.get("/_gateway/admin/request-logs", async () => ({
     data: gatewayRequestLogs
   }));
+  app.get("/_gateway/admin/usage", async () => ctx.usageService.getSummary());
   async function buildAdminConfig(request) {
-    const [status, models, modelCatalog, versionStatus, settings, profile, profiles, codexStatus] = await Promise.all([
+    const [status, models, modelCatalog, versionStatus, settings, profile, profiles, codexStatus, usage] = await Promise.all([
       ctx.authService.getStatus(),
       ctx.modelService.listModels(),
       ctx.modelService.getCatalog(),
@@ -929,7 +1339,8 @@ function createApp(params) {
       ctx.configService.getSettings(),
       ctx.authService.getActiveProfile(),
       ctx.authService.listProfiles(),
-      ctx.authService.getCodexStatus()
+      ctx.authService.getCodexStatus(),
+      ctx.usageService.getSummary()
     ]);
     const origin = resolveOrigin(request);
     return {
@@ -941,6 +1352,7 @@ function createApp(params) {
       profile: serializeProfile(profile),
       profiles: profiles.map((item) => serializeManagedProfile(item)),
       codex: codexStatus,
+      usage,
       adminUrl: `${origin}/`,
       baseUrl: `${origin}/v1`,
       codexBaseUrl: `${origin}/codex/v1`,
@@ -962,6 +1374,11 @@ function createApp(params) {
           path: "/codex/v1/responses",
           description: "Codex custom provider \u4E13\u7528 Responses SSE \u900F\u4F20\u63A5\u53E3\u3002"
         },
+        {
+          method: "POST",
+          path: "/codex/v1/responses/compact",
+          description: "Codex custom provider \u4E13\u7528 Responses compact SSE \u900F\u4F20\u63A5\u53E3\u3002"
+        },
         {
           method: "POST",
           path: "/v1/chat/completions",
@@ -1409,21 +1826,28 @@ function createApp(params) {
     return ctx.githubImageBedService.deleteHistoryItem(parsed.data.id);
   });
   app.delete("/_gateway/image-bed/history", async () => ctx.githubImageBedService.clearHistory());
-  app.get("/v1/models", async () => ({
-    object: "list",
-    data: (await ctx.modelService.listModels()).map((model) => ({
-      id: model.id,
-      object: "model",
-      owned_by: model.provider
-    }))
-  }));
-  async function handleCodexResponsesPassthrough(request, reply, data, startedAt) {
+  app.get("/v1/models", async () => buildOpenAIModelsResponse(ctx));
+  app.get("/codex/v1/models", async () => buildCodexModelsResponse(ctx));
+  app.get("/codex/v1/responses", async (_request, reply) => {
+    reply.code(426);
+    return {
+      error: {
+        type: "websocket_unsupported",
+        message: "AI Zero Token \u5F53\u524D\u901A\u8FC7 HTTP SSE \u8F6C\u53D1 Codex Responses \u8BF7\u6C42\u3002"
+      }
+    };
+  });
+  async function handleCodexResponsesPassthrough(request, reply, data, startedAt, upstreamEndpoint = "responses") {
     const abortController = new AbortController();
     let streamFinished = false;
     let headersCommitted = false;
     let profile = null;
     let retryCount = 0;
     let failureRecorded = false;
+    let codexImageRoute = "none";
+    const originalPreviousResponseId = getPreviousResponseId(data);
+    let adventureFallbackUsed = false;
+    let adventureFallbackReason;
     reply.raw.on("close", () => {
       if (!streamFinished) {
         abortController.abort();
@@ -1433,25 +1857,162 @@ function createApp(params) {
       const model = await ctx.modelService.resolveModel("openai-codex", data.model, {
         allowUnknown: data.experimental_codex?.allow_unknown_model
       });
-      const codexBody = createCodexPassthroughBody(data, model);
+      let codexBody = createCodexPassthroughBody(data, model);
+      let activePreviousResponseId = originalPreviousResponseId;
+      let keepProfileSticky = Boolean(activePreviousResponseId);
+      let stickyProfileId = activePreviousResponseId ? codexResponseProfileBindings.get(activePreviousResponseId)?.profileId : void 0;
+      const useAdventureFallback = async (error, quota) => {
+        if (!keepProfileSticky || abortController.signal.aborted) {
+          return false;
+        }
+        const failedProfileId = profile?.profileId ?? stickyProfileId;
+        if (failedProfileId) {
+          await ctx.authService.recordProfileRequestFailure(failedProfileId, error, quota, "openai-codex", {
+            skipAutoSwitch: true
+          });
+        }
+        codexBody = removePreviousResponseId(codexBody);
+        activePreviousResponseId = void 0;
+        keepProfileSticky = false;
+        stickyProfileId = void 0;
+        adventureFallbackUsed = true;
+        adventureFallbackReason = error instanceof Error ? error.message : String(error);
+        retryCount += 1;
+        profile = null;
+        failureRecorded = false;
+        console.warn("[gateway:codex:stream] sticky continuation failed; dropping previous_response_id and retrying as new session", {
+          requestId: request.id,
+          model,
+          retryCount,
+          previousResponseId: "[present]",
+          failedAccount: failedProfileId,
+          errorCode: error.code,
+          upstreamStatus: error.upstreamStatus,
+          upstreamRequestId: error.requestId,
+          message: adventureFallbackReason
+        });
+        return true;
+      };
+      const imageRequest = upstreamEndpoint === "responses" ? extractCodexImageGenerationRequest(codexBody) : null;
+      if (imageRequest) {
+        codexImageRoute = "codex-tool";
+        const settings = await ctx.configService.getSettings();
+        if (settings.image.freeAccountWebGenerationEnabled) {
+          profile = await ctx.authService.requireUsableProfile("openai-codex", {
+            skipAutoSwitch: true
+          });
+        }
+        if (profile && isFreePlan(profile)) {
+          if (!imageRequest.prompt) {
+            throw new Error("Codex \u751F\u56FE\u8BF7\u6C42\u7F3A\u5C11\u6587\u672C prompt\u3002");
+          }
+          console.info("[gateway:codex:image] using ChatGPT web image route for Free profile", {
+            requestId: request.id,
+            account: profileLogLabel(profile),
+            model,
+            imageModel: imageRequest.imageModel,
+            promptLength: imageRequest.prompt.length,
+            inputImageCount: imageRequest.inputImages.length,
+            size: imageRequest.size ?? "default"
+          });
+          const imageResult = await generateChatGPTWebImage({
+            profile,
+            prompt: imageRequest.prompt,
+            model: imageRequest.imageModel,
+            inputImages: imageRequest.inputImages,
+            size: imageRequest.size,
+            responseFormat: "b64_json"
+          });
+          await ctx.authService.recordProfileRequestSuccess(profile.profileId, void 0, "openai-codex", {
+            skipAutoSwitch: true
+          });
+          headersCommitted = true;
+          const syntheticStats = await sendSyntheticCodexImageSse({
+            reply,
+            result: imageResult,
+            model,
+            prompt: imageRequest.prompt,
+            requestedSize: imageRequest.size,
+            requestedOutputFormat: imageRequest.outputFormat
+          });
+          streamFinished = true;
+          pushGatewayRequestLog({
+            method: request.method,
+            endpoint: request.url,
+            account: profileLogLabel(profile),
+            model,
+            statusCode: 200,
+            durationMs: performance.now() - startedAt,
+            source: "Codex",
+            details: {
+              requestId: request.id,
+              remoteAddress: request.ip,
+              userAgent: request.headers["user-agent"],
+              request: summarizeResponsesRequest(data, request.url),
+              response: {
+                stream: true,
+                passthrough: false,
+                upstreamEndpoint,
+                route: "chatgpt-web-image",
+                imageModel: imageRequest.imageModel,
+                imageCount: syntheticStats.imageCount,
+                bytes: syntheticStats.bytes
+              }
+            },
+            usage: {
+              profile,
+              imageCount: syntheticStats.imageCount,
+              imageRoute: "chatgpt-web"
+            }
+          });
+          return reply;
+        }
+      }
       let upstream = null;
       const maxProfileAttempts = 5;
+      const maxTransientStreamRetries = 1;
+      let transientStreamRetryCount = 0;
       for (let attempt = 0; attempt < maxProfileAttempts; attempt += 1) {
-        profile = await ctx.authService.requireUsableProfile("openai-codex");
         try {
+          profile = stickyProfileId ? await ctx.authService.requireUsableProfileById(stickyProfileId, "openai-codex") : await ctx.authService.requireUsableProfile("openai-codex", {
+            skipAutoSwitch: keepProfileSticky
+          });
           upstream = await streamOpenAICodex({
             profile,
             model,
             bodyOverride: codexBody,
+            endpoint: upstreamEndpoint,
             passthroughBody: true,
             signal: abortController.signal
           });
           break;
         } catch (error) {
           const quota = error.quota;
-          const switchedProfile = await ctx.authService.recordProfileRequestFailure(profile.profileId, error, quota, "openai-codex");
+          if (keepProfileSticky && attempt < maxProfileAttempts - 1 && await useAdventureFallback(error, quota)) {
+            continue;
+          }
+          if (!keepProfileSticky && isTransientHttpError(error) && transientStreamRetryCount < maxTransientStreamRetries && attempt < maxProfileAttempts - 1 && !abortController.signal.aborted) {
+            transientStreamRetryCount += 1;
+            retryCount += 1;
+            console.warn("[gateway:codex:stream] transient curl stream failure before headers; retrying request", {
+              requestId: request.id,
+              account: profileLogLabel(profile),
+              model,
+              retryCount,
+              errorCode: error.code,
+              upstreamRequestId: error.requestId,
+              message: error instanceof Error ? error.message : String(error)
+            });
+            continue;
+          }
+          if (!profile) {
+            throw error;
+          }
+          const switchedProfile = await ctx.authService.recordProfileRequestFailure(profile.profileId, error, quota, "openai-codex", {
+            skipAutoSwitch: keepProfileSticky
+          });
           failureRecorded = true;
-          if (attempt < maxProfileAttempts - 1 && isQuotaLimitError(error) && switchedProfile && switchedProfile.profileId !== profile.profileId && !abortController.signal.aborted) {
+          if (!keepProfileSticky && attempt < maxProfileAttempts - 1 && ctx.authService.isRotationTrigger(error, quota) && switchedProfile && switchedProfile.profileId !== profile.profileId && !abortController.signal.aborted) {
             retryCount += 1;
             failureRecorded = false;
             continue;
@@ -1462,13 +2023,18 @@ function createApp(params) {
       if (!upstream || !profile) {
         throw new Error("Codex stream \u672A\u80FD\u5EFA\u7ACB\u3002");
       }
-      await ctx.authService.recordProfileRequestSuccess(profile.profileId, upstream.quota, "openai-codex");
+      await ctx.authService.recordProfileRequestSuccess(profile.profileId, upstream.quota, "openai-codex", {
+        skipAutoSwitch: keepProfileSticky
+      });
       const headers = {
         "Content-Type": upstream.headers["content-type"] ?? "text/event-stream; charset=utf-8",
         "Cache-Control": "no-cache, no-transform",
         Connection: "keep-alive",
         "X-Accel-Buffering": "no"
       };
+      if (adventureFallbackUsed) {
+        headers["X-AZT-Codex-Continuation-Mode"] = "adventure-fallback";
+      }
       for (const [key, value] of Object.entries(upstream.headers)) {
         if (key.startsWith("x-codex-") || key === "x-request-id") {
           headers[key] = value;
@@ -1486,6 +2052,9 @@ function createApp(params) {
       }
       streamFinished = true;
       reply.raw.end();
+      for (const responseId of streamStats.responseIds) {
+        rememberCodexResponseProfile(responseId, profile);
+      }
       if (!streamStats.completed) {
         console.warn("[gateway:codex:stream] upstream stream ended without response.completed", {
           requestId: request.id,
@@ -1509,22 +2078,37 @@ function createApp(params) {
           upstreamRequestId: upstream.requestId,
           remoteAddress: request.ip,
           userAgent: request.headers["user-agent"],
-          request: summarizeResponsesRequest(data),
+          request: summarizeResponsesRequest(data, request.url),
           response: {
             stream: true,
             passthrough: true,
+            upstreamEndpoint,
             retryCount,
+            profileSticky: keepProfileSticky,
+            previousResponseId: originalPreviousResponseId ? "[present]" : void 0,
+            previousResponseDropped: adventureFallbackUsed,
+            adventureFallbackReason: adventureFallbackUsed ? truncateForLog(adventureFallbackReason ?? "") : void 0,
+            stickyProfileResolved: Boolean(stickyProfileId),
+            responseIdsTracked: streamStats.responseIds.size,
             completed: streamStats.completed,
             terminalEvent: streamStats.terminalEvent,
-            bytes: streamStats.bytes
+            bytes: streamStats.bytes,
+            usageCaptured: Boolean(streamStats.tokenUsage)
           }
+        },
+        usage: {
+          profile,
+          tokenUsage: streamStats.tokenUsage,
+          imageRoute: codexImageRoute
         }
       });
       return reply;
     } catch (error) {
       const quota = error.quota;
       if (profile && !failureRecorded) {
-        await ctx.authService.recordProfileRequestFailure(profile.profileId, error, quota, "openai-codex");
+        await ctx.authService.recordProfileRequestFailure(profile.profileId, error, quota, "openai-codex", {
+          skipAutoSwitch: Boolean(originalPreviousResponseId) && !adventureFallbackUsed
+        });
       }
       const normalized = normalizeError(error);
       const statusCode = getErrorStatusCode(normalized);
@@ -1540,16 +2124,28 @@ function createApp(params) {
           requestId: request.id,
           remoteAddress: request.ip,
           userAgent: request.headers["user-agent"],
-          request: summarizeResponsesRequest(data),
+          request: summarizeResponsesRequest(data, request.url),
           response: {
-            retryCount
+            upstreamEndpoint,
+            retryCount,
+            profileSticky: Boolean(originalPreviousResponseId) && !adventureFallbackUsed,
+            previousResponseId: originalPreviousResponseId ? "[present]" : void 0,
+            previousResponseDropped: adventureFallbackUsed,
+            adventureFallbackReason: adventureFallbackUsed ? truncateForLog(adventureFallbackReason ?? "") : void 0,
+            stickyProfileResolved: Boolean(originalPreviousResponseId && codexResponseProfileBindings.has(originalPreviousResponseId))
           },
           error: {
             message: normalized.message,
+            code: normalized.code,
+            upstreamRequestId: normalized.requestId,
             upstreamStatus: normalized.upstreamStatus,
             upstreamErrorCode: normalized.upstreamErrorCode,
             upstreamErrorMessage: normalized.upstreamErrorMessage
           }
+        },
+        usage: {
+          profile,
+          imageRoute: codexImageRoute
         }
       });
       if (headersCommitted) {
@@ -1592,6 +2188,38 @@ function createApp(params) {
     }
     return handleCodexResponsesPassthrough(request, reply, parsed.data, startedAt);
   });
+  app.post("/codex/v1/responses/compact", { bodyLimit: codexCompactBodyLimit }, async (request, reply) => {
+    const startedAt = performance.now();
+    const parsed = responsesBodySchema.safeParse(request.body);
+    if (!parsed.success) {
+      pushGatewayRequestLog({
+        method: request.method,
+        endpoint: request.url,
+        account: "-",
+        model: "-",
+        statusCode: 400,
+        durationMs: performance.now() - startedAt,
+        source: "Codex",
+        details: {
+          requestId: request.id,
+          remoteAddress: request.ip,
+          userAgent: request.headers["user-agent"],
+          error: {
+            type: "validation_error",
+            message: parsed.error.issues[0]?.message ?? "\u8BF7\u6C42\u4F53\u683C\u5F0F\u9519\u8BEF"
+          }
+        }
+      });
+      reply.code(400);
+      return {
+        error: {
+          type: "validation_error",
+          message: parsed.error.issues[0]?.message ?? "\u8BF7\u6C42\u4F53\u683C\u5F0F\u9519\u8BEF"
+        }
+      };
+    }
+    return handleCodexResponsesPassthrough(request, reply, parsed.data, startedAt, "responses/compact");
+  });
   app.post("/v1/responses", async (request, reply) => {
     const startedAt = performance.now();
     const parsed = responsesBodySchema.safeParse(request.body);
@@ -1682,13 +2310,73 @@ function createApp(params) {
       };
     }
     const codexBody = createResponsesCodexBody(parsed.data);
-    const result = await ctx.chatService.chat({
-      model: parsed.data.model,
-      input: input || void 0,
-      system: parsed.data.instructions,
-      experimental: {
-        codexBody,
-        allowUnknownModel: parsed.data.experimental_codex?.allow_unknown_model
+    let result;
+    try {
+      result = await ctx.chatService.chat({
+        model: parsed.data.model,
+        input: input || void 0,
+        system: parsed.data.instructions,
+        experimental: {
+          codexBody,
+          allowUnknownModel: parsed.data.experimental_codex?.allow_unknown_model
+        }
+      });
+    } catch (error) {
+      const normalized = normalizeError(error);
+      const statusCode = getErrorStatusCode(normalized);
+      const activeProfile2 = await ctx.authService.getActiveProfile();
+      pushGatewayRequestLog({
+        method: request.method,
+        endpoint: request.url,
+        account: profileLogLabel(activeProfile2),
+        model: parsed.data.model ?? "default",
+        statusCode,
+        durationMs: performance.now() - startedAt,
+        source: requestSourceFromUserAgent(request.headers["user-agent"]),
+        details: {
+          requestId: request.id,
+          remoteAddress: request.ip,
+          userAgent: request.headers["user-agent"],
+          request: summarizeResponsesRequest(parsed.data),
+          codex: summarizeCodexChatBody(codexBody),
+          error: {
+            message: normalized.message,
+            upstreamStatus: normalized.upstreamStatus,
+            upstreamErrorCode: normalized.upstreamErrorCode,
+            upstreamErrorMessage: normalized.upstreamErrorMessage
+          }
+        },
+        usage: {
+          profile: activeProfile2
+        }
+      });
+      throw error;
+    }
+    const activeProfile = result.profile ?? await ctx.authService.getActiveProfile();
+    pushGatewayRequestLog({
+      method: request.method,
+      endpoint: request.url,
+      account: profileLogLabel(activeProfile),
+      model: result.model,
+      statusCode: 200,
+      durationMs: performance.now() - startedAt,
+      source: requestSourceFromUserAgent(request.headers["user-agent"]),
+      details: {
+        requestId: request.id,
+        remoteAddress: request.ip,
+        userAgent: request.headers["user-agent"],
+        request: summarizeResponsesRequest(parsed.data),
+        codex: summarizeCodexChatBody(codexBody),
+        response: {
+          textPreview: truncateForLog(result.text),
+          textLength: result.text.length,
+          artifactCount: result.artifacts.length,
+          retryCount: result.retryCount ?? 0
+        }
+      },
+      usage: {
+        profile: activeProfile,
+        tokenUsage: extractTokenUsage(result.raw)
       }
     });
     return buildResponseApiBody(result, parsed.data.experimental_codex?.include_raw);
@@ -1772,10 +2460,11 @@ function createApp(params) {
     } catch (error) {
       const normalized = normalizeError(error);
       const statusCode = getErrorStatusCode(normalized);
+      const activeProfile2 = await ctx.authService.getActiveProfile();
       pushGatewayRequestLog({
         method: request.method,
         endpoint: request.url,
-        account: profileLogLabel(await ctx.authService.getActiveProfile()),
+        account: profileLogLabel(activeProfile2),
         model: parsed.data.model ?? "default",
         statusCode,
         durationMs: performance.now() - startedAt,
@@ -1792,14 +2481,18 @@ function createApp(params) {
             upstreamErrorCode: normalized.upstreamErrorCode,
             upstreamErrorMessage: normalized.upstreamErrorMessage
           }
+        },
+        usage: {
+          profile: activeProfile2
         }
       });
       throw error;
     }
+    const activeProfile = result.profile ?? await ctx.authService.getActiveProfile();
     pushGatewayRequestLog({
       method: request.method,
       endpoint: request.url,
-      account: profileLogLabel(await ctx.authService.getActiveProfile()),
+      account: profileLogLabel(activeProfile),
       model: result.model,
       statusCode: 200,
       durationMs: performance.now() - startedAt,
@@ -1820,8 +2513,13 @@ function createApp(params) {
             argumentsPreview: truncateForLog(toolCall.function.arguments)
           })),
           artifactCount: result.artifacts.length,
-          stream: parsed.data.stream ?? false
+          stream: parsed.data.stream ?? false,
+          retryCount: result.retryCount ?? 0
         }
+      },
+      usage: {
+        profile: activeProfile,
+        tokenUsage: extractTokenUsage(result.raw)
       }
     });
     console.info("[gateway:chat:response]", {
@@ -1840,6 +2538,7 @@ function createApp(params) {
     return buildChatCompletionsBody(result);
   });
   app.post("/v1/images/generations", async (request, reply) => {
+    const startedAt = performance.now();
     const parsed = imageGenerationsBodySchema.safeParse(request.body);
     if (!parsed.success) {
       console.error("[gateway:image] validation failure", {
@@ -1847,6 +2546,24 @@ function createApp(params) {
         url: request.url,
         issue: parsed.error.issues[0]?.message ?? "\u8BF7\u6C42\u4F53\u683C\u5F0F\u9519\u8BEF"
       });
+      pushGatewayRequestLog({
+        method: request.method,
+        endpoint: request.url,
+        account: "-",
+        model: "-",
+        statusCode: 400,
+        durationMs: performance.now() - startedAt,
+        source: requestSourceFromUserAgent(request.headers["user-agent"]),
+        details: {
+          requestId: request.id,
+          remoteAddress: request.ip,
+          userAgent: request.headers["user-agent"],
+          error: {
+            type: "validation_error",
+            message: parsed.error.issues[0]?.message ?? "\u8BF7\u6C42\u4F53\u683C\u5F0F\u9519\u8BEF"
+          }
+        }
+      });
       reply.code(400);
       return {
         error: {
@@ -1863,6 +2580,25 @@ function createApp(params) {
         summary: summarizeImageRequestForLog(parsed.data),
         issue: validationError
       });
+      pushGatewayRequestLog({
+        method: request.method,
+        endpoint: request.url,
+        account: "-",
+        model: parsed.data.model ?? "gpt-image-2",
+        statusCode: 400,
+        durationMs: performance.now() - startedAt,
+        source: requestSourceFromUserAgent(request.headers["user-agent"]),
+        details: {
+          requestId: request.id,
+          remoteAddress: request.ip,
+          userAgent: request.headers["user-agent"],
+          request: summarizeImageRequestForLog(parsed.data),
+          error: {
+            type: "validation_error",
+            message: validationError
+          }
+        }
+      });
       reply.code(400);
       return {
         error: {
@@ -1878,6 +2614,25 @@ function createApp(params) {
         summary: summarizeImageRequestForLog(parsed.data),
         issue: "\u5F53\u524D\u7F51\u5173\u6682\u4E0D\u652F\u6301 images.generations \u4E00\u6B21\u8FD4\u56DE\u591A\u5F20\u56FE\uFF08n > 1\uFF09"
       });
+      pushGatewayRequestLog({
+        method: request.method,
+        endpoint: request.url,
+        account: "-",
+        model: parsed.data.model ?? "gpt-image-2",
+        statusCode: 501,
+        durationMs: performance.now() - startedAt,
+        source: requestSourceFromUserAgent(request.headers["user-agent"]),
+        details: {
+          requestId: request.id,
+          remoteAddress: request.ip,
+          userAgent: request.headers["user-agent"],
+          request: summarizeImageRequestForLog(parsed.data),
+          error: {
+            type: "not_supported",
+            message: "\u5F53\u524D\u7F51\u5173\u6682\u4E0D\u652F\u6301 images.generations \u4E00\u6B21\u8FD4\u56DE\u591A\u5F20\u56FE\uFF08n > 1\uFF09"
+          }
+        }
+      });
       reply.code(501);
       return {
         error: {
@@ -1892,17 +2647,52 @@ function createApp(params) {
       url: request.url,
       summary: requestSummary
     });
-    const response = await ctx.imageService.generate({
-      prompt: parsed.data.prompt,
-      model: parsed.data.model,
-      n: parsed.data.n,
-      size: parsed.data.size,
-      quality: parsed.data.quality,
-      background: parsed.data.background,
-      outputFormat: parsed.data.output_format,
-      outputCompression: parsed.data.output_compression,
-      moderation: parsed.data.moderation
-    });
+    const activeProfile = await ctx.authService.getActiveProfile();
+    const settings = await ctx.configService.getSettings();
+    const imageRoute = activeProfile && isFreePlan(activeProfile) && settings.image.freeAccountWebGenerationEnabled ? "chatgpt-web" : "codex-tool";
+    let response;
+    try {
+      response = await ctx.imageService.generate({
+        prompt: parsed.data.prompt,
+        model: parsed.data.model,
+        n: parsed.data.n,
+        size: parsed.data.size,
+        quality: parsed.data.quality,
+        background: parsed.data.background,
+        outputFormat: parsed.data.output_format,
+        outputCompression: parsed.data.output_compression,
+        moderation: parsed.data.moderation
+      });
+    } catch (error) {
+      const normalized = normalizeError(error);
+      const statusCode = getErrorStatusCode(normalized);
+      pushGatewayRequestLog({
+        method: request.method,
+        endpoint: request.url,
+        account: profileLogLabel(activeProfile),
+        model: parsed.data.model ?? "gpt-image-2",
+        statusCode,
+        durationMs: performance.now() - startedAt,
+        source: requestSourceFromUserAgent(request.headers["user-agent"]),
+        details: {
+          requestId: request.id,
+          remoteAddress: request.ip,
+          userAgent: request.headers["user-agent"],
+          request: requestSummary,
+          error: {
+            message: normalized.message,
+            upstreamStatus: normalized.upstreamStatus,
+            upstreamErrorCode: normalized.upstreamErrorCode,
+            upstreamErrorMessage: normalized.upstreamErrorMessage
+          }
+        },
+        usage: {
+          profile: activeProfile,
+          imageRoute
+        }
+      });
+      throw error;
+    }
     console.info("[gateway:image] response ready", {
       method: request.method,
       url: request.url,
@@ -1913,11 +2703,57 @@ function createApp(params) {
       quality: response.quality,
       size: response.size
     });
+    pushGatewayRequestLog({
+      method: request.method,
+      endpoint: request.url,
+      account: profileLogLabel(activeProfile),
+      model: parsed.data.model ?? "gpt-image-2",
+      statusCode: 200,
+      durationMs: performance.now() - startedAt,
+      source: requestSourceFromUserAgent(request.headers["user-agent"]),
+      details: {
+        requestId: request.id,
+        remoteAddress: request.ip,
+        userAgent: request.headers["user-agent"],
+        request: requestSummary,
+        response: {
+          imageCount: response.data.length,
+          outputFormat: response.output_format,
+          quality: response.quality,
+          size: response.size
+        }
+      },
+      usage: {
+        profile: activeProfile,
+        tokenUsage: imageUsageToTokenUsage(response.usage),
+        imageCount: response.data.length,
+        imageRoute
+      }
+    });
     return response;
   });
   app.post("/v1/images/edits", async (request, reply) => {
+    const startedAt = performance.now();
     const contentType = request.headers["content-type"] ?? "";
     if (!String(contentType).toLowerCase().includes("application/json")) {
+      pushGatewayRequestLog({
+        method: request.method,
+        endpoint: request.url,
+        account: "-",
+        model: "-",
+        statusCode: 415,
+        durationMs: performance.now() - startedAt,
+        source: requestSourceFromUserAgent(request.headers["user-agent"]),
+        details: {
+          requestId: request.id,
+          remoteAddress: request.ip,
+          userAgent: request.headers["user-agent"],
+          error: {
+            type: "unsupported_media_type",
+            message: "\u5F53\u524D\u7F51\u5173\u4EC5\u652F\u6301 JSON \u7248 images.edits\uFF1B\u8BF7\u4F7F\u7528 application/json\uFF0C\u5E76\u901A\u8FC7 images[].image_url \u4F20 URL \u6216 base64 data URL\u3002"
+          }
+        }
+      });
       reply.code(415);
       return {
         error: {
@@ -1933,6 +2769,24 @@ function createApp(params) {
         url: request.url,
         issue: parsed.error.issues[0]?.message ?? "\u8BF7\u6C42\u4F53\u683C\u5F0F\u9519\u8BEF"
       });
+      pushGatewayRequestLog({
+        method: request.method,
+        endpoint: request.url,
+        account: "-",
+        model: "-",
+        statusCode: 400,
+        durationMs: performance.now() - startedAt,
+        source: requestSourceFromUserAgent(request.headers["user-agent"]),
+        details: {
+          requestId: request.id,
+          remoteAddress: request.ip,
+          userAgent: request.headers["user-agent"],
+          error: {
+            type: "validation_error",
+            message: parsed.error.issues[0]?.message ?? "\u8BF7\u6C42\u4F53\u683C\u5F0F\u9519\u8BEF"
+          }
+        }
+      });
       reply.code(400);
       return {
         error: {
@@ -1949,6 +2803,25 @@ function createApp(params) {
         summary: summarizeImageEditRequestForLog(parsed.data),
         issue: validationError
       });
+      pushGatewayRequestLog({
+        method: request.method,
+        endpoint: request.url,
+        account: "-",
+        model: parsed.data.model ?? "gpt-image-2",
+        statusCode: 400,
+        durationMs: performance.now() - startedAt,
+        source: requestSourceFromUserAgent(request.headers["user-agent"]),
+        details: {
+          requestId: request.id,
+          remoteAddress: request.ip,
+          userAgent: request.headers["user-agent"],
+          request: summarizeImageEditRequestForLog(parsed.data),
+          error: {
+            type: "validation_error",
+            message: validationError
+          }
+        }
+      });
       reply.code(400);
       return {
         error: {
@@ -1964,6 +2837,25 @@ function createApp(params) {
         summary: summarizeImageEditRequestForLog(parsed.data),
         issue: "\u5F53\u524D\u7F51\u5173\u6682\u4E0D\u652F\u6301 images.edits \u4E00\u6B21\u8FD4\u56DE\u591A\u5F20\u56FE\uFF08n > 1\uFF09"
       });
+      pushGatewayRequestLog({
+        method: request.method,
+        endpoint: request.url,
+        account: "-",
+        model: parsed.data.model ?? "gpt-image-2",
+        statusCode: 501,
+        durationMs: performance.now() - startedAt,
+        source: requestSourceFromUserAgent(request.headers["user-agent"]),
+        details: {
+          requestId: request.id,
+          remoteAddress: request.ip,
+          userAgent: request.headers["user-agent"],
+          request: summarizeImageEditRequestForLog(parsed.data),
+          error: {
+            type: "not_supported",
+            message: "\u5F53\u524D\u7F51\u5173\u6682\u4E0D\u652F\u6301 images.edits \u4E00\u6B21\u8FD4\u56DE\u591A\u5F20\u56FE\uFF08n > 1\uFF09"
+          }
+        }
+      });
       reply.code(501);
       return {
         error: {
@@ -1981,18 +2873,53 @@ function createApp(params) {
       url: request.url,
       summary: requestSummary
     });
-    const response = await ctx.imageService.generate({
-      prompt: parsed.data.prompt,
-      inputImages: imageReferences,
-      model: parsed.data.model,
-      n: parsed.data.n,
-      size: parsed.data.size,
-      quality: parsed.data.quality,
-      background: parsed.data.background,
-      outputFormat: parsed.data.output_format,
-      outputCompression: parsed.data.output_compression,
-      moderation: parsed.data.moderation
-    });
+    const activeProfile = await ctx.authService.getActiveProfile();
+    const settings = await ctx.configService.getSettings();
+    const imageRoute = activeProfile && isFreePlan(activeProfile) && settings.image.freeAccountWebGenerationEnabled ? "chatgpt-web" : "codex-tool";
+    let response;
+    try {
+      response = await ctx.imageService.generate({
+        prompt: parsed.data.prompt,
+        inputImages: imageReferences,
+        model: parsed.data.model,
+        n: parsed.data.n,
+        size: parsed.data.size,
+        quality: parsed.data.quality,
+        background: parsed.data.background,
+        outputFormat: parsed.data.output_format,
+        outputCompression: parsed.data.output_compression,
+        moderation: parsed.data.moderation
+      });
+    } catch (error) {
+      const normalized = normalizeError(error);
+      const statusCode = getErrorStatusCode(normalized);
+      pushGatewayRequestLog({
+        method: request.method,
+        endpoint: request.url,
+        account: profileLogLabel(activeProfile),
+        model: parsed.data.model ?? "gpt-image-2",
+        statusCode,
+        durationMs: performance.now() - startedAt,
+        source: requestSourceFromUserAgent(request.headers["user-agent"]),
+        details: {
+          requestId: request.id,
+          remoteAddress: request.ip,
+          userAgent: request.headers["user-agent"],
+          request: requestSummary,
+          error: {
+            message: normalized.message,
+            upstreamStatus: normalized.upstreamStatus,
+            upstreamErrorCode: normalized.upstreamErrorCode,
+            upstreamErrorMessage: normalized.upstreamErrorMessage
+          }
+        },
+        usage: {
+          profile: activeProfile,
+          imageRoute
+        }
+      });
+      throw error;
+    }
     console.info("[gateway:image:edit] response ready", {
       method: request.method,
       url: request.url,
@@ -2003,6 +2930,33 @@ function createApp(params) {
       quality: response.quality,
       size: response.size
     });
+    pushGatewayRequestLog({
+      method: request.method,
+      endpoint: request.url,
+      account: profileLogLabel(activeProfile),
+      model: parsed.data.model ?? "gpt-image-2",
+      statusCode: 200,
+      durationMs: performance.now() - startedAt,
+      source: requestSourceFromUserAgent(request.headers["user-agent"]),
+      details: {
+        requestId: request.id,
+        remoteAddress: request.ip,
+        userAgent: request.headers["user-agent"],
+        request: requestSummary,
+        response: {
+          imageCount: response.data.length,
+          outputFormat: response.output_format,
+          quality: response.quality,
+          size: response.size
+        }
+      },
+      usage: {
+        profile: activeProfile,
+        tokenUsage: imageUsageToTokenUsage(response.usage),
+        imageCount: response.data.length,
+        imageRoute
+      }
+    });
     return response;
   });
   return app;