@qjp88995/provider-client 0.3.0 → 0.4.0

package/dist/provider-client.js

@@ -1,5 +1,6 @@
 import { createCenterFetch } from './center-fetch.js';
 import { errorFromResponse, ProviderClientError } from './errors.js';
+import { createImageGenerator, IMAGE_ADAPTERS, isImageKind, } from './image/index.js';
 import { createJustOne, } from './justone/index.js';
 import { createMedia, isMediaKind, MEDIA_ADAPTERS, } from './media/index.js';
 import { buildHandle, findModel, } from './model-handle.js';
@@ -119,6 +120,49 @@ export class ProviderClient {
             settings: options.settings,
         });
     }
+    /**
+     * 一个生图模型（适配器在本包，请求经中心透传、中心注入 key）。地址取自这家的对话端点（生图模型没有自己的协议，
+     * 用哪个端点由这家的生图适配器定）。**一次 `generate` 出一张**；要几张就并发几次。
+     * - 目录里没有这家 → `unknown_vendor`；这家没有这个生图模型（或停用了）→ `unknown_model`；
+     *   这个版本的 client 没有这家的生图适配器 → `unsupported_vendor_kind`；这家没有启用的对应端点 → `protocol_unavailable`。
+     * - 生成时中心自己报的错是 `ProviderClientError`，厂商的失败是 `ImageUpstreamError`（`retryable`、`contentFiltered`）。
+     * - 用量（张数、参考图数）在结果里，单价在目录里（`catalog()` 的 `imageModels[].pricing`），钱由 APP 自己算。
+     * 目录只在创建时查一次。
+     */
+    async imageModel(ref, options = {}) {
+        const vendor = (await this.catalog()).vendors.find(v => v.slug === ref.vendor);
+        if (!vendor) {
+            throw new ProviderClientError('unknown_vendor', `vendor "${ref.vendor}" is not in the catalog`, null);
+        }
+        const model = vendor.imageModels.find(m => m.modelId === ref.modelId);
+        if (!model) {
+            throw new ProviderClientError('unknown_model', `image model "${ref.modelId}" is not in the catalog of vendor "${ref.vendor}"`, null);
+        }
+        if (!isImageKind(vendor.kind)) {
+            throw new ProviderClientError('unsupported_vendor_kind', `vendor kind "${vendor.kind}" has no image generation adapter`, null);
+        }
+        const protocol = IMAGE_ADAPTERS[vendor.kind].endpointProtocol;
+        const endpoint = vendor.endpoints.find(e => e.protocol === protocol);
+        if (!endpoint) {
+            throw new ProviderClientError('protocol_unavailable', `vendor "${ref.vendor}" has no ${protocol} endpoint (image generation uses its base URL)`, null);
+        }
+        const fetch = createCenterFetch({
+            centerUrl: this.center,
+            apiKey: this.options.apiKey,
+            vendor: vendor.slug,
+            baseUrls: vendor.endpoints.map(e => e.baseUrl),
+            affinity: options.affinity,
+            pin: options.pin,
+            onCredential: options.onCredential,
+            fetch: this.send,
+        });
+        return createImageGenerator({
+            kind: vendor.kind,
+            modelId: model.modelId,
+            referenceImages: model.capabilities.includes('reference-image'),
+            connection: { baseUrl: endpoint.baseUrl, fetch },
+        });
+    }
     /**
      * 某家厂商的媒体解析（适配器在本包，请求经中心透传、中心注入 key）：智谱的文件解析 / 语音转写（地址取自这家的
      * `media` 端点）、BibiGPT 的视频链接解析（它唯一的 `http` 端点）。
@@ -224,6 +268,9 @@ export class ProviderClient {
         if (!res.ok)
             throw await errorFromResponse(res);
         const body = (await res.json());
+        // 中心 2026-11 之前没有 `imageModels`：补成空数组，后面不用到处判空。
+        for (const v of body.vendors)
+            v.imageModels ??= [];
         this.cached = {
             etag: res.headers.get('etag'),
             body,

package/dist/provider-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-client.js","sourceRoot":"","sources":["../src/provider-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"provider-client.js","sourceRoot":"","sources":["../src/provider-client.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -17,6 +17,9 @@ export type VendorCategory = (typeof VENDOR_CATEGORIES)[number];
 /** 模型能力（目录元数据：发不发图片 / 开不开推理由调用方据此决定）。 */
 export declare const LLM_CAPABILITIES: readonly ["vision", "video", "reasoning"];
 export type LlmCapability = (typeof LLM_CAPABILITIES)[number];
+/** 生图模型的能力。`reference-image` = 能带参考图（图生图 / 改图）。 */
+export declare const IMAGE_CAPABILITIES: readonly ["reference-image"];
+export type ImageCapability = (typeof IMAGE_CAPABILITIES)[number];
 /** 厂商类型。`llm` 类别的每一种对应一个适配器（`VENDOR_ADAPTERS`）；bibigpt / justone 没有。 */
 export declare const VENDOR_KINDS: readonly ["openai", "generic", "deepseek", "moonshotai", "alibaba", "zhipu", "volcengine", "minimax", "dots", "google", "bibigpt", "justone"];
 export type VendorKind = (typeof VENDOR_KINDS)[number];
@@ -51,7 +54,10 @@ export interface CatalogVendor {
     /** 非 `llm` 的厂商没有模型，接入方只拿它的端点经中心透传。 */
     category: VendorCategory;
     endpoints: CatalogEndpoint[];
+    /** 对话模型。 */
     models: CatalogModel[];
+    /** 生图模型（中心 2026-11 起有；读目录时缺了按空数组补上）。 */
+    imageModels: CatalogImageModel[];
 }
 export interface CatalogEndpoint {
     protocol: EndpointProtocol;
@@ -68,6 +74,18 @@ export interface CatalogModel {
     maxOutputTokens: number | null;
     pricing: ModelPricing | null;
 }
+/** 生图的单价（每张，十进制字符串）。 */
+export interface ImagePricing {
+    currency: string;
+    perImage: string;
+}
+export interface CatalogImageModel {
+    /** 厂商侧的模型名（请求体里的 `model`）。 */
+    modelId: string;
+    displayName: string;
+    capabilities: ImageCapability[];
+    pricing: ImagePricing | null;
+}
 /** 中心的错误码（响应体 `{ code, message }`）。 */
 export declare const CENTER_ERROR_CODES: readonly ["unauthorized", "forbidden", "tenant_disabled", "not_found", "invalid_request", "conflict", "unprocessable", "upstream_error", "admin_unavailable", "vendor_not_allowed", "no_credential", "pinned_credential_unavailable", "payload_too_large"];
 export type CenterErrorCode = (typeof CENTER_ERROR_CODES)[number];

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6BAA6B;AAC7B,eAAO,MAAM,aAAa,kIAMhB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,iKAKrB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,mCAAoC,CAAC;AACnE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,2CAA4C,CAAC;AAC1E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,wEAAwE;AACxE,eAAO,MAAM,YAAY,+IAaf,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,6DAOpB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,sCAAsC;IACtC,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,sCAAsC;IACtC,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B;AAED,uCAAuC;AACvC,eAAO,MAAM,kBAAkB,4PAcrB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,oBAAoB;AACpB,eAAO,MAAM,UAAU;IACrB,2BAA2B;;IAE3B,mCAAmC;;IAEnC,sDAAsD;;IAEtD,+BAA+B;;IAE/B,sBAAsB;;CAEd,CAAC;AAEX,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,cAAc,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -24,6 +24,8 @@ export const ENDPOINT_PROTOCOLS = [
 export const VENDOR_CATEGORIES = ['llm', 'media', 'data'];
 /** 模型能力（目录元数据：发不发图片 / 开不开推理由调用方据此决定）。 */
 export const LLM_CAPABILITIES = ['vision', 'video', 'reasoning'];
+/** 生图模型的能力。`reference-image` = 能带参考图（图生图 / 改图）。 */
+export const IMAGE_CAPABILITIES = ['reference-image'];
 /** 厂商类型。`llm` 类别的每一种对应一个适配器（`VENDOR_ADAPTERS`）；bibigpt / justone 没有。 */
 export const VENDOR_KINDS = [
     'openai',

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,yBAAyB;IACzB,kBAAkB;IAClB,oBAAoB;IACpB,yBAAyB;IACzB,qBAAqB;CACb,CAAC;AAGX;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,aAAa;IAChB,MAAM;IACN,YAAY;IACZ,OAAO;CACC,CAAC;AAGX,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAGnE,yCAAyC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AAG1E,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ;IACR,SAAS;IACT,UAAU;IACV,YAAY;IACZ,SAAS;IACT,OAAO;IACP,YAAY;IACZ,SAAS;IACT,MAAM;IACN,QAAQ;IACR,SAAS;IACT,SAAS;CACD,CAAC;AAGX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK;IACL,SAAS;IACT,KAAK;IACL,QAAQ;IACR,MAAM;IACN,KAAK;CACG,CAAC;AA6CX,uCAAuC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,cAAc;IACd,WAAW;IACX,iBAAiB;IACjB,WAAW;IACX,iBAAiB;IACjB,UAAU;IACV,eAAe;IACf,gBAAgB;IAChB,mBAAmB;IACnB,oBAAoB;IACpB,eAAe;IACf,+BAA+B;IAC/B,mBAAmB;CACX,CAAC;AAGX,oBAAoB;AACpB,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,2BAA2B;IAC3B,GAAG,EAAE,UAAU;IACf,mCAAmC;IACnC,QAAQ,EAAE,eAAe;IACzB,sDAAsD;IACtD,GAAG,EAAE,UAAU;IACf,+BAA+B;IAC/B,UAAU,EAAE,iBAAiB;IAC7B,sBAAsB;IACtB,QAAQ,EAAE,eAAe;CACjB,CAAC;AAEX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,yBAAyB;IACzB,kBAAkB;IAClB,oBAAoB;IACpB,yBAAyB;IACzB,qBAAqB;CACb,CAAC;AAGX;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,aAAa;IAChB,MAAM;IACN,YAAY;IACZ,OAAO;CACC,CAAC;AAGX,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAGnE,yCAAyC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AAG1E,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,iBAAiB,CAAU,CAAC;AAG/D,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ;IACR,SAAS;IACT,UAAU;IACV,YAAY;IACZ,SAAS;IACT,OAAO;IACP,YAAY;IACZ,SAAS;IACT,MAAM;IACN,QAAQ;IACR,SAAS;IACT,SAAS;CACD,CAAC;AAGX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK;IACL,SAAS;IACT,KAAK;IACL,QAAQ;IACR,MAAM;IACN,KAAK;CACG,CAAC;AA8DX,uCAAuC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,cAAc;IACd,WAAW;IACX,iBAAiB;IACjB,WAAW;IACX,iBAAiB;IACjB,UAAU;IACV,eAAe;IACf,gBAAgB;IAChB,mBAAmB;IACnB,oBAAoB;IACpB,eAAe;IACf,+BAA+B;IAC/B,mBAAmB;CACX,CAAC;AAGX,oBAAoB;AACpB,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,2BAA2B;IAC3B,GAAG,EAAE,UAAU;IACf,mCAAmC;IACnC,QAAQ,EAAE,eAAe;IACzB,sDAAsD;IACtD,GAAG,EAAE,UAAU;IACf,+BAA+B;IAC/B,UAAU,EAAE,iBAAiB;IAC7B,sBAAsB;IACtB,QAAQ,EAAE,eAAe;CACjB,CAAC;AAEX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qjp88995/provider-client",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Client for the provider center: vendor adapters for the AI SDK, model resolution through the center's catalog and passthrough proxy, and a direct mode for local development.",
   "license": "UNLICENSED",
   "type": "module",

package/src/direct-resolver.ts

@@ -61,6 +61,8 @@ export class DirectModelResolver implements ModelResolver {
         pricing: null,
         ...m,
       })),
+      // 直连不做生图（生图只走中心）。
+      imageModels: [],
     }));
   }
 

package/src/image/http.ts

@@ -0,0 +1,68 @@
+import { parseCenterError, ProviderClientError } from '../errors.js';
+import { PC_HEADERS } from '../types.js';
+import { type ImageConnection, ImageUpstreamError } from './types.js';
+
+/**
+ * POST 一段 JSON，返回状态码与响应正文（同 web-search 的 `postJson`）。只处理「请求没发出去」与「中心自己报的错」：
+ * 中止原样抛；网络错误、中心的 `upstream_error` 是可重试的上游错误；中心别的错（没有可用 key、不许用这家……）是配置问题，
+ * 抛 `ProviderClientError`。厂商的状态码与响应体怎么解释是适配器的事。
+ */
+export async function postJson(
+  label: string,
+  url: string,
+  { apiKey, fetch }: ImageConnection,
+  body: Record<string, unknown>,
+  signal: AbortSignal
+): Promise<{ status: number; ok: boolean; text: string }> {
+  let res: Response;
+  try {
+    res = await fetch(url, {
+      method: 'POST',
+      headers: {
+        ...(apiKey ? { authorization: `Bearer ${apiKey}` } : {}),
+        'content-type': 'application/json',
+      },
+      body: JSON.stringify(body),
+      signal,
+    });
+  } catch (err) {
+    if (signal.aborted) throw err;
+    const reason = err instanceof Error ? err.message : String(err);
+    throw new ImageUpstreamError(`${label} 请求失败：${reason}`, {
+      retryable: true,
+    });
+  }
+  const text = await res.text();
+  if (!res.ok && !res.headers.has(PC_HEADERS.credential)) {
+    const center = centerErrorOf(text);
+    if (center?.code === 'upstream_error') {
+      throw new ImageUpstreamError(`${label} 请求失败：${center.message}`, {
+        code: center.code,
+        retryable: true,
+      });
+    }
+    if (center) {
+      throw new ProviderClientError(center.code, center.message, res.status);
+    }
+  }
+  return { status: res.status, ok: res.ok, text };
+}
+
+function centerErrorOf(text: string) {
+  try {
+    return parseCenterError(JSON.parse(text));
+  } catch {
+    return null;
+  }
+}
+
+/** 错误详情别整段回灌（HTML 错误页可能几十 KB）。 */
+export function clip(text: string): string {
+  const flat = text.replace(/\s+/g, ' ').trim();
+  return flat.length > 300 ? `${flat.slice(0, 300)}…` : flat;
+}
+
+/** 端点根 + 子路径（根上多余的 `/` 去掉）。 */
+export function joinUrl(baseUrl: string, path: string): string {
+  return `${baseUrl.replace(/\/+$/, '')}/${path}`;
+}

package/src/image/index.ts

@@ -0,0 +1,87 @@
+import {
+  fitImageSize,
+  type GenerateImageInput,
+  type GenerateImageOutcome,
+  type ImageAdapter,
+  type ImageConnection,
+  type ImageTraits,
+} from './types.js';
+import { VolcengineImageAdapter } from './volcengine.adapter.js';
+
+/** kind → 生图适配器。中心哪几家能录生图模型（`VendorKindInfo.imageGeneration`）与这里一一对应（契约测试钉着）。 */
+export const IMAGE_ADAPTERS = {
+  volcengine: new VolcengineImageAdapter(),
+} as const satisfies Record<string, ImageAdapter>;
+
+export type ImageKind = keyof typeof IMAGE_ADAPTERS;
+export const IMAGE_KINDS = Object.keys(IMAGE_ADAPTERS) as ImageKind[];
+
+export function isImageKind(kind: string): kind is ImageKind {
+  return Object.hasOwn(IMAGE_ADAPTERS, kind);
+}
+
+/** 一个生图模型，连接已绑好。 */
+export interface ImageGenerator {
+  readonly kind: ImageKind;
+  readonly modelId: string;
+  readonly traits: ImageTraits;
+  /** 能不能带参考图（目录里的 `reference-image` 能力）。 */
+  readonly referenceImages: boolean;
+  generate(
+    input: GenerateImageInput,
+    signal: AbortSignal
+  ): Promise<GenerateImageOutcome>;
+}
+
+export interface CreateImageGeneratorInput {
+  kind: ImageKind;
+  modelId: string;
+  /** 目录里这个模型有 `reference-image` 能力。 */
+  referenceImages: boolean;
+  connection: ImageConnection;
+}
+
+/**
+ * 绑好连接的生图模型。中心模式用 `ProviderClient.imageModel`；这里是直连（测试）与中心模式共用的底层。
+ * 生成前先校验（空提示词、参考图不支持 / 超张数）并把尺寸放进这家的限制（`fitImageSize`）。
+ */
+export function createImageGenerator(
+  input: CreateImageGeneratorInput
+): ImageGenerator {
+  const adapter: ImageAdapter = IMAGE_ADAPTERS[input.kind];
+  const traits = adapter.traits(input.modelId);
+  return {
+    kind: input.kind,
+    modelId: input.modelId,
+    traits,
+    referenceImages: input.referenceImages,
+    generate: (req, signal) => {
+      if (!req.prompt.trim()) {
+        return Promise.reject(new RangeError('prompt must not be empty'));
+      }
+      const refs = req.referenceImages ?? [];
+      if (refs.length > 0 && !input.referenceImages) {
+        return Promise.reject(
+          new RangeError(
+            `model "${input.modelId}" does not take reference images`
+          )
+        );
+      }
+      if (refs.length > traits.maxReferenceImages) {
+        return Promise.reject(
+          new RangeError(
+            `at most ${traits.maxReferenceImages} reference images, got ${refs.length}`
+          )
+        );
+      }
+      return adapter.generate(
+        input.connection,
+        input.modelId,
+        { ...req, size: fitImageSize(req.size, traits) },
+        signal
+      );
+    },
+  };
+}
+
+export * from './types.js';

package/src/image/types.ts

@@ -0,0 +1,134 @@
+import type { VendorFetch } from '../vendors/index.js';
+
+/**
+ * 生图的厂商适配。适配器只管「这家的请求长什么样、响应怎么翻、哪些失败值得重试」与这家的尺寸限制；
+ * 什么时候生、生几张、提示词怎么写是 APP 的事。**一次调用出一张图**（火山 5.5 不支持一次多张）：要几张就并发几次。
+ */
+
+export interface ImageSize {
+  width: number;
+  height: number;
+}
+
+/** 参考图（图生图 / 改图）。字节随请求发出（data URI），不依赖公网地址。 */
+export interface ReferenceImage {
+  data: Uint8Array;
+  /** `image/jpeg`、`image/png`、`image/webp` …… */
+  mimeType: string;
+}
+
+export const IMAGE_FORMATS = ['jpeg', 'png'] as const;
+export type ImageFormat = (typeof IMAGE_FORMATS)[number];
+
+export interface GenerateImageInput {
+  prompt: string;
+  /**
+   * 想要的像素尺寸。这家的面积上下限之外会**等比**缩放进去（比例不变），实际尺寸看结果；
+   * 想先知道就用 `fitImageSize(size, traits)`。
+   */
+  size: ImageSize;
+  /** 参考图；模型没有 `reference-image` 能力或超过 `traits.maxReferenceImages` 张就报错，不悄悄丢。 */
+  referenceImages?: readonly ReferenceImage[];
+  /** 缺省 `jpeg`（幻灯片配图用 jpeg 小一个量级）。 */
+  format?: ImageFormat;
+}
+
+export interface GeneratedImage {
+  data: Uint8Array;
+  mimeType: string;
+  width: number;
+  height: number;
+}
+
+export interface ImageUsage {
+  generatedImages: number;
+  inputImages: number;
+  /** 厂商报的 token 数（火山按面积折算）；不报为 null。计价按张，这个只做记录。 */
+  tokens: number | null;
+}
+
+export interface GenerateImageOutcome {
+  image: GeneratedImage;
+  usage: ImageUsage;
+}
+
+/** 这家（这个模型）生图的限制，给调用方定尺寸、写工具说明用。 */
+export interface ImageTraits {
+  /** 面积下限（像素）。 */
+  minPixels: number;
+  /** 面积上限（像素）。 */
+  maxPixels: number;
+  /** 宽高比（长边 / 短边）上限。 */
+  maxAspectRatio: number;
+  /** 一次最多带几张参考图。 */
+  maxReferenceImages: number;
+}
+
+/**
+ * 调一次上游要的东西：这家生图所用端点的根地址与出站 fetch。中心模式下 fetch 是中心的透传 fetch、不带 key；
+ * 直连模式给 `apiKey`。
+ */
+export interface ImageConnection {
+  baseUrl: string;
+  fetch: VendorFetch;
+  apiKey?: string;
+}
+
+export interface ImageAdapter<K extends string = string> {
+  readonly kind: K;
+  /** 生图请求发往这家哪个端点（取它的根地址）。 */
+  readonly endpointProtocol: 'openai-chat-completions';
+  traits(modelId: string): ImageTraits;
+  generate(
+    conn: ImageConnection,
+    modelId: string,
+    input: GenerateImageInput,
+    signal: AbortSignal
+  ): Promise<GenerateImageOutcome>;
+}
+
+/**
+ * 厂商的失败（HTTP 错误、拒绝生成、响应不成形、没拿到响应）。中心自己报的错是 `ProviderClientError`。
+ * 调用方只读 `retryable` 决定要不要再试，不解析消息文本。
+ */
+export class ImageUpstreamError extends Error {
+  override readonly name = 'ImageUpstreamError';
+  /** 上游错误码（火山的 `InvalidParameter`、`OutputImageSensitiveContentDetected` ……），没有就是 null。 */
+  readonly code: string | null;
+  readonly retryable: boolean;
+  /** 被内容审核拦下（换提示词再试；原样重试没用）。 */
+  readonly contentFiltered: boolean;
+
+  constructor(
+    reason: string,
+    opts: { code?: string; retryable?: boolean; contentFiltered?: boolean } = {}
+  ) {
+    super(reason);
+    this.code = opts.code ?? null;
+    this.retryable = opts.retryable ?? false;
+    this.contentFiltered = opts.contentFiltered ?? false;
+  }
+}
+
+/**
+ * 把想要的尺寸放进这家的限制：宽高比超了先按上限收窄短边；面积超了等比缩小、不够等比放大。取整后面积仍要在界内。
+ */
+export function fitImageSize(size: ImageSize, traits: ImageTraits): ImageSize {
+  let { width: w, height: h } = size;
+  if (!(w > 0 && h > 0)) throw new RangeError('image size must be positive');
+  const ratio = Math.max(w, h) / Math.min(w, h);
+  if (ratio > traits.maxAspectRatio) {
+    if (w > h) h = w / traits.maxAspectRatio;
+    else w = h / traits.maxAspectRatio;
+  }
+  const area = w * h;
+  const scale =
+    area > traits.maxPixels
+      ? Math.sqrt(traits.maxPixels / area)
+      : area < traits.minPixels
+        ? Math.sqrt(traits.minPixels / area)
+        : 1;
+  // 缩小向下取整、放大向上取整，取整后面积不越界。
+  const round = scale < 1 ? Math.floor : scale > 1 ? Math.ceil : Math.round;
+  return { width: round(w * scale), height: round(h * scale) };
+}

package/src/image/volcengine.adapter.ts

@@ -0,0 +1,133 @@
+import { clip, joinUrl, postJson } from './http.js';
+import {
+  type GenerateImageInput,
+  type GenerateImageOutcome,
+  type ImageAdapter,
+  type ImageConnection,
+  type ImageTraits,
+  ImageUpstreamError,
+} from './types.js';
+
+/**
+ * 火山方舟（Seedream）生图：`POST {对话端点根}/images/generations`（`https://ark.cn-beijing.volces.com/api/v3`），
+ * OpenAI 形状。2026-11-13 经中心透传实测（Seedream 5.5 / 5.0 flash）：
+ * - `size` 收 `WxH`，面积 921600～4624220 像素，比例宽松（16:1 也行），像素不用对齐；
+ * - 一次一张（`n` 被忽略，组图 5.5 不支持）；参考图 `image` 收 data URI，最多 10 张；
+ * - 返回链接 24 小时失效 → 要 `b64_json`；`watermark: false` 去掉右下角「AI 生成」；
+ * - 失败是 `{ error: { code, message } }`（`InvalidParameter` / `MissingParameter` …）。
+ */
+const TRAITS: ImageTraits = {
+  minPixels: 921_600,
+  maxPixels: 4_624_220,
+  maxAspectRatio: 16,
+  maxReferenceImages: 10,
+};
+
+interface ArkImagesBody {
+  data?: {
+    b64_json?: string;
+    size?: string;
+    output_format?: string;
+    error?: { code?: string; message?: string };
+  }[];
+  usage?: {
+    generated_images?: number;
+    input_images?: number;
+    total_tokens?: number;
+  };
+  error?: { code?: string; message?: string };
+}
+
+const LABEL = '火山方舟生图';
+
+export class VolcengineImageAdapter implements ImageAdapter<'volcengine'> {
+  readonly kind = 'volcengine' as const;
+  readonly endpointProtocol = 'openai-chat-completions' as const;
+
+  traits(): ImageTraits {
+    return TRAITS;
+  }
+
+  async generate(
+    conn: ImageConnection,
+    modelId: string,
+    input: GenerateImageInput,
+    signal: AbortSignal
+  ): Promise<GenerateImageOutcome> {
+    const format = input.format ?? 'jpeg';
+    const refs = input.referenceImages ?? [];
+    const body: Record<string, unknown> = {
+      model: modelId,
+      prompt: input.prompt,
+      size: `${input.size.width}x${input.size.height}`,
+      response_format: 'b64_json',
+      output_format: format,
+      watermark: false,
+    };
+    if (refs.length > 0) {
+      const uris = refs.map(
+        r =>
+          `data:${r.mimeType};base64,${Buffer.from(r.data).toString('base64')}`
+      );
+      body.image = uris.length === 1 ? uris[0] : uris;
+    }
+    const res = await postJson(
+      LABEL,
+      joinUrl(conn.baseUrl, 'images/generations'),
+      conn,
+      body,
+      signal
+    );
+    let parsed: ArkImagesBody;
+    try {
+      parsed = JSON.parse(res.text) as ArkImagesBody;
+    } catch {
+      throw new ImageUpstreamError(
+        `${LABEL}失败（HTTP ${res.status}）：${clip(res.text)}`,
+        { retryable: res.status === 429 || res.status >= 500 }
+      );
+    }
+    if (!res.ok || parsed.error) {
+      throw upstreamError(res.status, parsed.error);
+    }
+    const item = parsed.data?.[0];
+    if (item?.error) throw upstreamError(res.status, item.error);
+    if (!item?.b64_json) {
+      throw new ImageUpstreamError(`${LABEL}没有返回图片：${clip(res.text)}`, {
+        retryable: true,
+      });
+    }
+    const [w, h] = (item.size ?? '').split('x').map(Number);
+    const outFormat = item.output_format === 'png' ? 'png' : format;
+    return {
+      image: {
+        data: new Uint8Array(Buffer.from(item.b64_json, 'base64')),
+        mimeType: outFormat === 'png' ? 'image/png' : 'image/jpeg',
+        width: w && Number.isFinite(w) ? w : input.size.width,
+        height: h && Number.isFinite(h) ? h : input.size.height,
+      },
+      usage: {
+        generatedImages: parsed.usage?.generated_images ?? 1,
+        inputImages: parsed.usage?.input_images ?? refs.length,
+        tokens: parsed.usage?.total_tokens ?? null,
+      },
+    };
+  }
+}
+
+function upstreamError(
+  status: number,
+  error: { code?: string; message?: string } | undefined
+): ImageUpstreamError {
+  const code = error?.code;
+  const message = error?.message ?? '未知错误';
+  return new ImageUpstreamError(
+    `${LABEL}失败（HTTP ${status}${code ? `，${code}` : ''}）：${clip(message)}`,
+    {
+      ...(code ? { code } : {}),
+      // 限流、服务端故障可重试；参数错、审核拦下重试没用。
+      retryable: status === 429 || status >= 500,
+      contentFiltered: !!code && /Sensitive|Moderation|RiskControl/i.test(code),
+    }
+  );
+}