Migrate from OpenAI | Venice API Docs

Venice AI 是 OpenAI 的直接替代品。相同的 SDK、相同的代码 —— 只需更改两行。即可获得隐私优先的推理、无审查的模型和有竞争力的定价。

两行迁移

# 迁移前（OpenAI）
from openai import OpenAI
client = OpenAI()

# 迁移后（Venice）—— 修改 api_key 和 base_url
from openai import OpenAI
client = OpenAI(
    api_key="your-venice-api-key",           # ← 修改点 1
    base_url="https://api.venice.ai/api/v1",  # ← 修改点 2
)

// 迁移前（OpenAI）
import OpenAI from "openai";
const client = new OpenAI();

// 迁移后（Venice）
import OpenAI from "openai";
const client = new OpenAI({
  apiKey: "your-venice-api-key",
  baseURL: "https://api.venice.ai/api/v1",
});

# 迁移前
curl https://api.openai.com/v1/chat/completions ...

# 迁移后 —— 只需更改 URL 和密钥
curl https://api.venice.ai/api/v1/chat/completions ...

前往 venice.ai/settings/api 生成密钥，或参阅 API 密钥指南。

环境变量

# 迁移前
OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://api.openai.com/v1

# 迁移后
OPENAI_API_KEY=your-venice-api-key
OPENAI_BASE_URL=https://api.venice.ai/api/v1

许多库和工具会自动读取 OPENAI_API_KEY 和 OPENAI_BASE_URL。仅仅更新这些环境变量可能就已足够。部分工具仍然使用 OPENAI_API_BASE 表示相同的 URL。

模型

你可以传入 Venice 的模型 ID、诸如 default 或 most_uncensored 等 trait；对于聊天和嵌入模型，也可以使用熟悉的 OpenAI 风格模型名称。Venice 会通过兼容性映射转换 OpenAI 的聊天和嵌入模型名称；其他端点（包括音频）需要使用 Venice 模型 ID。Trait 始终会解析为该角色当前对应的模型，详见模型 traits。在文本模型和定价页面查看实时目录。若需完整的首次请求演示，请参阅快速开始。

特性兼容性

特性	OpenAI	Venice	说明
Chat Completions	✅	✅	兼容。未知的顶层字段（包括 `logit_bias` 和 `service_tier` 等 OpenAI 专有字段）会返回 HTTP 400
Streaming	✅	✅	SSE 格式相同，另外会附加一个最终的用量数据块，参见流式格式
Function Calling	✅	✅	相同的 `tools` 参数
Structured Output	✅	✅	相同的 `response_format`
Vision	✅	✅	相同的 content 数组格式
Embeddings	✅	✅	仅支持文本；token 数组会返回 HTTP 400
Image Generation	✅	✅	通过 `/images/generations` 兼容 OpenAI
Image Edits	✅	❌	没有 `/images/edits` 端点。请使用原生 `/image/edit` 端点
TTS	✅	✅	请求结构兼容；请使用 Venice 模型 ID（使用 OpenAI 音频模型名称会返回 HTTP 400）
STT	✅	✅	请求结构兼容；请使用 Venice 模型 ID。`response_format` 仅支持 `json` 或 `text`。不支持 `/audio/translations`
Responses API	✅	✅	OpenAI 模型原生支持，其他模型经过转换，参见限制
Assistants API	✅	❌	改用 Characters 或 function calling
Batch API	✅	❌	暂不可用
Fine-tuning	✅	❌	不可用

如需使用兼容 OpenAI 端点之外的原生图像选项，请参阅图像生成。

流式格式

Chat Completions 流使用 OpenAI 的数据块格式，并以 data: [DONE] 结束。有两处细节不同：

用量数据块。 每个流都会在 [DONE] 之前以一个用量数据块结束，即使 stream_options.include_usage 为 false 也是如此。该数据块的 choices 数组为空，并携带 usage 和一个 cost 对象。在每个数据块上读取 choices[0] 的客户端应跳过没有 choices 的数据块。
流开始后的错误。 此时 HTTP 状态已经是 200，因此错误会以带有 error 对象（message、type、code）的 data: 事件返回，随后是 data: [DONE]。当模型过载时，该对象还会包含以秒为单位的 retry_after。

data: {"error":{"message":"...","type":"server_error","code":"...","param":null}}

data: [DONE]

Venice 独有功能

通过 extra_body 以 venice_parameters 传入 Venice 专有选项。内置的 Web 搜索通常是最常见的额外参数：

response = client.chat.completions.create(
    model="default",
    messages=[{"role": "user", "content": "Latest AI news today"}],
    extra_body={
        "venice_parameters": {
            "enable_web_search": "auto"
        }
    },
)

venice_parameters 中的未知键会被忽略而不是被拒绝，因此请对照 API 参考检查每个键的拼写。同样的模式也适用于网页抓取、引用与 Characters。如果客户端无法修改请求体，可以附加一个模型特性后缀，例如 default:enable_web_search=auto。在兼容 OpenAI 的接口之外，Venice 还提供原生的视频、音乐、网页检索和 x402 API。

框架

大多数 AI 框架只需更改 base URL 即可与 Venice 协同工作：

LangChain

ChatOpenAI 中的 base_url；OpenAIEmbeddings 上的 check_embedding_ctx_length=False

Vercel AI SDK

createOpenAI 中的 baseURL

LlamaIndex

兼容 OpenAI 的客户端上的 api_base

CrewAI

OPENAI_API_BASE 环境变量

PydanticAI

使用 Venice base URL 的 OpenAI 兼容模型

Cursor

设置中的自定义 API 端点

Claude Code

通过 Venice 路由 Claude Code

Codex CLI

config.toml 中的模型提供方

Aider

OPENAI_API_BASE 环境变量

更多编码代理和工具已列在 AI Agents 页面。

无审查模型

Venice 的私有无审查模型没有任何内容过滤，适用于：

没有护栏的创意写作
安全研究和红队测试
没有拒答模式的诚实分析
没有额外免责声明的医学和法律信息

使用 most_uncensored trait，或从文本模型页面选择当前的无审查模型 ID。

获取你的 API 密钥

生成 Venice API 密钥，几分钟内开始迁移

文档

快速开始

文本与聊天

图像

视频

音频

搜索与 RAG

智能体与集成

编程工具

智能体工具

SDK 与框架

从 OpenAI 迁移

两行迁移

环境变量

模型

特性兼容性

流式格式

Venice 独有功能

框架

LangChain

Vercel AI SDK

LlamaIndex

CrewAI

PydanticAI

Cursor

Claude Code

Codex CLI

Aider

无审查模型

获取你的 API 密钥

​两行迁移

​环境变量

​模型

​特性兼容性

​流式格式

​Venice 独有功能

​框架

LangChain

Vercel AI SDK

LlamaIndex

CrewAI

PydanticAI

Cursor

Claude Code

Codex CLI

Aider

​无审查模型

获取你的 API 密钥

两行迁移

环境变量

模型

特性兼容性

流式格式

Venice 独有功能

框架

无审查模型