记录: OpenAI中转代理API接口服务的使用

由于OpenAI提供服务的地区列表里没有 China，因此想要方便使用OpenAI API的话就需要用到中转服务。

本文介绍的iDataRiver平台便提供这样的API，且比官方OpenAI还要便宜，其文档地址入口为 https://docs.idatariver.com/zh

支持模型

如何统计消费的token量

token 是大语言模型处理信息的最小单元，你可以在线计算token数量

通常 1 汉字介于1到2个token之间，具体请以实际消耗为准。

如何使用

开发者使用

开发者只需要以下两步即可快速使用：

1. 填入平台的API Key
2. 使用平台的中转接口地址: https://api.idatariver.com/api/openai/v1

接口用法与 OpenAI 官方 API 完全一致，示例如下：

Curl使用示例

curl https://api.idatariver.com/api/openai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $iDataRiver_API_KEY" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "Hello!"
      }
    ]
  }'

python使用示例

from openai import OpenAI

client = OpenAI(
  api_key='idr_******',
  base_url='https://cnapi.idatariver.com/api/openai/v1'
)

completion = client.chat.completions.create(
  model="gpt-3.5-turbo",
  messages=[
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello!"}
  ]
)

print(completion.choices[0].message)

nodejs使用示例

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: 'idr_****',
  baseURL: 'https://cnapi.idatariver.com/api/openai/v1',
});

async function main() {
  const completion = await openai.chat.completions.create({
    messages: [{ role: "system", content: "You are a helpful assistant." }],
    model: "gpt-3.5-turbo",
  });

  console.log(completion.choices[0]);
}

main();

更多用法可查阅 OpenAI官方API文档

第三方产品使用

如果你正在使用第三方产品如: ChatHub、OpenAI Translator、Lobe-Chat、ChatGPT Next Web或其它的应用与浏览器插件，仅需简单操作即可使用。

在应用或插件的OpenAI配置栏里填入下面两项：

1. 平台的API Key
2. 平台的中转接口地址: https://api.idatariver.com/api/openai/v1

API错误状态码

错误代码	代码解释
400	Bad Request 请求格式错误或不能被服务器理解。通常意味着客户端错误。
401	Unauthorized API密钥验证未通过。你需要验证你的API密钥是否正确。
403	Forbidden 一般是权限不足。
404	Not Found 请求的资源未找到。你可能正在尝试访问一个不存在的端点。
413	Request Entity Too Large 请求体太大。你可能需要减小你的请求体容量。
429	Too Many Requests 请求过于频繁。
500	Internal Server Error 服务器内部的错误。这可能是OpenAI服务器的问题，不是你的问题。
503	Service Unavailable 服务器暂时不可用。这可能是由于OpenAI正在进行维护或者服务器过载。

更多细节可查阅 OpenAI官方API错误码