快速入门

5 分钟完成注册、创建密钥、发起你的第一次 AI API 调用。

前置条件: 你只需要一个邮箱地址和一台能联网的电脑,无需 VPN。

1. 注册账号

  1. 前往 控制台https://api2everything.xyz/console
  2. 点击「注册」,使用邮箱完成注册
  3. 注册成功后,系统将自动赠送 1 元免费体验额度,足够你完成本教程的所有调用
提示: 免费额度可调用包括 GPT-4o、Claude、DeepSeek 在内的大部分模型,无需充值即可体验。

2. 创建 API Key

  1. 登录 控制台
  2. 进入左侧菜单「令牌(Token)」页面
  3. 点击「创建令牌」按钮
  4. 填写令牌名称(例如 my-first-key),点击确认
  5. 复制生成的 API Key(以 sk- 开头)
安全提醒: API Key 只会在创建时完整显示一次,请立即复制并妥善保存。切勿将 Key 硬编码到前端代码或公开仓库中。

3. 设置 Base URL

WLON API 完全兼容 OpenAI 格式,你只需将 base_url 指向我们的服务即可:

https://api2everything.xyz/v1

如果你之前使用的是 OpenAI 官方 API,只需要修改两处:

参数OpenAI 官方WLON API
base_urlhttps://api.openai.com/v1https://api2everything.xyz/v1
api_keysk-xxx(OpenAI Key)sk-xxx(WLON Key)
兼容性: 所有支持自定义 base_url 的 OpenAI SDK 和第三方工具(如 Cursor、LobeChat、Dify 等)均可直接接入,无需额外适配。

4. 发起第一次调用

下面分别展示 Python 和 cURL 两种方式调用 gpt-4o 模型。

Python(OpenAI SDK)

首先安装 OpenAI Python SDK:

pip install openai

然后运行以下代码:

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",           # 替换为你在控制台创建的 Key
    base_url="https://api2everything.xyz/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "你是一个友好的助手。"},
        {"role": "user", "content": "用一句话介绍你自己。"}
    ]
)

print(response.choices[0].message.content)
推荐做法: 将 API Key 存储在环境变量中,避免硬编码:
export OPENAI_API_KEY="sk-你的密钥"
然后代码中使用 OpenAI(base_url="https://api2everything.xyz/v1") 即可,SDK 会自动读取环境变量。

cURL

curl https://api2everything.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "你是一个友好的助手。"},
      {"role": "user", "content": "用一句话介绍你自己。"}
    ]
  }'

成功调用后,你会收到类似以下的 JSON 响应:

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好!我是一个 AI 助手,随时准备回答你的问题、提供帮助。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 22,
    "completion_tokens": 18,
    "total_tokens": 40
  }
}

5. 验证成功

如何确认调用已成功:

常见错误排查:
401 Unauthorized — API Key 不正确或已过期,请检查 Key 是否完整复制
429 Too Many Requests — 请求频率过高,请稍后重试
400 Bad Request — 请求格式有误,检查 JSON 是否合法、model 名称是否正确

6. 下一步

恭喜!你已经成功完成了第一次 API 调用。接下来可以探索更多功能:

方向文档说明
探索模型模型列表查看 300+ 可用模型及定价,包括 GPT-4o、Claude 4、Gemini 2.5 等
流式输出流式输出使用 SSE 流式响应,实现打字机效果的实时输出
函数调用函数调用让模型调用你定义的函数,构建 Agent 和工具链
图片识别图片识别使用 Vision 模型分析和理解图片内容
第三方接入第三方平台接入在 Cursor、LobeChat、Dify、n8n 等平台中使用 WLON API
计费详情计费说明了解计费方式、充值方法和倍率说明
需要帮助? 如有任何问题,可通过 [email protected] 或控制台内工单联系我们。