@antseed/provider-openai

中文文档
0.2.56发布于 2026/11/07TypeScriptES Module近 30 天下载 2457

Antseed 的 OpenAI 兼容供应商插件

中文使用文档
文档目录9 节
  1. 安装
  2. 使用量
  3. 配置
  4. 机密( env vars)
  5. 运行时间切换( env vars, 可选)
  6. 服务配置( config.json)
  7. 威尼斯图像编辑
  8. 语音文本
  9. 如何运作

@antseed/ professor-openai (英语)

在AntSeed P2P网络上提供OpenAI相容的API容量(OpenAI,同心同德,OpenRouter,威尼斯等).

重要内容: 简单转售原始 API 访问而不增加值可能会违反您的 API 提供者的服务条款 。 AntSeed是为那些在API访问之外建立区别服务的提供者设计的——例如,在信任的执行环境(TEE)内进行推论,包装特定域的技能或代理,微调模型,或提供管理下的产品经验. 在提供网络容量之前, 总是审查您的API 提供者的使用政策 .

安装

antseed plugin add @antseed/provider-openai

使用量

# Secrets go in env vars
export OPENAI_API_KEY=sk-...

# Everything else lives in config.json, set via the CLI
antseed config seller add-provider together --plugin openai --base-url https://api.together.ai
antseed config seller add-service together kimi-k2.5 \
  --upstream "moonshotai/Kimi-K2.5" \
  --input 0.5 --output 2.8 \
  --categories math,coding

antseed seller start

配置

只有上游认证和运行时间切换进入env vars. 定价、类别、上游模式绘图和宣布的服务清单均生活在 seller.providers.<name>.services[id] 内 ~/.antseed/config.json (见 配置) (中文(简体) ).

如果你准备好了 baseUrl 内 config.json,不需要导出 OPENAI_BASE_URL 分别. antseed seller start 读取提供者块和通过 baseUrl 自动输入插件运行时间.

机密( env vars)

密钥需求说明
OPENAI_API_KEY对OpenAI 兼容上游 API 密钥

运行时间切换( env vars, 可选)

密钥默认说明
OPENAI_PROVIDER_FLAVORgeneric特殊处理简介generic, (中文(简体) ), openrouter, (中文(简体) ), venice) (中文(简体) ). 威尼斯也从 baseUrl。 。 。 .
OPENAI_UPSTREAM_PROVIDER- 说吧可选的 OpenRouter 上游提供者选择器
OPENAI_EXTRA_HEADERS_JSON- 说吧作为 JSON 对象的额外信头
OPENAI_BODY_INJECT_JSON- 说吧JSON 对象合并为请求正文
OPENAI_STRIP_HEADER_PREFIXES- 说吧逗号分隔的页眉前缀为去除

服务配置( config.json)

antseed config seller add-service together deepseek-v3.1 \
  --upstream "deepseek-ai/DeepSeek-V3.1" \
  --input 0.6 --output 1.7 --cached 0.06 \
  --categories chat,math,coding

antseed config seller add-service together kimi-k2.5 \
  --upstream "moonshotai/Kimi-K2.5" \
  --input 0.5 --output 2.8 \
  --categories math,coding

CLI读取 seller.providers.<name>.services[id] 把它变成平地的密钥ANTSEED_SERVICE_ALIAS_MAP_JSON, (中文(简体) ), ANTSEED_SERVICE_IMAGE_EDIT_MODEL_MAP_JSON, (中文(简体) ), ANTSEED_SERVICE_PRICING_JSON, (中文(简体) ), ANTSEED_ALLOWED_SERVICES)这个插件的 configSchema 内部消耗。 类别直接写入 provider.serviceCategories 由卖方开始,而不是通过inv var。 您不应该直接设置这些嵌入键 .

威尼斯图像编辑

威尼斯的一代端点是OpenAI相容的,但其图像编辑端点是本土的. 用兼容的威尼斯编辑模式

export OPENAI_API_KEY=...

antseed config seller add-provider venice \
  --plugin openai \
  --base-url https://api.venice.ai/api

antseed config seller add-service venice grok-imagine-image-quality \
  --upstream grok-imagine-image-quality \
  --venice-edit-model grok-imagine-quality-edit \
  --input 0 --output 0 \
  --unit-billing-models '{"openai-images":{"version":1,"components":[{"unit":"output_images","priceUsd":0.06}]}}'

共享图像单元价格适用于生成和编辑,而不会改变发现元数据。 示例价格反映了威尼斯在写时的目录; 请检查当前 type=image 财务报告和审定财务报表 type=inpaint 由威尼斯的模型 API在广告价格之前.

公共服务仍保留 grok-imagine-image-quality 用于生成和后续编辑。 对于 POST /v1/images/edits,供应商将多段请求发送给威尼斯 /api/v1/image/edit (或 /api/v1/image/multi-edit 当请求有多个图像时, 如重复 image 或者说 image[] 部件,或 a quality 字段),替换 grok-imagine-quality-edit,并转换威尼斯对 OpenAI 图像的原始图像响应 b64_json 形状。 明确 response_format=url 和无支持的多段字段被当地拒绝,而不是默默地放弃.

只有威尼斯服务 --venice-edit-model 广告 inputs: ["text", "image"],并添加 image 财务报告和审定财务报表 moderation 改为 supportedParameters (购买者路由只自动编辑到列出的服务) image) (中文(简体) ). 无此选项的威尼斯图像服务广告 inputs: ["text"],保留可供生成,并拒绝本地编辑,而不调用无效的上游端点。 CLI 将选中的模型存储为 imageEditModel 在服务中的耐用卖方配置; 卖方启动器装入该字段并将其传递给供应商。 编辑配对必须配置每个服务;提供者从来不从生成模型名称中猜测相容性. 当编辑配对未明确时, 销售者启动会警告 openai-images 计费模型.

语音文本

上游模式为文字对语音模式的服务(tts-1, (中文(简体) ), tts-1-hd, (中文(简体) ), gpt-4o-mini-tts威尼斯岛 tts-…以广告形式公布 openai-audio-speech 并任职于 POST /v1/audio/speech,每个字符计费 input_characters数字 :

antseed config seller add-service venice tts-kokoro \
  --unit-billing-models '{"openai-audio-speech":{"version":1,"components":[{"unit":"input_characters","priceUsd":0.0000035}]}}'

在威尼斯, 提供者读每个语音模型的声音来自 GET /api/v1/models?type=tts 并宣布为 capabilities.speech,除非服务配置设置 capabilities.speech.voices卖方拒绝提供未列出的语音。 身体注射(OPENAI_BODY_INJECT_JSON)不适用于发言请求.

如何运作

用途 BaseProvider 财务报告和审定财务报表 StaticTokenProvider 从 @antseed/provider-core 中继请求到 OpenAI 兼容的 API Authorization: Bearer 认证。 威尼斯图像编辑使用一个提供者-本地端点适配器,同时保留相同的AntSeed请求,路由,计量和支付流量.

版本与发布记录

@antseed/provider-openai 共发布 58 个版本,首次发布于 2026/02/27;过去 12 个月发布了 58 个版本。

版本发布日期距今
0.2.56latest2026/11/07今天
0.2.552026/11/043 天前
0.2.542026/11/043 天前
0.2.532026/10/2612 天前
0.2.522026/10/1821 天前
0.2.512026/10/1622 天前

关于 @antseed/provider-openai 的常见问题

@antseed/provider-openai 是什么?

Antseed 的 OpenAI 兼容供应商插件

如何安装 @antseed/provider-openai?

在项目目录运行 npm install @antseed/provider-openai,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@antseed/node(>=0.1.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@antseed/provider-openai 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@antseed/provider-openai 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@antseed/provider-openai 可以商用吗?

@antseed/provider-openai 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@antseed/provider-openai 的下载量有多少?

根据 npm 官方下载统计,@antseed/provider-openai 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,457 次,日均约 82 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@antseed/provider-openai 还在维护吗?

最新版本 0.2.56 发布于 2026/11/07(今天);至今共发布 58 个版本,其中过去 12 个月发布了 58 个;首次发布于 2026/02/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。