Hy โ
Endpoint: https://mmu.vod-qcloud.com/v1Authentication: VOD ApiToken / Bearer
Hy๏ผ่
พ่ฎฏๆททๅ
๏ผ is a text generation / chat model called through an OpenAI-compatible API, with JSON and SSE streaming responses. It supports the Chat Completions, Responses, and Messages protocols, with versions such as hy3 and hy4-preview.
Basic Information โ
| Item | Value |
|---|---|
| Call endpoint | https://mmu.vod-qcloud.com |
| Authentication | VOD Application-issued ApiToken / Bearer |
| Output | Text / Structured response |
| Response mode | JSON / SSE |
Supported Protocols โ
| Spec | Path | Target |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | All models below |
| Responses | POST /v1/responses | All models below |
| Messages | POST /v1/messages | All models below |
The model IDs below use the corresponding spec. Authentication and common fields follow API Reference.
Sampling Options โ
Commonly applies to all models listed in this document.
| Parameter | Setting |
|---|---|
temperature | Configurable |
top_p | Configurable |
temperature specifies the sampling temperature, and top_p specifies the cumulative probability range. Adjust centered on one method.
Per-Version Reasoning Settings โ
| Model ID | Configuration | Disable |
|---|---|---|
hy4-preview | thinking_enabled | Cannot be disabled |
hy3 | thinking_enabled | Cannot be disabled |
Based on Chat Completions. Reasoning content is read from reasoning_content, and the final answer from content. Do not pass a disable option to versions that cannot be disabled.
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
model | Required | String | A model ID from the per-version options table |
messages | Required | Array | Conversation input for Chat Completions / Messages |
input | Required | String / Array | Input for Responses. Used instead of messages |
max_tokens | Optional | Integer | Generation limit for Chat Completions / Messages. Required in Messages |
max_output_tokens | Optional | Integer | Generation limit for Responses |
stream | Optional | Boolean | true: SSE / false: JSON |
Request Examples โ
Chat Completions โ
{
"model": "hy4-preview",
"messages": [
{
"role": "user",
"content": "Reply with exactly OK and nothing else."
}
],
"max_tokens": 512,
"stream": false
}Response โ
{
"id": "01a0de31-7e55-7dee-b6b5-2f5fb1918137",
"object": "chat.completion",
"model": "hy4-preview",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "OK",
"reasoning_content": "We need respond with exactly \"OK\" and nothing else. The user explicitly asks: \"Reply with exactly OK and nothing else.\" So final answer must be just OK, no extra characters, no punctuation? Exactly OK means two letters O and K. Ensure no newline? Usually can include newline? It says exactly OK and nothing else. Best final content: OK. Could be no trailing spaces. In chat, message body might have newline? To be safe, output just OK. No quotes. No markdown. Final: OK."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 29,
"prompt_tokens_details": {
"audio_tokens": 0,
"cached_tokens": 0
},
"prompt_cached_tokens_details": {
"audio_tokens": 0
},
"completion_tokens": 109,
"completion_tokens_details": {
"accepted_prediction_tokens": 0,
"audio_tokens": 0,
"reasoning_tokens": 106,
"rejected_prediction_tokens": 0
},
"total_tokens": 138
}
}Responses โ
{
"model": "hy4-preview",
"input": "Reply with exactly OK and nothing else.",
"max_output_tokens": 512,
"stream": false
}Response โ
{
"id": "resp_a1c2722b42b84978bc7754f88a7d45a5",
"object": "response",
"model": "hy4-preview",
"status": "completed",
"output": [
{
"type": "reasoning",
"id": "rs_20260926225757nn1pd1f3",
"status": "completed",
"summary": [
{
"type": "summary_text",
"text": "We need respond exactly \"OK\" and nothing else. The user says: \"Reply with exactly OK and nothing else.\" So output only OK. No extra spaces? They said exactly OK and nothing else. Should we include newline? Usually just \"OK\". Could be trailing newline maybe okay? To be safe, output \"OK\" without newline? In chat, assistant message content likely \"OK\". We can just output OK. No reasoning."
}
]
},
{
"type": "message",
"id": "msg_20260926225757l9n1p3r5",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "OK"
}
]
}
],
"usage": {
"input_tokens": 29,
"output_tokens": 91,
"total_tokens": 120,
"output_tokens_details": {
"reasoning_tokens": 88
}
}
}Messages โ
{
"model": "hy4-preview",
"messages": [
{
"role": "user",
"content": "Reply with exactly OK and nothing else."
}
],
"max_tokens": 512,
"stream": false
}Response โ
{
"id": "01a0de34-91da-79f1-8dad-cdbedf2cd19f",
"model": "hy4-preview",
"type": "message",
"role": "assistant",
"content": [
{
"text": "OK",
"type": "text"
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 29,
"output_tokens": 111
}
}Special Settings โ
Pass text conversation and code input in messages. hy3 and hy4-preview are different model IDs. If the response includes reasoning_content, handle it separately from the final content.