OpenAI API 是什么?接口详解与国内接入

OpenAI API 的定义

API(Application Programming Interface,应用编程接口)是程序之间通信的标准方式。OpenAI API 让你的代码能"对话"OpenAI的AI模型。

工作流程:

• 你的代码发送 HTTP 请求(包含提示词、模型名、参数)
• OpenAI 服务器用AI模型处理请求
• 返回 JSON 响应(包含生成的文本/图片/音频)

OpenAI API 已成为AI行业的事实标准——Claude、Gemini、DeepSeek 等竞品都提供"OpenAI兼容接口",说明这套API设计已被广泛认可。

核心接口一览

API 计费方式

OpenAI API 按 token 计费(输入token + 输出token):

通过 AI的那些事儿 调用,价格比官方便宜 20%-40%,且支持人民币充值。

API Key 与认证

调用 OpenAI API 需要 API Key(密钥)进行身份认证:

• 格式:以 sk- 开头的字符串
• 获取:在 OpenAI 控制台或 AI的那些事儿 后台生成
• 使用:放在 HTTP 请求的 Authorization 头中,或通过 SDK 的 api_key 参数传入
• 安全:不要在前端代码或公开仓库中暴露 Key,泄露后立即重新生成

官方 SDK

国内怎么调用 OpenAI API?

OpenAI 官方不对中国大陆提供服务。通过 AI的那些事儿 解决:

• 100% 兼容:完全兼容 OpenAI API 格式,代码零改动,只需改 base_url
• 国内直连:境内骨干节点,无需代理,延迟低至 50ms
• 全接口支持:Chat、Images、Embeddings、Audio、Fine-tuning 全部可用
• 价格更低:比官方便宜 20%-40%,人民币充值
• 安全无忧:Key 只在本站签发,不暴露上游账号

实战:5 分钟跑通 OpenAI API

1. 获取 AI的那些事儿 API Key。
2. 安装 SDK:pip install openai 或 npm install openai。
3. 把 base_url 改为 https://api.example.com/v1,开始调用。

Python 示例:完整 API 调用

from openai import OpenAI

client = OpenAI(
    api_key="你的Key",
    base_url="https://api.example.com/v1"  # 只需改这一行
)

# Chat Completions API
r = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手"},
        {"role": "user", "content": "OpenAI API 有哪些核心接口?"}
    ],
    temperature=0.7,
    max_tokens=500
)
print(r.choices[0].message.content)
print(f"消耗token: 输入{r.usage.prompt_tokens} + 输出{r.usage.completion_tokens}")

# Embeddings API
r = client.embeddings.create(
    model="text-embedding-3-small",
    input="OpenAI API 是开发者调用AI能力的标准接口"
)
print(f"向量维度: {len(r.data[0].embedding)}")

# Images API
r = client.images.generate(
    model="dall-e-3",
    prompt="一个开发者在终端中调用API的场景,极简风格",
    size="1024x1024"
)
print(f"图片: {r.data[0].url}")

Node.js 示例:流式输出

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "你的Key",
  baseURL: "https://api.example.com/v1",  // 只需改这一行
});

// 流式输出(Server-Sent Events)
const stream = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "用100字介绍OpenAI API的核心价值" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

cURL 示例:最原始的调用方式

curl https://api.example.com/v1/chat/completions \
  -H "Authorization: Bearer 你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

常见问题

国内直连 OpenAI API,代码零改动

改一行 base_url,即可在国内调用 OpenAI 全部接口。