快速接入

1.千⾔万译 的 API 使⽤与 OpenAI 兼容的 API 格式

(1) ⾸先获取并更改你的 Apikey

(2) 更改你的接⼝地址

  • 原来：https://api.openai.com
  • 现在改为：https://qywyai.com/thousand/openai

千言万译接口

1.接⼝地址 （请求⽅式：POST）

https://qywyai.com/thousand/openai/v1/chat/completions

2.接⼝描述

该接⼝⽤于调⽤⼤模型进⾏⽂本对话

3.请求参数说明

● Header参数
名称 类型 必填 描述
Content-Type String 是 固定值 application/json
Authorization String 是 "Bearer " + Apikey
● Body 参数(application/json)
参数名 类型 必填 说明
model string 是 模型名称，如：gpt-4o-mini

目前已支持模型如下：

    gpt-4o-mini

    gpt-4.1

    gemini-2.0-flash
stream boolean 否 是否开启流式响应，默认 false
top_p number 否 控制输出的多样性，值越大越随机，取值 0～1，默认 1.0，通常建议改这个或 temperature 但不是两者。
max_tokens integer 否 回复的最大 token 数，默认 4096
temperature number 否 控制输出的多样性，值越大越随机，默认 1.0
messages array 是 对话历史记录，数组中每项是一个消息对象
- 消息对象结构（ messages 中的每⼀项）：
字段名 类型 必填 说明
role string 是 消息的角色
content string 是 消息的内容

4.请求参数示例

              
{
  "model": "gpt-4.1",
  "stream": false,
  "top_p": 1.0,
  "max_tokens": 4096,
  "temperature": 1.0,
  "messages": [
    {
      role: "system",
      content: "你是⼀个智能助⼿",
    },
    {
      role: "user",
      content: "你好",
    },
  ],
}

5.请求示例

● shell请求示例
              
curl --location -g --request POST 'https://qywyai.com/thousand/openai/v1/chat/
completions' \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
  "messages": [
    {
      "role": "system",
      "content": "你是⼀个智能助⼿"
    },
    {
      "role": "user",
      "content": "你好"
    }
  ],
  "model":"gpt-4.1"
}

6.响应参数说明

字段名 类型 说明
id string 本次响应的唯⼀标识符
object string 响应的对象类型，如 chat.completion
created integer 响应创建的时间戳
model string 使⽤的模型版本
choices array 回复内容数组，通常只包含⼀个对象
usage object token 使⽤情况
prompt_filter_results array 内容安全过滤结果
- choices[i] ⼦字段：
字段名 类型 说明
index int 回复索引
finish_reason string 回复结束原因，如 stop
message object 回复消息，包含 role 和 content 字段

7.响应示例

              
{
  "id": "chatcmpl-BmruA5HnQInUxXs56iCHs2zmhnAFs",
  "object": "chat.completion",
  "created": 1750986654,
  "model": "gpt-4.1-2025-04-14",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "Hello."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 69,
    "completion_tokens": 3,
    "total_tokens": 72
  }
}

8.错误码

您在调⽤本 API 时，可能会遇到以下错误。这⾥列出了相关错误的原因及其解决⽅法。
错误码 描述
401 Unauthorized API密钥验证未通过。你需要验证你的API密钥是否正确。
402 Payment Required 账号余额不⾜，请确认账户余额
429 Too Many Requests 请求频率超限，请联系客服⼈员
500 Internal Server Error 服务器内部故障，请等待后重试。
503 Service Unavailable 服务器负载过⾼，请稍后重试您的请求

余额查询接⼝

1.接⼝地址 （请求⽅式：GET）

https://qywyai.com/thousand/openai/v1/chat/balance

2.请求参数示例

● Header参数
名称 类型 必填 描述
Authorization String 是 "Bearer " + Apikey

3.请求示例

● shell请求示例
              
curl --location --request GET 'https://qywyai.com/thousand/openai/v1/chat/balance' \
--header "Authorization: Bearer $API_KEY"

4.响应参数说明

字段名 类型 说明
balance BigDecimal 余额，单位（元）

5.响应示例

              
{
  "msg": "查询成功",
  "code": 200,
  "data": {
    "balance": 0.94
  }
}

6.错误码

您在调⽤本 API 时，可能会遇到以下错误。这⾥列出了相关错误的原因及其解决⽅法。
错误码 描述
401 Unauthorized API密钥验证未通过。你需要验证你的API密钥是否正确。

按时间查询消费⾦额接⼝

1.接⼝地址 （请求⽅式：GET）

https://qywyai.com/thousand/openai/v1/chat/totalCost?startTime=${startTime}&endTime=${endTime}

2.请求参数示例

● Header参数
名称 类型 必填 描述
Authorization String 是 "Bearer " + Apikey
● Params参数
名称 类型 必填 描述
startTime String 否 起始时间 （yyyy-MM-dd）
endTime String 否 结束时间 （yyyy-MM-dd）

3.请求示例

● shell请求示例
              
curl --location --request GET 'https://qywyai.com/thousand/openai/v1/chat/totalCost?startTime=2025-06-17&endTime=2025-07-06' \
--header "Authorization: Bearer $API_KEY"

4.响应参数说明

字段名 类型 说明
totalCost BigDecimal 消费⾦额，单位（元）
totalTokens Long 消费token数

5.响应示例

              
{
  "msg": "查询成功",
  "code": 200,
  "data": {
    "startTime": "2025-06-17",
    "endTime": "2025-07-06",
    "totalTokens": 897,
    "totalCost": 0.00111942
  }
}

6.错误码

您在调⽤本 API 时，可能会遇到以下错误。这⾥列出了相关错误的原因及其解决⽅法。
错误码 描述
401 Unauthorized API密钥验证未通过。你需要验证你的API密钥是否正确。