@aigne/doubao 1.0.38 → 1.0.40

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [1.0.40](https://github.com/AIGNE-io/aigne-framework/compare/doubao-v1.0.39...doubao-v1.0.40) (2025-09-18)
+
+
+### Bug Fixes
+
+* support the correct 3.0 model ([#514](https://github.com/AIGNE-io/aigne-framework/issues/514)) ([98e0d44](https://github.com/AIGNE-io/aigne-framework/commit/98e0d44ce2c4c7b043d5fc934c6e312ffa821521))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/openai bumped to 0.15.4
+  * devDependencies
+    * @aigne/core bumped to 1.60.3
+    * @aigne/test-utils bumped to 0.5.52
+
+## [1.0.39](https://github.com/AIGNE-io/aigne-framework/compare/doubao-v1.0.38...doubao-v1.0.39) (2025-09-16)
+
+
+### Bug Fixes
+
+* release new version ([#509](https://github.com/AIGNE-io/aigne-framework/issues/509)) ([822ccd2](https://github.com/AIGNE-io/aigne-framework/commit/822ccd2c374cdcef187066e102dc79230e2eebff))
+
 ## [1.0.38](https://github.com/AIGNE-io/aigne-framework/compare/doubao-v1.0.37...doubao-v1.0.38) (2025-09-11)
 
 

package/lib/cjs/doubao-image-model.d.ts

@@ -0,0 +1,34 @@
+import { ImageModel, type ImageModelInput, type ImageModelOptions, type ImageModelOutput } from "@aigne/core";
+export interface DoubaoImageModelInput extends ImageModelInput {
+    size?: string;
+    seed?: number;
+    sequentialImageGeneration?: boolean;
+    sequentialImageGenerationOptions?: {
+        maxImages: number;
+    };
+    stream?: boolean;
+    guidanceScale?: number;
+    watermark?: boolean;
+}
+export interface DoubaoImageModelOutput extends ImageModelOutput {
+}
+export interface DoubaoImageModelOptions extends ImageModelOptions<DoubaoImageModelInput, DoubaoImageModelOutput> {
+    apiKey?: string;
+    baseURL?: string;
+    model?: string;
+    modelOptions?: Omit<Partial<DoubaoImageModelInput>, "model">;
+    clientOptions?: Record<string, any>;
+}
+export declare class DoubaoImageModel extends ImageModel<DoubaoImageModelInput, DoubaoImageModelOutput> {
+    options?: DoubaoImageModelOptions | undefined;
+    constructor(options?: DoubaoImageModelOptions | undefined);
+    protected apiKeyEnvName: string;
+    get credential(): {
+        url: string;
+        apiKey: string | undefined;
+        model: string;
+    };
+    get modelOptions(): Omit<Partial<DoubaoImageModelInput>, "model"> | undefined;
+    private extractDataObjects;
+    process(input: DoubaoImageModelInput): Promise<ImageModelOutput>;
+}

package/lib/cjs/doubao-image-model.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DoubaoImageModel = void 0;
+const core_1 = require("@aigne/core");
+const camelize_js_1 = require("@aigne/core/utils/camelize.js");
+const type_utils_js_1 = require("@aigne/core/utils/type-utils.js");
+const ufo_1 = require("ufo");
+const zod_1 = require("zod");
+const DOUBAO_DEFAULT_IMAGE_MODEL = "doubao-seedream-4-0-250828";
+const DOUBAO_BASE_URL = "https://ark.cn-beijing.volces.com/api/v3";
+const doubaoImageModelInputSchema = core_1.imageModelInputSchema.extend({});
+const doubaoImageModelOptionsSchema = zod_1.z.object({
+    apiKey: zod_1.z.string().optional(),
+    baseURL: zod_1.z.string().optional(),
+    model: zod_1.z.string().optional(),
+    modelOptions: zod_1.z.object({}).optional(),
+    clientOptions: zod_1.z.object({}).optional(),
+});
+class DoubaoImageModel extends core_1.ImageModel {
+    options;
+    constructor(options) {
+        super({
+            ...options,
+            inputSchema: doubaoImageModelInputSchema,
+            description: options?.description ?? "Draw or edit image by Doubao image models",
+        });
+        this.options = options;
+        if (options)
+            (0, type_utils_js_1.checkArguments)(this.name, doubaoImageModelOptionsSchema, options);
+    }
+    apiKeyEnvName = "DOUBAO_API_KEY";
+    get credential() {
+        return {
+            url: this.options?.baseURL || process.env.DOUBAO_BASE_URL || DOUBAO_BASE_URL,
+            apiKey: this.options?.apiKey || process.env[this.apiKeyEnvName],
+            model: this.options?.model || DOUBAO_DEFAULT_IMAGE_MODEL,
+        };
+    }
+    get modelOptions() {
+        return this.options?.modelOptions;
+    }
+    extractDataObjects(text) {
+        const dataObjects = [];
+        const lines = text.split("\n");
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith("data:")) {
+                const jsonPart = trimmed.slice(5).trim();
+                if (jsonPart === "[DONE]")
+                    continue;
+                try {
+                    const obj = JSON.parse(jsonPart);
+                    dataObjects.push(obj);
+                }
+                catch (e) {
+                    console.warn("Failed to parse JSON data object:", jsonPart, e);
+                }
+            }
+        }
+        return dataObjects;
+    }
+    async process(input) {
+        const model = input.model || this.credential.model;
+        const { url, apiKey } = this.credential;
+        if (!apiKey) {
+            throw new Error(`${this.name} requires an API key. Please provide it via \`options.apiKey\`, or set the \`${this.apiKeyEnvName}\` environment variable`);
+        }
+        const map = {
+            "doubao-seedream-4": [
+                "model",
+                "prompt",
+                "image",
+                "size",
+                "sequentialImageGeneration",
+                "sequentialImageGenerationOptions",
+                "stream",
+                "responseFormat",
+                "watermark",
+            ],
+            "doubao-seedream-3-0-t2i": [
+                "model",
+                "prompt",
+                "size",
+                "seed",
+                "guidanceScale",
+                "responseFormat",
+                "watermark",
+            ],
+            "doubao-seededit-3-0-i2i": [
+                "model",
+                "prompt",
+                "image",
+                "size",
+                "seed",
+                "guidanceScale",
+                "responseFormat",
+                "watermark",
+            ],
+        };
+        const key = Object.keys(map).find((key) => model.includes(key));
+        if (!key) {
+            throw new Error(`${this.name} only support ${Object.keys(map).join(", ")}`);
+        }
+        if (!map[key]) {
+            throw new Error(`${this.name} only support ${Object.keys(map).join(", ")}`);
+        }
+        const mergeInput = { ...this.modelOptions, ...input };
+        const body = { ...(0, camelize_js_1.snakelize)((0, type_utils_js_1.pick)(mergeInput, map[key])), model };
+        body.response_format =
+            mergeInput.responseFormat === "base64" ? "b64_json" : mergeInput.responseFormat || "url";
+        const response = await fetch((0, ufo_1.joinURL)(url, `/images/generations`), {
+            method: "POST",
+            headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Doubao API error: ${response.status} ${response.statusText} ${error}`);
+        }
+        if (body.stream) {
+            if (!response.body)
+                throw new Error("Streaming not supported in this environment");
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let done = false;
+            let buffer = "";
+            while (!done) {
+                const { value, done: doneReading } = await reader.read();
+                done = doneReading;
+                if (value) {
+                    buffer += decoder.decode(value);
+                }
+            }
+            const dataObjects = this.extractDataObjects(buffer);
+            const error = dataObjects.find((i) => i.type === "image_generation.partial_failed");
+            if (error) {
+                throw new Error(`Doubao API error: ${error.error.message}`);
+            }
+            const completed = dataObjects.find((i) => i.type === "image_generation.completed");
+            return {
+                images: dataObjects
+                    .filter((i) => i.type === "image_generation.partial_succeeded")
+                    .map((i) => {
+                    return {
+                        url: i.url,
+                        base64: i.b64_json,
+                    };
+                }),
+                usage: { inputTokens: 0, outputTokens: completed?.usage.output_tokens || 0 },
+                model: model,
+            };
+        }
+        const data = await response.json();
+        if (data.error) {
+            throw new Error(`Doubao API error: ${data.error.message}`);
+        }
+        return {
+            images: data.data.map((item) => ({
+                url: item.url,
+                base64: item.b64_json,
+            })),
+            usage: {
+                inputTokens: 0,
+                outputTokens: data?.usage?.output_tokens || 0,
+            },
+            model: data.model,
+        };
+    }
+}
+exports.DoubaoImageModel = DoubaoImageModel;

package/lib/cjs/index.d.ts

@@ -1 +1,2 @@
 export * from "./doubao-chat-model.js";
+export * from "./doubao-image-model.js";

package/lib/cjs/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./doubao-chat-model.js"), exports);
+__exportStar(require("./doubao-image-model.js"), exports);

package/lib/dts/doubao-image-model.d.ts

@@ -0,0 +1,34 @@
+import { ImageModel, type ImageModelInput, type ImageModelOptions, type ImageModelOutput } from "@aigne/core";
+export interface DoubaoImageModelInput extends ImageModelInput {
+    size?: string;
+    seed?: number;
+    sequentialImageGeneration?: boolean;
+    sequentialImageGenerationOptions?: {
+        maxImages: number;
+    };
+    stream?: boolean;
+    guidanceScale?: number;
+    watermark?: boolean;
+}
+export interface DoubaoImageModelOutput extends ImageModelOutput {
+}
+export interface DoubaoImageModelOptions extends ImageModelOptions<DoubaoImageModelInput, DoubaoImageModelOutput> {
+    apiKey?: string;
+    baseURL?: string;
+    model?: string;
+    modelOptions?: Omit<Partial<DoubaoImageModelInput>, "model">;
+    clientOptions?: Record<string, any>;
+}
+export declare class DoubaoImageModel extends ImageModel<DoubaoImageModelInput, DoubaoImageModelOutput> {
+    options?: DoubaoImageModelOptions | undefined;
+    constructor(options?: DoubaoImageModelOptions | undefined);
+    protected apiKeyEnvName: string;
+    get credential(): {
+        url: string;
+        apiKey: string | undefined;
+        model: string;
+    };
+    get modelOptions(): Omit<Partial<DoubaoImageModelInput>, "model"> | undefined;
+    private extractDataObjects;
+    process(input: DoubaoImageModelInput): Promise<ImageModelOutput>;
+}

package/lib/dts/index.d.ts

@@ -1 +1,2 @@
 export * from "./doubao-chat-model.js";
+export * from "./doubao-image-model.js";

package/lib/esm/doubao-image-model.d.ts

@@ -0,0 +1,34 @@
+import { ImageModel, type ImageModelInput, type ImageModelOptions, type ImageModelOutput } from "@aigne/core";
+export interface DoubaoImageModelInput extends ImageModelInput {
+    size?: string;
+    seed?: number;
+    sequentialImageGeneration?: boolean;
+    sequentialImageGenerationOptions?: {
+        maxImages: number;
+    };
+    stream?: boolean;
+    guidanceScale?: number;
+    watermark?: boolean;
+}
+export interface DoubaoImageModelOutput extends ImageModelOutput {
+}
+export interface DoubaoImageModelOptions extends ImageModelOptions<DoubaoImageModelInput, DoubaoImageModelOutput> {
+    apiKey?: string;
+    baseURL?: string;
+    model?: string;
+    modelOptions?: Omit<Partial<DoubaoImageModelInput>, "model">;
+    clientOptions?: Record<string, any>;
+}
+export declare class DoubaoImageModel extends ImageModel<DoubaoImageModelInput, DoubaoImageModelOutput> {
+    options?: DoubaoImageModelOptions | undefined;
+    constructor(options?: DoubaoImageModelOptions | undefined);
+    protected apiKeyEnvName: string;
+    get credential(): {
+        url: string;
+        apiKey: string | undefined;
+        model: string;
+    };
+    get modelOptions(): Omit<Partial<DoubaoImageModelInput>, "model"> | undefined;
+    private extractDataObjects;
+    process(input: DoubaoImageModelInput): Promise<ImageModelOutput>;
+}

package/lib/esm/doubao-image-model.js

@@ -0,0 +1,166 @@
+import { ImageModel, imageModelInputSchema, } from "@aigne/core";
+import { snakelize } from "@aigne/core/utils/camelize.js";
+import { checkArguments, pick } from "@aigne/core/utils/type-utils.js";
+import { joinURL } from "ufo";
+import { z } from "zod";
+const DOUBAO_DEFAULT_IMAGE_MODEL = "doubao-seedream-4-0-250828";
+const DOUBAO_BASE_URL = "https://ark.cn-beijing.volces.com/api/v3";
+const doubaoImageModelInputSchema = imageModelInputSchema.extend({});
+const doubaoImageModelOptionsSchema = z.object({
+    apiKey: z.string().optional(),
+    baseURL: z.string().optional(),
+    model: z.string().optional(),
+    modelOptions: z.object({}).optional(),
+    clientOptions: z.object({}).optional(),
+});
+export class DoubaoImageModel extends ImageModel {
+    options;
+    constructor(options) {
+        super({
+            ...options,
+            inputSchema: doubaoImageModelInputSchema,
+            description: options?.description ?? "Draw or edit image by Doubao image models",
+        });
+        this.options = options;
+        if (options)
+            checkArguments(this.name, doubaoImageModelOptionsSchema, options);
+    }
+    apiKeyEnvName = "DOUBAO_API_KEY";
+    get credential() {
+        return {
+            url: this.options?.baseURL || process.env.DOUBAO_BASE_URL || DOUBAO_BASE_URL,
+            apiKey: this.options?.apiKey || process.env[this.apiKeyEnvName],
+            model: this.options?.model || DOUBAO_DEFAULT_IMAGE_MODEL,
+        };
+    }
+    get modelOptions() {
+        return this.options?.modelOptions;
+    }
+    extractDataObjects(text) {
+        const dataObjects = [];
+        const lines = text.split("\n");
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith("data:")) {
+                const jsonPart = trimmed.slice(5).trim();
+                if (jsonPart === "[DONE]")
+                    continue;
+                try {
+                    const obj = JSON.parse(jsonPart);
+                    dataObjects.push(obj);
+                }
+                catch (e) {
+                    console.warn("Failed to parse JSON data object:", jsonPart, e);
+                }
+            }
+        }
+        return dataObjects;
+    }
+    async process(input) {
+        const model = input.model || this.credential.model;
+        const { url, apiKey } = this.credential;
+        if (!apiKey) {
+            throw new Error(`${this.name} requires an API key. Please provide it via \`options.apiKey\`, or set the \`${this.apiKeyEnvName}\` environment variable`);
+        }
+        const map = {
+            "doubao-seedream-4": [
+                "model",
+                "prompt",
+                "image",
+                "size",
+                "sequentialImageGeneration",
+                "sequentialImageGenerationOptions",
+                "stream",
+                "responseFormat",
+                "watermark",
+            ],
+            "doubao-seedream-3-0-t2i": [
+                "model",
+                "prompt",
+                "size",
+                "seed",
+                "guidanceScale",
+                "responseFormat",
+                "watermark",
+            ],
+            "doubao-seededit-3-0-i2i": [
+                "model",
+                "prompt",
+                "image",
+                "size",
+                "seed",
+                "guidanceScale",
+                "responseFormat",
+                "watermark",
+            ],
+        };
+        const key = Object.keys(map).find((key) => model.includes(key));
+        if (!key) {
+            throw new Error(`${this.name} only support ${Object.keys(map).join(", ")}`);
+        }
+        if (!map[key]) {
+            throw new Error(`${this.name} only support ${Object.keys(map).join(", ")}`);
+        }
+        const mergeInput = { ...this.modelOptions, ...input };
+        const body = { ...snakelize(pick(mergeInput, map[key])), model };
+        body.response_format =
+            mergeInput.responseFormat === "base64" ? "b64_json" : mergeInput.responseFormat || "url";
+        const response = await fetch(joinURL(url, `/images/generations`), {
+            method: "POST",
+            headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Doubao API error: ${response.status} ${response.statusText} ${error}`);
+        }
+        if (body.stream) {
+            if (!response.body)
+                throw new Error("Streaming not supported in this environment");
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let done = false;
+            let buffer = "";
+            while (!done) {
+                const { value, done: doneReading } = await reader.read();
+                done = doneReading;
+                if (value) {
+                    buffer += decoder.decode(value);
+                }
+            }
+            const dataObjects = this.extractDataObjects(buffer);
+            const error = dataObjects.find((i) => i.type === "image_generation.partial_failed");
+            if (error) {
+                throw new Error(`Doubao API error: ${error.error.message}`);
+            }
+            const completed = dataObjects.find((i) => i.type === "image_generation.completed");
+            return {
+                images: dataObjects
+                    .filter((i) => i.type === "image_generation.partial_succeeded")
+                    .map((i) => {
+                    return {
+                        url: i.url,
+                        base64: i.b64_json,
+                    };
+                }),
+                usage: { inputTokens: 0, outputTokens: completed?.usage.output_tokens || 0 },
+                model: model,
+            };
+        }
+        const data = await response.json();
+        if (data.error) {
+            throw new Error(`Doubao API error: ${data.error.message}`);
+        }
+        return {
+            images: data.data.map((item) => ({
+                url: item.url,
+                base64: item.b64_json,
+            })),
+            usage: {
+                inputTokens: 0,
+                outputTokens: data?.usage?.output_tokens || 0,
+            },
+            model: data.model,
+        };
+    }
+}

package/lib/esm/index.d.ts

@@ -1 +1,2 @@
 export * from "./doubao-chat-model.js";
+export * from "./doubao-image-model.js";

package/lib/esm/index.js

@@ -1 +1,2 @@
 export * from "./doubao-chat-model.js";
+export * from "./doubao-image-model.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/doubao",
-  "version": "1.0.38",
+  "version": "1.0.40",
   "description": "AIGNE doubao SDK for integrating with doubao AI models",
   "publishConfig": {
     "access": "public"
@@ -35,16 +35,20 @@
     }
   },
   "dependencies": {
-    "@aigne/openai": "^0.15.3"
+    "ufo": "^1.6.1",
+    "zod": "^3.25.67",
+    "@aigne/openai": "^0.15.4"
   },
   "devDependencies": {
-    "@types/bun": "^1.2.18",
-    "@types/node": "^24.0.12",
+    "@types/bun": "^1.2.22",
+    "@types/node": "^24.5.1",
+    "detect-port": "^2.1.0",
+    "hono": "^4.9.7",
     "npm-run-all": "^4.1.5",
     "rimraf": "^6.0.1",
-    "typescript": "^5.8.3",
-    "@aigne/core": "^1.60.2",
-    "@aigne/test-utils": "^0.5.51"
+    "typescript": "^5.9.2",
+    "@aigne/core": "^1.60.3",
+    "@aigne/test-utils": "^0.5.52"
   },
   "scripts": {
     "lint": "tsc --noEmit",