{"_id":"@ai-media/provider-volcengine","_rev":"5-5805fc6d35458e0a68c7e468b5ceacdb","name":"@ai-media/provider-volcengine","dist-tags":{"latest":"0.1.5"},"versions":{"0.1.1":{"name":"@ai-media/provider-volcengine","version":"0.1.1","license":"MIT","_id":"@ai-media/provider-volcengine@0.1.1","maintainers":[{"name":"windzb","email":"windzb@qq.com"}],"dist":{"shasum":"1819624dd285184f1830f399f32797de83ae1674","tarball":"https://registry.npmjs.org/@ai-media/provider-volcengine/-/provider-volcengine-0.1.1.tgz","fileCount":10,"integrity":"sha512-hSdiAb1LZGxqrRBOIdXMYy6zi2GRdhbk/T1wa0RMfLS3aC31W/Mobi5+5B5CYU4Iya4/zALQ7XYT7wZjWHE+Aw==","signatures":[{"sig":"MEQCIBs0hzJdG5jGU5w8ft9TOQDat0/viFzknDqf1Qbgus/0AiB5de3u3CLHRHOgsMXG/ASixTVr39oqWK9XQ9SnSev8CQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24864},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"2424f1f89827219fc8467a3752f06b84bef86807","scripts":{"test":"bun test","build":"tsup src/index.ts --format esm --out-dir dist --clean --external @ai-media/sdk && tsc -p tsconfig.emit-dts.json","typecheck":"tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit","typecheck:release":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"windzb","email":"windzb@qq.com"},"_npmVersion":"11.13.0","description":"Volcengine Ark image generation provider for AI Media SDK","directories":{},"_nodeVersion":"24.16.0","dependencies":{"@ai-media/sdk":"^0.1.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.2.0","typescript":"^7.0.2","@types/node":"^20","@workspace/typescript-config":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/provider-volcengine_0.1.1_1786609217209_0.7423044198962403","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@ai-media/provider-volcengine","version":"0.1.2","license":"MIT","_id":"@ai-media/provider-volcengine@0.1.2","maintainers":[{"name":"windzb","email":"windzb@qq.com"}],"dist":{"shasum":"a3d86bd86039118db6e5861f5fc8869107b35c08","tarball":"https://registry.npmjs.org/@ai-media/provider-volcengine/-/provider-volcengine-0.1.2.tgz","fileCount":10,"integrity":"sha512-N7VEyxdaaRFxgalBCjWUBZFIOlo42DJWwfC4m3OREd3X4Q+YwFHOSrLWT1yx2qk8fS3mlqWGZOOxUERN1McwbA==","signatures":[{"sig":"MEQCIFkLmIONnkfHSETuk+AxJfU7ihjzJUENPqh7dawpR9mpAiBVZ9uQvpzPhu6Twc435rd9Kz+HH4Y5vR395Coj1GqKYQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24864},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"ea34b4d9d1140bae548933472771a6dd44d7865b","scripts":{"test":"bun test","build":"tsup src/index.ts --format esm --out-dir dist --clean --external @ai-media/sdk && tsc -p tsconfig.emit-dts.json","typecheck":"tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit","typecheck:release":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"windzb","email":"windzb@qq.com"},"_npmVersion":"11.13.0","description":"Volcengine Ark image generation provider for AI Media SDK","directories":{},"_nodeVersion":"24.16.0","dependencies":{"@ai-media/sdk":"^0.1.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.2.0","typescript":"^7.0.2","@types/node":"^20","@workspace/typescript-config":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/provider-volcengine_0.1.2_1786617050244_0.001386136206235955","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@ai-media/provider-volcengine","version":"0.1.3","license":"MIT","_id":"@ai-media/provider-volcengine@0.1.3","maintainers":[{"name":"windzb","email":"windzb@qq.com"}],"dist":{"shasum":"ea434869771a7aea2e94d0dd617058bd05b3b146","tarball":"https://registry.npmjs.org/@ai-media/provider-volcengine/-/provider-volcengine-0.1.3.tgz","fileCount":10,"integrity":"sha512-A28PvNFVOHc+8/iBWIDeokNA5R58163kCsCxobCWUk5XPlNCF2i3Es4eAAZ44TZOxo+SRA1lHzmxWqKtLnmogA==","signatures":[{"sig":"MEUCIQCT3D5x8Y6EcQOZDz0ky6p87EK9efhVI16TLCs2fXN7BAIgdfdkS7Q0YH6ifVyO2StVVXBcsKKuyv4uueU3ABbj6Hk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25316},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"6c3b3f554fde04c18b01ab1db1a640c686a1b627","scripts":{"test":"bun test","build":"tsup src/index.ts --format esm --out-dir dist --clean --external @ai-media/sdk && tsc -p tsconfig.emit-dts.json","typecheck":"tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit","typecheck:release":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"windzb","email":"windzb@qq.com"},"_npmVersion":"11.13.0","description":"Volcengine Ark image generation provider for AI Media SDK","directories":{},"_nodeVersion":"24.16.0","dependencies":{"@ai-media/sdk":"^0.1.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.2.0","typescript":"^7.0.2","@types/node":"^20","@workspace/typescript-config":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/provider-volcengine_0.1.3_1788338225225_0.8130095934505761","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@ai-media/provider-volcengine","version":"0.1.4","license":"MIT","_id":"@ai-media/provider-volcengine@0.1.4","maintainers":[{"name":"windzb","email":"windzb@qq.com"}],"dist":{"shasum":"7e62264f5883246fdd0bdb7531c15906568e5866","tarball":"https://registry.npmjs.org/@ai-media/provider-volcengine/-/provider-volcengine-0.1.4.tgz","fileCount":10,"integrity":"sha512-TRpRane/N4HtquzGCCrTlOHLaP+mVv0RLwoD9icjnPoKFS4PpziF85iqpm0lKwSux3GX0LXFCPyFvtO/YH+asQ==","signatures":[{"sig":"MEQCIB4FFPR3xOXh+7c94++ZGVqb8u3hf16s1JSpVOfFWjU5AiAVDXLG1WAhjSSpCyxA8tn0PJNTnKJ56tFRc/jl0dc0tQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25316},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"5c8cd107a8ccb6238e595123b53eff87d2da7f26","scripts":{"test":"bun test","build":"tsup src/index.ts --format esm --out-dir dist --clean --external @ai-media/sdk && tsc -p tsconfig.emit-dts.json","typecheck":"tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit","typecheck:release":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"windzb","email":"windzb@qq.com"},"_npmVersion":"10.9.3","description":"Volcengine Ark image generation provider for AI Media SDK","directories":{},"_nodeVersion":"22.18.0","dependencies":{"@ai-media/sdk":"^0.1.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.2.0","typescript":"^7.0.2","@types/node":"^20","@workspace/typescript-config":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/provider-volcengine_0.1.4_1788873430980_0.952508236134759","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@ai-media/provider-volcengine","version":"0.1.5","type":"module","description":"Volcengine Ark image generation provider for AI Media SDK","license":"MIT","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"publishConfig":{"access":"public"},"scripts":{"build":"tsup src/index.ts --format esm --out-dir dist --clean --external @ai-media/sdk && tsc -p tsconfig.emit-dts.json","typecheck":"tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit","typecheck:release":"tsc -p tsconfig.json --noEmit","test":"bun test"},"dependencies":{"@ai-media/sdk":"^0.1.5"},"devDependencies":{"@types/bun":"^1.2.0","@types/node":"^20","@workspace/typescript-config":"workspace:*","typescript":"^7.0.2"},"_id":"@ai-media/provider-volcengine@0.1.5","gitHead":"ca953c8881ebb066181712b134a2e559b827aa9f","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-KOxl2EuROFPpzMnPfQVKSbw7vH0lQ/ZFA+cBWnbU4lrwSRlC3CgIxAPDqnWvRmQXUECTD54zffaUxUWDUAZD0g==","shasum":"930b4d5b808bbe4dab1b1c1e8a1989103cb4d0b9","tarball":"https://registry.npmjs.org/@ai-media/provider-volcengine/-/provider-volcengine-0.1.5.tgz","fileCount":10,"unpackedSize":25316,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDSwggoLUtiySjWMVqSCMuAdpEOR4KWLTJ7LqhAlDE8ggIhAJNMGDdSS8Jqj5c2sdBLmnEnYUWlg0FNG1f15oGeTc6A"}]},"_npmUser":{"name":"windzb","email":"windzb@qq.com"},"directories":{},"maintainers":[{"name":"windzb","email":"windzb@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/provider-volcengine_0.1.5_1789053228348_0.2765859216825164"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-13T08:20:17.062Z","modified":"2026-09-10T15:13:48.731Z","0.1.1":"2026-08-13T08:20:17.361Z","0.1.2":"2026-08-13T10:30:50.433Z","0.1.3":"2026-09-02T08:37:05.349Z","0.1.4":"2026-09-08T13:17:11.138Z","0.1.5":"2026-09-10T15:13:48.486Z"},"license":"MIT","description":"Volcengine Ark image generation provider for AI Media SDK","maintainers":[{"name":"windzb","email":"windzb@qq.com"}],"readme":"# @ai-media/provider-volcengine\n\n[![npm version](https://img.shields.io/npm/v/@ai-media/provider-volcengine.svg)](https://www.npmjs.com/package/@ai-media/provider-volcengine)\n[![npm downloads](https://img.shields.io/npm/dm/@ai-media/provider-volcengine.svg)](https://www.npmjs.com/package/@ai-media/provider-volcengine)\n[![License](https://img.shields.io/npm/l/@ai-media/provider-volcengine.svg)](https://github.com/ecafe8/ai-media-sdk/blob/main/packages/provider-volcengine/LICENSE)\n\n[AI Media SDK](../ai-media-sdk/README.md) 的火山引擎方舟（Volcengine Ark）图像生成 Provider。基于原生 `fetch` 调用方舟 OpenAI 兼容图像 API（同步），不依赖平台 SDK。当前覆盖 Doubao-Seedream 图像模型。\n\n> **注意**：本项目处于快速迭代期间，API 可能随时变更，生产使用请锁定版本。\n\n## 安装\n\n```bash\nnpm install @ai-media/sdk @ai-media/provider-volcengine\n```\n\n运行时要求：Node.js >= 20（或 Bun），ESM-only。\n\n## 配置\n\n通过 `createVolcengineProvider(config)` 传入配置对象：\n\n```ts\nimport { createVolcengineProvider } from \"@ai-media/provider-volcengine\";\n\nconst provider = createVolcengineProvider({\n  /** 方舟 API key，作为 `Authorization: Bearer` 凭据发送 */\n  apiKey: \"<your-api-key>\",\n  /** 可选，区域化方舟 API base；默认 https://ark.cn-beijing.volces.com/api/v3 */\n  baseUrl: \"https://ark.cn-beijing.volces.com/api/v3\",\n});\n```\n\n## 快速开始\n\n```ts\nimport { generateImage } from \"@ai-media/sdk\";\n\nconst result = await generateImage({\n  model: provider.image(\"doubao-seedream-5-0-pro-260628\"),\n  prompt: \"江南小镇的清晨，水彩画风格\",\n  size: \"2K\",\n  providerOptions: {\n    volcengine: {\n      watermark: false,\n      output_format: \"png\",\n      response_format: \"url\",\n    },\n  },\n});\n\nconsole.log(result.content); // ImageContent[]\n```\n\n## 图像编辑\n\n所有 Seedream 模型均支持 I2I 编辑（`editImage`），参考图以 URL 传入：\n\n```ts\nimport { editImage } from \"@ai-media/sdk\";\n\nconst result = await editImage({\n  model: provider.image(\"doubao-seedream-5-0-pro-260628\"),\n  prompt: \"把画面改成雪天\",\n  images: [{ url: \"https://example.com/input.png\" }],\n});\n```\n\n## 模型一览\n\n所有模型均为同步调用，每次返回 1 张图（`n` 上限为 1）。`size` 支持档位形式，也支持不超过 `maxResolution` 的 `WxH` 像素值。\n\n| 模型                              | 生成 | 编辑 | size               | 分辨率上限 | 参考图上限 | 输出格式   |\n| --------------------------------- | ---- | ---- | ------------------ | ---------- | ---------- | ---------- |\n| `doubao-seedream-5-0-pro-260628`  | ✅   | ✅   | `1K` / `2K`        | 2048x2048  | 10 张      | png / jpeg |\n| `doubao-seedream-5-0-260128`      | ✅   | ✅   | `2K` / `3K` / `4K` | 4096x4096  | 14 张      | png / jpeg |\n| `doubao-seedream-5-0-lite-260128` | ✅   | ✅   | `2K` / `3K` / `4K` | 4096x4096  | 14 张      | png / jpeg |\n| `doubao-seedream-4-5-251128`      | ✅   | ✅   | `2K` / `4K`        | 4096x4096  | 14 张      | jpeg       |\n| `doubao-seedream-4-0-250828`      | ✅   | ✅   | `1K` / `2K` / `4K` | 4096x4096  | 14 张      | jpeg       |\n\n```ts\nfor (const model of provider.listModels()) {\n  console.log(model.id, model.capabilities);\n}\n```\n\n## provider 专属参数\n\n方舟专属字段放在 `providerOptions.volcengine` 命名空间下（类型 `VolcengineImageProviderOptions`）：\n\n| 字段                      | 说明                                              |\n| ------------------------- | ------------------------------------------------- |\n| `watermark`               | 是否添加 “AI生成” 水印（默认 false）              |\n| `output_format`           | 输出格式 `png` / `jpeg`（仅 5.0 系列支持自定义）  |\n| `response_format`         | 结果返回形式 `url`（默认）/ `b64_json`            |\n| `optimize_prompt_options` | prompt 优化模式：`{ mode: \"standard\" \\| \"fast\" }` |\n\n```ts\nconst result = await generateImage({\n  model: provider.image(\"doubao-seedream-5-0-pro-260628\"),\n  prompt: \"江南小镇的清晨\",\n  size: \"2K\",\n  providerOptions: {\n    volcengine: {\n      watermark: false,\n      output_format: \"png\",\n      response_format: \"url\",\n      optimize_prompt_options: { mode: \"standard\" },\n    },\n  },\n});\n```\n\n## 错误处理\n\n所有失败抛出 `@ai-media/sdk` 的 `SdkError`（`AUTH_ERROR` / `RATE_LIMITED` / `INVALID_REQUEST` / `PROVIDER_ERROR` / `TIMEOUT` / `NETWORK_ERROR` 等），错误信息不包含凭据；未知模型 id 抛出 `UNKNOWN_MODEL`。详见 `@ai-media/sdk` README。\n\n## License\n\nMIT\n","readmeFilename":"README.md"}