Skip to Content
开发文档工具集成OpenAI SDK 兼容

OpenAI SDK 兼容

OfoxAI 完全兼容 OpenAI SDK,从 OpenAI 直连迁移只需修改两个参数:base_urlapi_key

迁移步骤

只需修改两行代码

from openai import OpenAI # 之前:直连 OpenAI # client = OpenAI(api_key="sk-openai-xxx") # 现在:通过 OfoxAI client = OpenAI( base_url="https://api.ofox.ai/v1", # 新增 api_key="<你的 OFOXAI_API_KEY>" # 替换 ) # 其他代码完全不变! response = client.chat.completions.create( model="openai/gpt-4o", # 添加 provider 前缀 messages=[{"role": "user", "content": "Hello!"}] )

模型命名

OfoxAI 使用 provider/model-name 格式标识模型:

OpenAI 原始名称OfoxAI 模型 ID
gpt-4oopenai/gpt-4o
gpt-4o-miniopenai/gpt-4o-mini
gpt-5.2openai/gpt-5.2
text-embedding-3-smallopenai/text-embedding-3-small

通过 OfoxAI,你还可以使用其他厂商的模型:

额外可用模型说明
anthropic/claude-sonnet-4.5Claude Sonnet 4
google/gemini-2.5-flashGemini 2.5 Flash
deepseek/deepseek-chatDeepSeek V3

兼容性

OfoxAI 支持 OpenAI API 的以下功能:

功能状态
Chat Completions✅ 完全兼容
Streaming✅ 完全兼容
Function Calling✅ 完全兼容
JSON Mode✅ 完全兼容
Vision (图像输入)✅ 完全兼容
Embeddings✅ 完全兼容
Models List✅ 完全兼容
Images Generation✅ 完全兼容

框架集成

LangChain

from langchain_openai import ChatOpenAI llm = ChatOpenAI( base_url="https://api.ofox.ai/v1", api_key="<你的 OFOXAI_API_KEY>", model="openai/gpt-4o" )

LlamaIndex

from llama_index.llms.openai import OpenAI llm = OpenAI( api_base="https://api.ofox.ai/v1", api_key="<你的 OFOXAI_API_KEY>", model="openai/gpt-4o" )

Vercel AI SDK

import { createOpenAI } from '@ai-sdk/openai' const ofoxai = createOpenAI({ baseURL: 'https://api.ofox.ai/v1', apiKey: '<你的 OFOXAI_API_KEY>' }) const model = ofoxai('openai/gpt-4o')

任何支持 OpenAI SDK 的框架和工具,都可以通过修改 base_url 接入 OfoxAI。