OpenAI 兼容 API

通过一个 OpenAI 风格的接口使用 Claude 和 GPT 模型。

简短回答

APIVAI 的 OpenAI 兼容 API 地址是 https://api.apivai.com/v1:把 OpenAI SDK 或工具指向它,填入 APIVAI 密钥,即可调用 /v1/chat/completions、/v1/responses 或 /v1/models,同一个密钥可用 Claude 和 GPT 的模型 ID。截至 2026-11-18,claude-sonnet-5-5 每百万输入 / 输出 token 为 $0.75 / $3.79,gpt-6.1-sol 为 $0.30 / $1.52。全部模型 ID 和价格见模型页。

BASE URLhttps://api.apivai.com/v1

APIVAI 使用 OpenAI 的 HTTP 请求格式,凡是支持自定义 base URL 的工具和 SDK 都能直接接入,无需额外开发。只需替换 base URL 和 Key,其余代码保持不变。「OpenAI 兼容」具体包括什么、各家服务哪里不一样,见 什么是 OpenAI 兼容 API。

接口列表

方法与路径用途说明
GET /v1/models获取模型列表写死模型名之前先调用它确认。
POST /v1/chat/completions对话补全接收 OpenAI 风格的 messages 数组。
POST /v1/chat/completions流式对话加上 "stream": true 即以 SSE 方式逐段返回。
POST /v1/responsesResponses 接口Codex CLI 使用该接口。

请求头

Authorization: Bearer YOUR_APIVAI_API_KEY Content-Type: application/json

用 cURL 快速验证

# 1) List the models available to your key curl https://api.apivai.com/v1/models \ -H "Authorization: Bearer $APIVAI_API_KEY" # 2) Send a minimal chat request curl https://api.apivai.com/v1/chat/completions \ -H "Authorization: Bearer $APIVAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-5-5", "messages": [{"role": "user", "content": "Return one short sentence."}] }'

OpenAI SDK

Python

from openai import OpenAI client = OpenAI( api_key="YOUR_APIVAI_API_KEY", base_url="https://api.apivai.com/v1", ) resp = client.chat.completions.create( model="claude-sonnet-5-5", messages=[ {"role": "system", "content": "You are a concise technical assistant."}, {"role": "user", "content": "Explain API gateways in 2 sentences."}, ], temperature=0.2, ) print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai"; const client = new OpenAI({ apiKey: process.env.APIVAI_API_KEY, baseURL: "https://api.apivai.com/v1", }); const resp = await client.chat.completions.create({ model: "gpt-6.1-sol", messages: [{ role: "user", content: "Explain API gateways in 2 sentences." }], }); console.log(resp.choices[0]?.message?.content);

流式输出

将 stream 设为 true,并逐段读取响应体。每段数据以 "data:" 开头,收到 [DONE] 或连接关闭即表示结束。

stream = client.chat.completions.create( model="claude-sonnet-5-5", messages=[{"role": "user", "content": "Write a short deployment checklist."}], stream=True, ) for chunk in stream: if chunk.choices and chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="")

函数调用(工具调用)

支持标准的两步流程:模型返回工具调用,你执行工具,再把结果发回去获取最终回答。

import json from openai import OpenAI client = OpenAI(base_url="https://api.apivai.com/v1", api_key="YOUR_APIVAI_API_KEY") MODEL = "claude-sonnet-5-5" TOOLS = [{ "type": "function", "function": { "name": "get_weather", "description": "Get the current weather for a city.", "parameters": { "type": "object", "properties": {"city": {"type": "string"}}, "required": ["city"], }, }, }] messages = [{"role": "user", "content": "What's the weather in Tokyo?"}] first = client.chat.completions.create(model=MODEL, messages=messages, tools=TOOLS) choice = first.choices[0].message messages.append(choice) for call in choice.tool_calls or []: args = json.loads(call.function.arguments) messages.append({ "role": "tool", "tool_call_id": call.id, "content": json.dumps({"city": args["city"], "temp_c": 21}), }) final = client.chat.completions.create(model=MODEL, messages=messages, tools=TOOLS) print(final.choices[0].message.content)

常用框架

LangChain

from langchain_openai import ChatOpenAI llm = ChatOpenAI( base_url="https://api.apivai.com/v1", api_key="YOUR_APIVAI_API_KEY", model="claude-sonnet-5-5", ) print(llm.invoke("Explain API gateways in 2 sentences.").content)

LlamaIndex

from llama_index.llms.openai_like import OpenAILike llm = OpenAILike( model="claude-sonnet-5-5", api_base="https://api.apivai.com/v1", api_key="YOUR_APIVAI_API_KEY", is_chat_model=True, ) print(llm.complete("Explain API gateways in 2 sentences."))

如何选择模型

  1. 用你的 API Key 调用 GET /v1/models。
  2. 从返回结果中选一个模型 ID。
  3. 用它发一条简短的对话请求。
  4. 确认可用后再写进应用配置。

「兼容」的含义

请求格式与 OpenAI 保持一致,但并非所有 OpenAI 接口的全部参数在任何场景下都受支持。迁移现有项目时,建议先用最小请求体跑通,确认模型可用,再逐个添加可选参数。

常见错误

404 通常是 base URL 里少了或重复了 /v1;401 表示密钥缺失或错误;model_not_found 表示模型 ID 不在 GET /v1/models 的返回结果中。所有错误码及解决方法见 Claude API 错误码。