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 名称。Trait 始终会解析为该角色当前对应的模型 —— 详见模型 traits。在文本模型和定价页面查看实时目录。若需完整的首次请求演示，请参阅快速开始。

特性兼容性

特性	OpenAI	Venice	说明
Chat Completions	✅	✅	完全兼容
Streaming	✅	✅	SSE 格式相同
Function Calling	✅	✅	相同的 `tools` 参数
Structured Output	✅	✅	相同的 `response_format`
Vision	✅	✅	相同的 content 数组格式
Embeddings	✅	✅	相同 API
Image Generation	✅	✅	通过 `/images/generations` 兼容 OpenAI
TTS	✅	✅	兼容
STT	✅	✅	兼容
Responses API	✅	✅	Alpha
Assistants API	✅	❌	改用 Characters 或 function calling
Batch API	✅	❌	暂不可用
Fine-tuning	✅	❌	不可用

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

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"
        }
    },
)

同样的模式也适用于网页抓取、引用与 Characters。如果客户端无法修改请求体，可以附加一个模型特性后缀，例如 default:enable_web_search=auto。在兼容 OpenAI 的接口之外，Venice 还提供原生的视频、音乐、网页检索和 x402 API。

框架

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

LangChain

ChatOpenAI 中的 base_url

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 独有功能

框架

无审查模型