OpenAI API 入门教程

OpenAI API 是目前最流行的 AI 接口之一，提供 GPT-4o、GPT-4 Turbo 等强大模型。本文从零开始，带你完成注册、获取 Key、发送第一个请求，直到实现流式输出。

注册 OpenAI 账户

1. 访问 platform.openai.com
2. 使用邮箱注册（需要支持的国家/地区）
3. 完成手机号验证
4. 绑定支付方式

获取 API Key

1. 登录 platform.openai.com/api-keys
2. 点击 "Create new secret key"
3. 给 Key 命名（如 "my-app"）
4. 复制并安全保存（只显示一次）

安装 SDK

# Python
pip install openai

# Node.js
npm install openai

发送第一个请求

Python

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://claude4u.com/v1"  # 轻舟 AI 中转地址
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "你是一个友好的 AI 助手"},
        {"role": "user", "content": "用 Python 写一个冒泡排序"}
    ],
    max_tokens=1024
)

print(response.choices[0].message.content)

Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'your-api-key',
  baseURL: 'https://claude4u.com/v1'
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [
    { role: 'system', content: '你是一个友好的 AI 助手' },
    { role: 'user', content: '用 JavaScript 写一个防抖函数' }
  ]
});

console.log(response.choices[0].message.content);

cURL

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

流式输出

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://claude4u.com/v1"
)

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "讲一个关于程序员的笑话"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

常见问题

ConnectionError / Timeout

网络连接问题，检查代理设置或直接使用中转服务：

# 设置环境变量使用中转
export OPENAI_API_KEY="your-relay-key"
export OPENAI_BASE_URL="https://claude4u.com/v1"

AuthenticationError

API Key 错误或过期，重新检查 Key 是否正确。

InsufficientQuotaError

账户余额不足，需要充值。使用中转站可以获得更灵活的充值方式。

API 消息角色

• system：系统提示词，设定 AI 行为
• user：用户消息
• assistant：AI 回复（用于多轮对话上下文）