POST/v1/messages

文本合成

https://platform.minimaxi.com/docs/api-reference/text-post

API Key application/json

MiniMax Messages 兼容协议

调用与返回说明

此页面是青云TOP 对 Messages/文本合成形状的兼容入口。消息字段和模型权限以本站实际返回为准，不能把它与 MiniMax 原生 TTS Body 混用。

请求时注意

请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
本站路径为 `/v1/messages`；若你的客户端使用 Anthropic SDK，请核对 base_url 和路径是否会重复追加 `/v1`。
messages[].content 在当前快照中为文本字符串；多模态块只有在本站模型和协议明确支持时才可发送。

返回时注意

HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
按兼容协议读取 choices[].message 或流式 delta；不要按 Responses API 的 output 数组读取。

Request

请求

/v1/messages

Body

必填

Bodyobject

modelstring必填

Messages 兼容模型 ID。

示例MODEL_ID_FROM_V1_MODELS

messagesarray<object>

元素object

rolestring必填

消息角色。

示例user

namestring

可选消息名称。

contentstring必填

消息文本。

示例请介绍一下 MiniMax。

streamboolean

是否流式返回。

示例false

max_completion_tokensinteger

最大生成 token 数。

temperaturenumber

采样温度。

top_pnumber

核采样参数。

stream_optionsobject

include_usageboolean

流式时是否包含用量块。

请求示例application/json

curl -X POST https://top.qingyuntop.ai/v1/messages \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{}'

Response

返回响应 `200`

成功响应

响应 200object

idstring

响应 ID。

choicesarray<object>

元素object

messageobject

contentstring

非流式文本结果。

deltaobject

contentstring

流式增量文本。

finish_reasonstring

完成原因。

modelstring

实际模型 ID。

usageobject

total_tokensinteger

总 token 用量。

base_respobject

status_codeinteger

兼容响应中的业务状态码（如有）。

响应示例application/json

{
  "id": "msg_example",
  "object": "chat.completion",
  "model": "MODEL_ID_FROM_V1_MODELS",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "total_tokens": 24
  }
}

MiniMax Messages 兼容协议

调用与返回说明

此页面是青云TOP 对 Messages/文本合成形状的兼容入口。消息字段和模型权限以本站实际返回为准，不能把它与 MiniMax 原生 TTS Body 混用。

请求时注意

请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
本站路径为 `/v1/messages`；若你的客户端使用 Anthropic SDK，请核对 base_url 和路径是否会重复追加 `/v1`。
messages[].content 在当前快照中为文本字符串；多模态块只有在本站模型和协议明确支持时才可发送。

返回时注意

HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
按兼容协议读取 choices[].message 或流式 delta；不要按 Responses API 的 output 数组读取。

流式事件示例

下面只展示事件形状。生产客户端应按事件类型处理增量、完成、失败和未完成事件，并设置读取超时。

data: {"choices":[{"delta":{"content":"你好"}}]}

data: [DONE]

文本合成

调用与返回说明

请求时注意

返回时注意

请求

Body

返回响应 200

调用与返回说明

请求时注意

返回时注意

流式事件示例

返回响应 `200`