Hy4正式版API接線三件事

Hy4正式版在2026年11月4日上線後,很多人第一反應是把model字段改成hy4。我建議先停一下。相對上一版Hy4 preview,公開宣傳確實多了視覺、電腦操作和長任務方向;但在https://api.crazyrouter.com/v1上,我今天(11月5日)能核實的,和還不能寫進生產理由的,要分開。

下面按接線順序寫:先通ID,再驗看圖,再堵住空正文。不是考卷流水賬,是我自己接正式版時的檢查單。目錄裏沒有hy4-preview,所以這份檢查單也不冒充「正式版 vs preview」並排跑分。時間範圍也釘死:只有11月5日這一天的調用,沒有更長觀察。

第一件事:Hy4正式版的model名怎麼填

本網關目錄裏目前只有hy4。OpenAI兼容調用裏,Base URL用https://api.crazyrouter.com/v1,model寫成hy4:

{
 "base_url": "https://api.crazyrouter.com/v1",
 "request_url": "https://api.crazyrouter.com/v1/chat/completions",
 "model": "hy4",
 "stream": false
}

密鑰走你賬號裏的Bearer。若你在編輯器裏接過別的型號,通常只改模型字段;可參考Cursor配置教程裏同一套base/key的寫法。我沒有固定溫度或推理強度,因此不同max_tokens輪次不能當成同一推理預算。

冒煙時我問它身份:上限512,返回「我是混元…版本號爲Hy4。」HTTP 200,正文非空。這一步只證明當時文本路由可用,不能外推成長上下文或桌面自動化已經驗證。

接線時我還會順手記下三件小事:展示名裏的「Hy4正式版」和請求裏的hy4不是同一個字符串;流式與非流式不要混着對比耗時;日誌裏既要打狀態碼,也要打content長度,否則後面空正文很難追。若團隊裏有人仍在文檔裏寫hy4-preview,先全局搜一遍配置倉庫,避免半套系統改了、半套還在打舊ID。

第二件事:Hy4正式版相對preview,看圖通不通

preview偏文本。正式版對外強調首次支持視覺——這是相對上一版、最可能改變接線方式的一點:圖和文本可以走同一條調用,不必再開第二條視覺路由。

我用自制Q1分區銷量柱狀圖(北80/東160/南200/西120)提問各區數字。今天覆測約8.9秒得到80 160 200 120,核對正確;同日更早一次也一致。對「週報截圖對數字、面板截圖進提示」這類活,這一步過了,改ID才說得通。

我會把看圖驗收寫成「可灰度」而不是「可全量」:清晰單圖讀數通過;帶水印、強壓縮、多窗口拼接、淺色字的樣本今天沒跑。業務要上線,用自己的髒圖複驗。電腦操作(CLI/GUI)官方有宣稱,我今天沒有在本網關讓hy4控桌面,所以檢查單裏這一項保持「未測」。長任務/agent加強同樣:短問答無感,大倉沒壓。

如果你的系統裏讀圖仍走另一條專用視覺路由,正式版的意義是「能合併」而不是「必須合併」。合併前先確認圖片輸入字段、大小限制和超時,和文本鏈路的錯誤處理是否一致;否則你會得到「模型能看圖,但你的網關封裝還不能看圖」的假陰性。合併後也建議保留一版旁路:視覺失敗時能否退回人工,而不是整單卡死。

第三件事:Hy4調用返回200時,正文是否真有字

換正式版ID當天,我踩過空正文:接口成功,用量有輸出token,content卻是空的。reasoning喫滿max_tokens後,finish_reason爲length。這不是「正式版比preview更不穩」的並排結論——我根本沒有同網關preview對照——而是接hy4時客戶端必須檢查的字段。

今天觀察的要點:

  1. 上限128到1024、題目偏推理時,多次出現正文空、推理喫滿。
  2. 上限2048時,同類題開始有字,仍可能被length截斷。
  3. 編碼長提示在2048與8192仍可能空;改成短問並抬到4096,纔拿到rows.sort()原地修改的說明和不改原列表的改寫。
  4. 「只回復:收到」上限256連打12次:全200、全有正文,耗時約2.6–4.0秒——只說明短鏈路當時活着。

因此接線檢查單裏我固定三步:看HTTP;看choices[0].message.content是否非空;看usage裏reasoning佔比。短屏幕答案也可能對應很高輸出用量,統計時不要把reasoning再加一遍。length且空正文時,優先加上限重試;不要先當成密鑰錯誤或模型下線。

對運維同學多一句:把「空正文率」和「HTTP失敗率」分成兩個指標。只盯後者,會在換hy4後誤以爲一切正常,直到業務側發現下游拿到了空字符串。對產品同學也多一句:重試會燒錢,上限盲目加到很大也會燒錢;更乾淨的做法是「複雜題給夠上限,簡單題保持短上限」,再在空正文時按題型抬檔,而不是全局拉滿。

Hy4正式版編碼:接線後可以順手測,但不是主更新

編碼不是相對preview的主戲。上面sort題證明:提示寫短、上限給夠,小函數副作用指認可用;合主分支仍要人工過。大倉庫重構今天沒測。若你主要做代碼選型,站內編程模型彙總可以用來把hy4和現有候選擺在一起看——那是目錄瀏覽,替不了你的倉庫樣本。

接線建議是:編碼鏈路可以灰度試寫,但不要把「正式版」三個字理解成編程能力自動升級。今天能寫進檢查單的,只有「小坑可指認」;寫不進的,是「可扛多文件重構」。若團隊想拿正式版頂替現有主力編程模型,至少先用你們倉庫裏的真實diff題跑一輪,而不是隻看更新說明。

Hy4正式版價格與TokenHub同檔怎麼核對

騰訊雲TokenHub上,正式版與preview同檔:輸入¥6、輸出¥18、緩存輸入¥0.3(每百萬token)。我記賬只看響應usage。站內也可在大模型API價格對比對公開價行。權重方面,preview階段曾能下載,正式版寫作時我還沒看到公開權重——別把兩邊開源狀態混成一次更新的「變好/變差」。

預算上容易誤判的一點:屏幕上只看到一句話時,reasoning可能已經佔了大部分輸出token。換hy4後如果賬單跳,先看usage分項,再決定是不是上限設太緊導致反覆重試。同檔標價不等於同檔賬單,空正文重試會把「同檔」打穿。

接線時我怎麼安排灰度順序

三件事不是並列打鉤那麼簡單,我會排個先後。先通ID並確認短文本有正文;再丟自己的業務圖,而不是隻用演示柱圖;最後才把空正文檢查接到重試和告警。原因很實際:看圖沒通,空正文檢查再完美也只是在保護一條你還不該放量的鏈路;空正文檢查沒接,看圖偶爾成功會掩蓋下游已經被空字符串污染。

灰度樣本我至少準備三類:一張標籤清晰的業務圖、一張故意壓糊的圖、一道你們倉庫裏真實出現過的小坑代碼。今天我只跑了清晰柱圖和小sort題,所以我的結論邊界也停在這裏。你補上髒圖和真實diff之後,正式版相對preview的「值不值得換」纔會變成你們團隊的結論,而不是我的檢查單複述。

若灰度期出現「短ping全綠、業務題偶發空正文」,優先查上限與提示長度,而不是先回滾到preview。回滾當然可以,但先分清是路由壞了,還是reasoning把額度喫光——兩者的修法完全不同。

Hy4正式版相對Hy4 preview:我的接線結論

  • 要進圖 → model寫成hy4,先拿自己的圖複驗。
  • 只寫短文、編碼順手 → 不必爲正式版儀式感改ID。
  • 衝着電腦操作或「HTTP一直200」全切 → 我不會;前者未測,後者今天見過空正文。

還在preview的,按這張檢查單走兩步即可:業務圖進hy4;故意收緊max_tokens,確認空正文不會被當成成功。電腦操作與超長agent自行備沙箱。三件事都過了,再談把更多流量切到正式版;缺任何一件,就先停在灰度。

檢查單可以很短,但每條都要能指回一次真實調用或一次明確的「未測」。寫「電腦操作未測」並不丟人;把未測寫成已支持,纔會在團隊裏留下假進度。


一名对 AI 领域充满热情的爱好者。平时喜欢关注最新的模型发展,也会自己动手测试不同的 API 和提示词(Prompt)

共有 0 則留言


一名对 AI 领域充满热情的爱好者。平时喜欢关注最新的模型发展,也会自己动手测试不同的 API 和提示词(Prompt)
🏆 本月排行榜
🥇
boluoji
📝18   💬3   ❤️6
366
🥈
站長阿川
📝5   💬2   ❤️1
213
🥉
mike
1
評分標準:發文×10 + 留言×3 + 獲讚×5 + 點讚×1 + 瀏覽數÷10
本數據每小時更新一次