Tencent: Hy4 preview
Tencent Hy4 preview是文字模型，公開上下文為1,048,576個詞元。透過Chat Completions選擇tencent/hy4-preview，可處理提供文字，包含文件綜整、結構化擷取與程式碼討論。其宣告控制項涵蓋推理、結構化回應與函式工具工作流程，並提供完整JSON或串流回應傳送。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
Tencent Hy4 preview是以tencent/hy4-preview選擇的明確具名預覽版本。它透過Chat Completions接受文字並產生文字，公開上下文長度為1,048,576個詞元。準備長篇資料時，請使用穩定文件標籤、章節邊界與精確問題，讓請求同時說明應使用的證據，以及應用程式所需結果。
請使用POST /v1/chat/completions，將model設為tencent/hy4-preview，並提供非空messages陣列。將實際文字放在訊息content。文件綜整請求可納入已標示報告，並要求共同發現、分歧與佐證段落。資訊擷取請求可指定欄位，並定義如何呈現缺少的資訊。程式碼討論可將相關檔案或節錄以文字提供，並要求聚焦說明或編輯建議。
請在所述上下文範圍內規劃指示、文件、對話歷程與要求的回覆。將來源標籤放在對應文字旁，並說明文件衝突時，回答應以哪些文件為準。進行大型比較時，請在來源資料前定義標準，並要求依這些標準組織結果。這能讓應用程式取得可對照輸入檢查的特定輸出，不必依賴「摘要所有內容」的籠統指示。
公開參數集包含reasoning、reasoning_effort與include_reasoning，以及temperature、stop、max_tokens與max_completion_tokens。若需要明確回應形式，請使用response_format與應用程式預期的結構描述；此規格宣告支援結構化輸出。函式工具互動則提供tools與tool_choice。請提供您應用程式使用的結構描述或函式定義，將所選參數值連同請求保留，並在繼續前驗證實際回傳欄位或工具引數。
選用的stream控制項支援組合完成的JSON傳送或串流回覆。使用JSON時，請保留每個回傳的選項、訊息內容、工具呼叫、推理欄位與usage欄位。使用串流時，請依選項與工具呼叫索引合併增量內容，並保留最終完成資訊。回傳工具呼叫時，請保留其實際識別碼與引數，讓應用程式能將結果工具訊息對應至該呼叫。若對話在中斷後需要調查，請保留原始請求識別資訊與完整回應。
Ailoot Ultra · Chat Completions POST /v1/chat/completions tencent/hy4-preview
tencent/hy4-preview入門
Tencent Hy4 preview是文字模型，公開上下文為1,048,576個詞元。透過Chat Completions選擇tencent/hy4-preview，可處理提供文字，包含文件綜整、結構化擷取與程式碼討論。其宣告控制項涵蓋推理、結構化回應與函式工具工作流程，並提供完整JSON或串流回應傳送。
- 接受的輸入
- 文字
- 結果
- 文字
Ailoot 可用 · 輸入與方法
Ailoot Ultra · Chat Completions POST /v1/chat/completions
- 輸入
text- 輸出
text- 上下文
- 1,048,576 tokens
- 輸出格式
- JSON or supported SSE
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 tencent/hy4-preview | 預設值— |
欄位messages | 類型array | 要求必填 | 值與限制 | 預設值— |
欄位stream | 類型boolean | 要求選填 | 值與限制 | 預設值false |
欄位max_tokens | 類型integer | 要求選填 | 值與限制 最小值: 1 | 預設值— |
欄位max_completion_tokens | 類型integer | 要求選填 | 值與限制 最小值: 1 | 預設值— |
欄位n | 類型integer | 要求選填 | 值與限制 最小值: 1 | 預設值— |
欄位temperature | 類型number | 要求選填 | 值與限制 | 預設值— |
欄位top_p | 類型number | 要求選填 | 值與限制 | 預設值— |
欄位seed | 類型integer | 要求選填 | 值與限制 | 預設值— |
欄位stop | 類型 | 要求選填 | 值與限制 | 預設值— |
欄位frequency_penalty | 類型number | 要求選填 | 值與限制 | 預設值— |
欄位presence_penalty | 類型number | 要求選填 | 值與限制 | 預設值— |
欄位user | 類型string | 要求選填 | 值與限制 | 預設值— |
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, messages |
參數optional | 規格stream, max_tokens, max_completion_tokens, n, temperature, top_p, seed, stop, frequency_penalty, presence_penalty, user |
參數material_types | 規格text |
參數conditions | 規格 |
生命週期： synchronous_json_or_sse
方案
費率資訊不會增加請求選項。支援的參數列於所選方法中。
- 快速模式
- 未指定 選取快速模式時
- flex 模式
- 未指定 選取 flex 模式時
- Time schedule
- {"periods":[{"end_time":"00:00","multiplier":"0.9","start_time":"16:00"}],"timezone":"UTC","weekdays_only":false} At the request pricing time
Ailoot 費率
各設定的價格
| 設定 | 費率表 | 費用 |
|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 費用 輸入 · 輸入 Token $0.001668 / 1K Token 輸出 · 輸出 Token $0.005002 / 1K Token 輸入 · 讀取快取 $0.000084 / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取，1 小時 — / 1K Token |
Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
請求範例
Ailoot Ultra · Chat Completions
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "tencent/hy4-preview", "messages": [{"role": "user", "content": "Summarize the supplied text in three concise points."}], "stream": false}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
接收並儲存結果
Ailoot Ultra · Chat Completions
JSON or supported SSE
保留所有已完成的結果
請保留所有完整傳回的回應、檔案與內容區塊。
Retain the complete response, all actual results, original identifiers, usage and response headers.
需要檢查原始回應時
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
別名
模型別名
Ailoot Ultra tencent/hy4-preview
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Tencent: Hy4 preview
- 可以使用哪些輸入與結果？
POST /v1/chat/completions·tencent/hy4-preview:text→text- 請求使用哪些欄位？
POST /v1/chat/completions·tencent/hy4-preview:model,messages,stream,max_tokens,max_completion_tokens,n,temperature,top_p,seed,stop,frequency_penalty,presence_penalty,user- 適用哪些限制？
POST /v1/chat/completions·tencent/hy4-preview:ctx:1048576;max_tokens.minimum:1;max_completion_tokens.minimum:1;n.minimum:1