优易接 API 接入方法

一、接入前准备

在使用优易接 API 前，请先完成以下准备：

1. 注册并登录优易接 API 平台账号。
2. 进入控制台，创建或获取你的 API Key。
3. 确认账户余额充足。
4. 选择你需要调用的模型名称。

二、接口地址

优易接 API 采用 OpenAI 兼容格式，基础接口地址如下：

https://vercel.yyjapi.com/v1

常用聊天补全接口：

https://vercel.yyjapi.com/v1/chat/completions

如果你的软件支持填写自定义 API 地址，一般填写：

https://vercel.yyjapi.com/v1

三、请求头配置

调用接口时，需要在请求头中携带你的 API Key：

Authorization: Bearer 你的API_KEY
Content-Type: application/json

四、Curl 调用示例

你可以使用以下命令测试接口是否正常：

curl https://vercel.yyjapi.com/v1/chat/completions \
  -H "Authorization: Bearer 你的API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "你好，介绍一下优易接 API"
      }
    ]
  }'

五、Python 接入示例

如果你使用 Python，可以通过 OpenAI SDK 快速接入：

from openai import OpenAI

client = OpenAI(
    api_key="你的API_KEY",
    base_url="https://vercel.yyjapi.com/v1"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {
            "role": "user",
            "content": "你好，介绍一下优易接 API"
        }
    ]
)

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

六、JavaScript 接入示例

Node.js 项目可以这样接入：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "你的API_KEY",
  baseURL: "https://vercel.yyjapi.com/v1"
});

const response = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [
    {
      role: "user",
      content: "你好，介绍一下优易接 API"
    }
  ]
});

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

七、常见软件配置方式

八、常见问题

1. 提示 401 Unauthorized 怎么办？

一般是 API Key 错误、Key 没有填写、格式不正确，或者账户余额不足。 请检查请求头是否为：

Authorization: Bearer 你的API_KEY

2. 提示 404 怎么办？

请检查 Base URL 是否填写正确。推荐填写：

https://vercel.yyjapi.com/v1

3. 提示模型不存在怎么办？

请确认你填写的模型名称是否在优易接 API 平台支持列表中， 模型名需要完全一致。

4. 是否兼容 OpenAI SDK？

是的。优易接 API 采用 OpenAI 兼容格式， 大部分支持自定义 Base URL 的项目都可以快速接入。

5. 能不能用于 Claude Code、Cherry Studio、ChatBox 等工具？

可以。只要软件支持填写自定义 API 地址和 API Key， 一般都可以使用优易接 API 进行接入。

九、推荐接入流程

1. 注册优易接 API 账号。
2. 进入控制台获取 API Key。
3. 在你的软件或代码中填写 Base URL。
4. 选择需要调用的模型。
5. 发送测试请求，确认返回正常。
6. 正式接入你的项目。