快速接入

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

(1) 登陆网站后，在控制台获取并更改你的 API key

(2) 更改你的接⼝地址

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

千言万译接口

翻译场景优化接口
大模型通用接口

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

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

2.接⼝描述

本接口对大模型原生能力进行了翻译场景专项优化，聚焦“只做翻译、翻得稳定”，有效解决大模型可能出现的不翻译或翻译偏差问题；同时简化了接口参数设计，返回结果与官方接口保持一致，降低接入成本。

3.请求参数说明

● Header参数
名称 类型 必填 描述
Content-Type string 是 固定值 application/json
Authorization string 是 "Bearer " + Apikey
● Body 参数(application/json)
参数名 类型 必填 说明
content string 是 待翻译的文本内容
source string 否 源语言代码
target string 是 目标语言代码
modelType string 是 模型名称，如：gpt-4o-mini

目前已支持模型如下：

    gpt-4o-mini

    gpt-4.1

    gpt-5.1

    gpt-5-mini

    gemini-2.0-flash

    gemini-2.5-flash

    gemini-3-pro-preview

    DeepSeek-v3

    claude-sonnet-4-5-20250929

4.请求参数示例

              
{
    "modelType": "gpt-4.1",
    "content": "你好",
    "source": "中文",
    "target": "英文"
}

5.请求示例

● curl请求示例
              
curl --location -g --request POST 'https://qywyai.com/thousand/openai/v1/chat/translate' \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
    "modelType": "gpt-4.1",
    "content": "你好",
    "source": "中文",
    "target": "英文"
}'

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

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

2.接⼝描述

本接口用于调用AI大模型，调用能力与官方保持一致，未作任何限制或删减，用户可自由调用全部能力。

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

    gpt-5.1

    gpt-5-mini

    gemini-2.0-flash

    gemini-2.5-flash

    gemini-3-pro-preview

    DeepSeek-v3

    claude-sonnet-4-5-20250929

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-4o-mini",
    "max_tokens": 10000,
    "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-4o-mini"
}'

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密钥是否正确。