文本模型进阶用户更新于
POST/v1/chat/completions
Hunyuan Hy4 Preview
请求 ID hy4-preview
协议
POST /v1/chat/completions· Chat Completions示例POST /v1/messages· Anthropic Messages示例POST /v1/responses· OpenAI Responses示例
认证
请求需要 API Key。在控制台的 API Key 管理 获取密钥。发送 JSON 请求时，设置 Content-Type: application/json。
Authorization: Bearer YOUR_API_KEY- Anthropic Messages ·
x-api-key: YOUR_API_KEY
请求参数
POST /v1/chat/completions
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
model | string | 必填 | 填写模型 ID hy4-preview。 |
messages | object[] | 必填 | 按会话顺序发送消息。每条消息包含 role 和 content。 |
messages[].content | string / object[] | 视条件 | 消息正文。可用纯文本或协议定义的内容块数组。 |
stream | boolean | 选填 | true 请求 SSE 流式响应，false 请求普通 JSON。以所选接入点支持的模式为准。 |
max_completion_tokens | integer | 视条件 | 限制生成 token 数，包含模型适用的推理 token。仅在所选接入点支持此字段时使用。 |
max_tokens | integer | 视条件 | 兼容字段，限制输出 token 数。按所选接入点的要求，在此字段与 max_completion_tokens 中选一个。 |
temperature | number | 视条件 | 控制采样随机性。可用取值以及该字段是否生效，取决于模型和接入点。 |
top_p | number | 视条件 | 按累计概率限制采样候选。仅在所选模型和接入点支持时使用。 |
response_format | object | 视条件 | 请求结构化输出时可设 type: json_object，或在支持 JSON Schema 时设 type: json_schema 并提供 json_schema。 |
POST /v1/messages
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
model | string | 必填 | 填写模型 ID hy4-preview。 |
messages | object[] | 必填 | 按会话顺序发送 user 和 assistant 消息。系统指令放在顶层 system。 |
messages[].content | string / object[] | 必填 | 消息正文。可用纯文本或协议定义的内容块数组。 |
system | string / object[] | 选填 | 系统指令。可用文本或文本块数组。 |
max_tokens | integer | 必填 | 输出 token 的上限。可用上限因模型和接入点而异。 |
stream | boolean | 选填 | true 请求 SSE 流式响应，false 请求普通 JSON。以所选接入点支持的模式为准。 |
temperature | number | 视条件 | 控制采样随机性。可用取值以及该字段是否生效，取决于模型和接入点。 |
top_p | number | 视条件 | 按累计概率限制采样候选。仅在所选模型和接入点支持时使用。 |
POST /v1/responses
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
model | string | 必填 | 填写模型 ID hy4-preview。 |
input | string / object[] | 必填 | 输入文本，或按顺序排列的输入项数组。消息项使用 role 和 content。 |
instructions | string | 选填 | 模型应遵循的指令，用于设定任务和输出要求。 |
max_output_tokens | integer | 选填 | 输出 token 的上限。可用上限因模型和接入点而异。 |
stream | boolean | 选填 | true 请求 SSE 流式响应，false 请求普通 JSON。以所选接入点支持的模式为准。 |
store | boolean | 视条件 | 支持此字段时，false 请求不保留此响应以供后续检索。 |
text.format | object | 视条件 | 结构化输出使用 text.format，例如 type: json_schema。只在所选接入点支持该格式时使用。 |
temperature | number | 视条件 | 控制采样随机性。可用取值以及该字段是否生效，取决于模型和接入点。 |
top_p | number | 视条件 | 按累计概率限制采样候选。仅在所选模型和接入点支持时使用。 |
请求示例
先将 API Key 设置为本机环境变量 ICODEEASY_API_KEY，并选择支持直接 HTTP 调用的接入点。接入点要求特定客户端时，按对应客户端指南配置。
Chat Completions
bash
curl -sS 'https://api.icodeeasy.cc/v1/chat/completions' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "hy4-preview",
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
],
"stream": false
}'
Anthropic Messages
bash
curl -sS 'https://api.icodeeasy.cc/v1/messages' \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "hy4-preview",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
]
}'
OpenAI Responses
bash
curl -N -sS 'https://api.icodeeasy.cc/v1/responses' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "hy4-preview",
"instructions": "You are a helpful assistant.",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Explain how a rainbow forms in one sentence."
}
]
}
],
"stream": true,
"store": false
}'
读取响应
- Chat Completions · 从
choices[].message.content读取文本。流式响应通过 SSE 的choices[].delta返回增量。 JSON · SSE - Anthropic Messages · 从
content[]中读取类型为text的块。流式响应按顺序处理 SSE 内容块事件。 JSON · SSE - OpenAI Responses · 流式响应中，从
response.output_text.delta事件的delta字段拼接文本，并处理完成与失败事件。 SSE