Skip to content

Hy โ€‹

Updated

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 โ€‹

ItemValue
Call endpointhttps://mmu.vod-qcloud.com
AuthenticationVOD Application-issued ApiToken / Bearer
OutputText / Structured response
Response modeJSON / SSE

Supported Protocols โ€‹

SpecPathTarget
Chat CompletionsPOST /v1/chat/completionsAll models below
ResponsesPOST /v1/responsesAll models below
MessagesPOST /v1/messagesAll 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.

ParameterSetting
temperatureConfigurable
top_pConfigurable

temperature specifies the sampling temperature, and top_p specifies the cumulative probability range. Adjust centered on one method.

Per-Version Reasoning Settings โ€‹

Model IDConfigurationDisable
hy4-previewthinking_enabledCannot be disabled
hy3thinking_enabledCannot 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 โ€‹

ParameterRequiredTypeDescription
modelRequiredStringA model ID from the per-version options table
messagesRequiredArrayConversation input for Chat Completions / Messages
inputRequiredString / ArrayInput for Responses. Used instead of messages
max_tokensOptionalIntegerGeneration limit for Chat Completions / Messages. Required in Messages
max_output_tokensOptionalIntegerGeneration limit for Responses
streamOptionalBooleantrue: SSE / false: JSON

Request Examples โ€‹

Chat Completions โ€‹

json
{
  "model": "hy4-preview",
  "messages": [
    {
      "role": "user",
      "content": "Reply with exactly OK and nothing else."
    }
  ],
  "max_tokens": 512,
  "stream": false
}

Response โ€‹

json
{
  "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 โ€‹

json
{
  "model": "hy4-preview",
  "input": "Reply with exactly OK and nothing else.",
  "max_output_tokens": 512,
  "stream": false
}

Response โ€‹

json
{
  "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 โ€‹

json
{
  "model": "hy4-preview",
  "messages": [
    {
      "role": "user",
      "content": "Reply with exactly OK and nothing else."
    }
  ],
  "max_tokens": 512,
  "stream": false
}

Response โ€‹

json
{
  "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.

Built with VitePress ยท Deployed on Tencent EdgeOne Pages