ChatAlibaba / Qwen主推模型1 家上游

Qianwen3.8Max

通义千问 Qianwen3.8Max，面向中文理解、复杂推理、代码和企业 Agent 工作流的主推模型。

在 gpt88.cc 获取 API Key 快速开始

模型概览

Qianwen3.8Max 是 GPT88 文档站新增的通义千问主推模型，标准 Model ID 为 qwen3.8-max-preview；如果 GPT88 控制台提供平台别名，应以 GET /v1/models 返回为准。
它适合中文优先的复杂任务，也可以用于代码生成、知识整理、结构化输出和多步骤 Agent 工作流。

适用场景

中文客服、企业助手、知识库问答和内容生成
需要代码理解、代码生成或结构化输出的开发任务
需要结合工具调用、函数调用和多轮规划的 Agent 工作流
希望在 Qwen 路线中评测高能力模型时

接入说明

OpenAI 兼容工具使用 https://api.gpt88.cc，并把请求体 model 设置为 qwen3.8-max-preview。
首次接入建议先调用 GET /v1/models，再发送最小 POST /v1/chat/completions 请求确认当前 API Key 权限。
可使用现有 OpenAI SDK、cURL、ChatBox、Cursor、Claude Code 或 Codex 等兼容工具接入，具体协议按客户端要求配置。

使用提醒

可用线路、价格、上下文长度、限速、工具能力和账号权限以 GPT88 控制台当前配置为准。
优先使用标准模型 ID qwen3.8-max-preview；如果 /v1/models 未返回该模型，应先检查账号权限、线路或 GPT88 是否提供平台别名。
正式上线前请使用中文业务样本、代码样本和工具调用样本进行小流量评测。

能力标签

中文理解复杂推理代码生成Function Calling

接口路径

POSThttps://api.gpt88.cc/v1/chat/completions

该路径由模型分类决定：Chat / Image / Video / Audio 使用不同 endpoint，同一分类内通常只需要替换 model 字段。

请求需在 Header 中携带 Authorization: Bearer <API_KEY>。完整字段说明见 Chat Completions API 。

API 文档

Endpoint

POST /v1/chat/completions

Model ID

qwen3.8-max-preview

Content-Type

application/json

接口类型

OpenAI 兼容对话补全接口，支持非流式和流式输出

Base URL

OpenAI 兼容工具和 Claude 风格工具统一使用 https://api.gpt88.cc。

Headers / 鉴权

字段	类型	必填	说明
`Authorization`	string	必填	使用 `Bearer <GPT88_API_KEY>`。API Key 在 gpt88.cc 控制台创建。
`Content-Type`	string	必填	请求体格式。音频转写上传文件时使用 `multipart/form-data`。默认值：`application/json`
`Accept`	string	可选	非流式接口返回 JSON；Chat 流式请求会返回 SSE 数据流。默认值：`application/json 或 text/event-stream`

Authorizationstring必填
使用 Bearer <GPT88_API_KEY>。API Key 在 gpt88.cc 控制台创建。
Content-Typestring必填
请求体格式。音频转写上传文件时使用 multipart/form-data。
默认值：application/json
Acceptstring
非流式接口返回 JSON；Chat 流式请求会返回 SSE 数据流。
默认值：application/json 或 text/event-stream

Chat 协议差异

Chat 模型不只看模型名，还要看你使用的客户端协议。Claude Code / Anthropic SDK 和 OpenAI SDK 拼出来的路径不同。

OpenAI 兼容推荐

Base URL: https://api.gpt88.cc
Endpoint: POST /v1/chat/completions
Body: { "model": "qwen3.8-max-preview", "messages": [...] }

Anthropic / Claude

Base URL: https://api.gpt88.cc
Endpoint: POST /v1/messages
Body: { "model": "qwen3.8-max-preview", "messages": [...] }

这个模型更适合优先走 OpenAI 兼容协议；只有当目标工具明确支持 Claude 风格接入时，才使用 Anthropic 路径。

请求参数

以下字段按当前模型分类生成。价格、上下文长度、限速、可用线路等动态信息以 gpt88.cc 控制台为准。

字段	类型	必填	说明
`model`	string	必填	当前模型 ID：`qwen3.8-max-preview`。复制时请保持大小写一致。
`messages`	array<Message>	必填	多轮对话历史。每条消息包含 `role` 和 `content`。
`stream`	boolean	可选	是否使用 SSE 流式返回。适合聊天界面和长回答。默认值：`false`
`temperature`	number	可选	采样温度，值越高越发散。正式业务建议先固定后再调优。默认值：`1`
`max_tokens`	integer	可选	本次生成的最大 token 数。模型上下文边界以控制台为准。
`response_format`	object	可选	结构化输出配置，例如 `{ "type": "json_object" }`。
`tools`	array<Tool>	可选	Function calling 工具定义。是否支持取决于具体模型和账号配置。

modelstring必填
当前模型 ID：qwen3.8-max-preview。复制时请保持大小写一致。
messagesarray<Message>必填
多轮对话历史。每条消息包含 role 和 content。
streamboolean
是否使用 SSE 流式返回。适合聊天界面和长回答。
默认值：false
temperaturenumber
采样温度，值越高越发散。正式业务建议先固定后再调优。
默认值：1
max_tokensinteger
本次生成的最大 token 数。模型上下文边界以控制台为准。
response_formatobject
结构化输出配置，例如 { "type": "json_object" }。
toolsarray<Tool>
Function calling 工具定义。是否支持取决于具体模型和账号配置。

响应字段

响应结构保持 OpenAI 兼容风格；媒体类模型可能返回异步任务 ID 或资源 URL。

字段	类型	必填	说明
`id`	string	必填	本次补全的唯一 ID，便于排障关联日志。
`object`	string	必填	固定为 `chat.completion` 或流式 chunk 类型。
`model`	string	必填	实际承担推理的模型 ID。
`choices`	array<Choice>	必填	生成结果数组，包含 `message`、`delta` 或 `finish_reason`。
`usage`	object	可选	Token 用量统计。流式请求可能在结束包或非流式响应中返回。

idstring必填
本次补全的唯一 ID，便于排障关联日志。
objectstring必填
固定为 chat.completion 或流式 chunk 类型。
modelstring必填
实际承担推理的模型 ID。
choicesarray<Choice>必填
生成结果数组，包含 message、delta 或 finish_reason。
usageobject
Token 用量统计。流式请求可能在结束包或非流式响应中返回。

状态码

字段	类型	必填	说明
`200`	OK	必填	请求成功，响应体结构见上方响应字段。
`400`	Bad Request	可选	请求字段不合法，例如缺少必填字段、图片尺寸格式错误或文件格式不支持。
`401`	Unauthorized	可选	API Key 缺失、无效或格式错误。
`404`	Not Found	可选	Endpoint 或模型不存在。请确认路径为 `/v1/chat/completions`，模型 ID 为 `qwen3.8-max-preview`。
`429`	Rate Limited	可选	触发限速、并发限制或余额不足。控制台会展示当前账号可用额度。
`5xx`	Upstream Error	可选	上游或请求异常。保持统一 Base URL 重试，并保留请求 ID 便于排查。

200OK必填
请求成功，响应体结构见上方响应字段。
400Bad Request
请求字段不合法，例如缺少必填字段、图片尺寸格式错误或文件格式不支持。
401Unauthorized
API Key 缺失、无效或格式错误。
404Not Found
Endpoint 或模型不存在。请确认路径为 /v1/chat/completions，模型 ID 为 qwen3.8-max-preview。
429Rate Limited
触发限速、并发限制或余额不足。控制台会展示当前账号可用额度。
5xxUpstream Error
上游或请求异常。保持统一 Base URL 重试，并保留请求 ID 便于排查。

错误与排查

401：检查 Authorization 是否为 Bearer <API_KEY>，以及 Key 是否仍有效。
404：检查 endpoint 是否为 /v1/chat/completions，以及模型名 qwen3.8-max-preview 是否在控制台可见。
429：触发限速或余额不足时，降低并发、缩短请求，或到控制台查看额度。
5xx：保持统一 Base URL 重试，并记录请求 ID 方便排障。

请求示例

curl https://api.gpt88.cc/v1/chat/completions \
  -H "Authorization: Bearer $GPT88_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.8-max-preview",
    "messages": [
      {"role": "user", "content": "用一句话介绍 gpt88.cc"}
    ]
  }'

期望响应（精简示例）：

200 OKjson

{
  "id": "chatcmpl-qwen3-8-",
  "object": "chat.completion",
  "created": 1730000000,
  "model": "qwen3.8-max-preview",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": { "role": "assistant", "content": "..." }
    }
  ],
  "usage": { "prompt_tokens": 24, "completion_tokens": 64, "total_tokens": 88 }
}

可选分析设置