# @antseed/provider-openai 中文文档

规范地址：https://npmcn.com/package/%40antseed/provider-openai/

版本：0\.2\.56
npm 元数据更新时间：2026-11-07T14:27:15.315Z
中文译文更新时间：2026-11-06T18:44:58.819Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40antseed/provider-openai
原文对照：https://npmcn.com/package/%40antseed/provider-openai/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：104 kB，15 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@antseed/node \>=0\.1\.0
- 首次发布：2026-02-27T09:00:06.766Z
- 最新版本发布：2026-11-07T14:27:15.150Z
- 近 30 天下载量：2457（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：58（近 12 个月 58 个）

## 中文简介

Antseed 的 OpenAI 兼容供应商插件

## 安装

```sh
npm install @antseed/provider-openai
```

也可以使用：`pnpm add @antseed/provider-openai`、`yarn add @antseed/provider-openai`、`bun add @antseed/provider-openai`

## README

# @antseed/ professor-openai (英语)

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

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

## 安装

```bash
antseed plugin add @antseed/provider-openai
```

## 使用量

```bash
# 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` (见 [配置](https://npmcn.com/docs/config)) (中文(简体) ).

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

### 机密( env vars)

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

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

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

### 服务配置( config.json)

```bash
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相容的,但其图像编辑端点是本土的. 用兼容的威尼斯编辑模式

```bash
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`数字 :

```bash
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 是什么？

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 和提交记录判断。