AIHubMix GPT-5.5-free 10 次試用怎麼用？學生 AI Agent 導流

AIHubMix 目前有一個容易被「免費模型」標題混淆的入口：官方免費模型頁列出 50 個 input/output 顯示為零美元的模型，但新帳戶先拿到的是 10 次共用的 trial calls；要切換到每天 100 次、每分鐘 10 次、每日 1M tokens 的永久日配額，官方頁面寫的是至少一次 1 美元充值。這兩種狀態不是同一種免費方案，所以本文只把「不充值的 10 次試用」列為候選燃料，不把充值後額度寫成免費。

對學生主要 agent 而言，AIHubMix 還有第二層需要小心：它是多上游模型 gateway，不是 OpenAI、Google、智譜或其他模型公司的官方 API 本身。相同的模型名稱可能由不同上游通道提供，資料處理與可用性要看 gateway 與實際上游兩邊。本文可以幫你做一次低風險的介面實驗，但不批准把它當成長期、無人值守或敏感資料的主 provider。

本系列整理的是合法公開的免費試用與 API 入口，不代註冊、不替任何人充值、不收集或分享 key，不使用多帳戶、key 輪換或上游 failover 來規避免費限制。若要先了解學生 agent 的憑證與資料邊界，可以參考 AI agent 使用 FAQ。

當日敲門模型：GPT-5.5-free

如果今天要替學生 agent 選一個 AIHubMix 的起手式，本文先把 gpt-5.5-free 列為候選。AIHubMix 官方免費模型說明頁目前把它定位為最新的旗艦免費變體，並提供 OpenAI 相容 Chat Completions、Responses 與範例；免費模型目錄也列它為文字、視覺輸入與文字輸出的模型。這只是 AIHubMix gateway 目錄中的免費候選，不是 OpenAI 官方 API 免費贈送，也不是對每個帳戶都永久可用的保證。

啟動前仍要重新讀 當日模型頁的 model ID、免費標記、request weight、context、試用剩餘量與資料處理條件；目前該頁另列每帳戶 5 requests／分鐘、500 requests／日與 1M tokens／日，不能把這組模型級資料套到所有免費模型。若模型改名、下架、無法辨認上游或只剩充值後 quota，就停在 REVIEW_REQUIRED。不要因為名稱相近便自動切換到 paid ID、其他免費變體或 gateway 的 auto router。

先分清楚五種不同的東西

• 免費模型：官方模型頁用 -free ID 標記的模型；是否當天可用、RPM、每日 token 與請求權重要以模型頁為準。
• trial calls：官方目前列每個帳戶先有 10 次，共用於免費模型，沒有信用卡要求，也沒有試用到期日。
• 每日免費配額：官方目前把每日 100 requests、每分鐘 10 requests、每日 1M tokens 與一次性至少 1 美元充值連在一起，這是充值後帳戶狀態，不是零成本試用。
• API key：送模型請求用的憑證；本文只使用 server-side key，不展示真值。
• 管理 access token：官方 CLI 文件用來查詢帳戶、管理 key、查詢模型或執行管理操作的身分憑證；不要交給學生 agent。

如果你把這五種東西都叫做「token」，agent 很容易在免費試用用完後仍繼續送出請求，或在管理 token 外洩後被拿去建立新 key。本文用「憑證」表示 API key 或管理 access token，用「呼叫」表示試用次數，用「額度」表示模型頁或帳戶控制台讀回的剩餘值。

目前可以確認的零成本範圍

AIHubMix 官方免費模型頁目前寫明：新帳戶不需要信用卡，先有 10 次 trial calls，這 10 次在所有免費模型之間共用，而且頁面說試用呼叫不過期。這是目前最保守、最能被明確描述的零成本範圍。不要把 50 個模型乘以 10，因為頁面寫的是 10 次總量，不是每個模型各 10 次。

官方同一頁還寫明，至少一次 1 美元充值後，帳戶會切換到每日配額。那一美元是付費行為，不能為了取得更多免費呼叫而由 agent 自動執行，也不能在學生文章中標為「免費啟用」。若課程沒有批准花費，預設狀態就是不充值、只允許 10 次試用，試用狀態不明就停止。

有一點需要人工重讀：官方頁面描述試用用完後 API 可能繼續回傳一段提示，而不是直接回傳硬錯誤。對主要 agent 來說，HTTP 200 不能單獨代表拿到模型答案；adapter 必須檢查回應內容、usage、模型狀態與本地剩餘試用計數，把「試用已用完的提示」視為停止事件，不能讓提示文字流入下游工具。

「無到期日」也只表示官方頁面目前沒有為這 10 次試用寫出時間期限，不代表服務、模型目錄或免費政策永久不變。供應商可以更新模型、改變配額、調整試用規則或停止某個上游通道；所以每次重新開始課堂作業，都要重新讀一次免費模型頁與帳戶狀態。若日期、模型或試用數值與上次不同，先建立新的審計事件，再決定是否放行。

也不要把 AIHubMix 頁面上的模型作者名稱當成已取得官方授權的證據。聚合器可能提供同一模型家族的代理名稱、免費變體或多個通道；在教學中應寫「AIHubMix 目錄中的免費模型」，並連回模型頁，而不是寫「某上游官方送你免費 API」。如果模型授權、地區、內容政策或資料保留無法被當天確認，就把它降級為只可做無敏感資料的人工測試。

模型名稱與上游不能想當然

免費模型頁目前以 -free 結尾的 model ID 區分免費版本，並列出模型作者、輸入輸出型態、context、rate limit 與 paid version。這個目錄是 gateway 的產品目錄，不代表模型上游公司把自己的官方 API 無條件免費開放。文章只採用 AIHubMix 官方頁對「gateway 中的免費模型」的描述，不把它改寫成任何上游官方免費額度。

模型頁與免費目錄會更新，模型可能被移除、改名、換上游或調整配額。啟動 agent 時先取得當前允許模型，與課程 allowlist 取交集；不能看見一個相似名稱就自動切換。若實驗需要某個特定上游的資料處理保證，應直接使用該上游的官方 API 與條款，不要由聚合器的模型名稱推測。

建立 key 前先把管理面隔離

AIHubMix 官方管理文件顯示，普通模型 API key 與系統 access token 不同。系統 access token 可以查帳戶資訊、模型、key 清單，甚至建立、更新或刪除 key；這種能力不應放進學生 agent、前端、課堂 notebook 或共享 CI。學生只拿到由管理者建立的短期、用途單一、可撤銷 API key，且不拿到管理層憑證。

普通 API key 也不要直接貼到聊天、截圖或 repository。使用環境變數注入，key 的有效期與剩餘 quota 要在控制台或受控管理層讀回。若 key 外洩，先停用或刪除舊 key，再查詢使用記錄；不要用另一支 key 蓋過問題，更不要把管理 token 發給同學請他們代查。

function assertAiHubMixTrial(state) {
  if (state.billingMode !== 'NO_TOP_UP') throw new Error('This run is not zero-cost trial mode');
  if (state.autoTopUpEnabled === true) throw new Error('Auto top-up must remain disabled');
  if (state.trialCallsRemaining <= 0) throw new Error('Trial calls are exhausted');
  if (!state.model.endsWith('-free')) throw new Error('Only an approved free model is allowed');
  if (!state.modelAllowlist.includes(state.model)) throw new Error('Model is outside the allowlist');
}

assertAiHubMixTrial(readFreshTrialState());

NO_TOP_UP 是我們的本地政策狀態，不是宣稱 AIHubMix 控制台必然有同名欄位。它只有在人工確認沒有充值、沒有自動充值、沒有付費餘額與試用剩餘量後才可設置。若只能看見帳戶總 quota，不能辨識它是 trial 還是充值後配額，就把狀態標為 REVIEW_REQUIRED。

用最小請求消耗一次試用

AIHubMix 官方免費模型頁提供 OpenAI 相容的 https://aihubmix.com/v1 入口，免費聊天範例使用 /chat/completions。第一次只送公開或合成的短文字，輸出上限設定得小，關閉工具呼叫與長歷史，並在本地先扣除一次 trial call 預算。若回應內容是額度提醒、帳戶提示或無法辨認的空結果，就不要把它當成模型成功。

async function runTrial(prompt) {
  const key = process.env.AIHUBMIX_API_KEY;
  const model = process.env.AIHUBMIX_APPROVED_FREE_MODEL || 'gpt-5.5-free';
  if (!key || !model) throw new Error('AIHubMix key or model is missing');

  const response = await fetch('https://aihubmix.com/v1/chat/completions', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${key}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      model,
      messages: [{ role: 'user', content: prompt.slice(0, 2500) }],
      max_tokens: 160,
      temperature: 0.2,
      stream: false
    })
  });

  const data = await response.json().catch(() => ({}));
  const text = data.choices?.[0]?.message?.content ?? '';
  const looksLikeNotice = /trial|quota|top.?up|充值|額度|配額/i.test(text);
  if (!response.ok || !text.trim() || looksLikeNotice) {
    throw Object.assign(new Error(`AIHubMix trial failed: ${response.status}`), { status: response.status, data });
  }
  return { text, usage: data.usage ?? null, requestId: data.id ?? null };
}

這段範例刻意沒有使用 Responses、Messages、圖片或多輪工具流程，因為不同免費模型的介面能力可能不同。要測試其他協定時，先看該模型頁與 AIHubMix 官方 API 文件，再另開小額度測試。模型答案若需要送到另一個 provider，先移除可能含個資的上下文，並在資料政策允許的範圍內操作。

每一次試用都應該有一筆不含秘密的本地紀錄：開始前的 trial remaining、模型 ID、預計輸出上限、請求開始時間；結束後的 HTTP 狀態、回應 ID、usage 是否存在、內容是否為額度提示，以及結束後推算的剩餘量。若請求逾時或網路斷線，不要直接把本地計數加回去，因為無法確定 gateway 是否已收到請求；交由人工重新讀回再決定。

多人課堂不要讓每個學生都共用一個無期限的 key。由管理者建立一個可撤銷的課堂 adapter，在本地把 10 次試用拆成更小的每人配額，並記錄使用者代號、模型與停止原因。任何人都不能自行把自己剩餘量轉給另一個帳戶，也不能建立第二帳戶繼續呼叫。這樣即使一個學生的提示設計出錯，也能在課堂層級停止，而不是等整個帳戶用完才發現。

免費模型的 token 上限仍要自己監督

官方目前把充值後免費模型配額描述為每日 1M tokens，但不同模型頁可能有自己的 RPM、每日 token 與請求權重。對不充值的 10 次試用，文章不把 1M tokens 套用進去，也不猜測每次試用可用的最大 input 或 output。學生 agent 仍應設本地輸入截斷、輸出上限、每日任務次數與總 token 估算，避免一個超長請求耗掉所有試用價值。

如果某模型有較高的 request weight，一次呼叫可能消耗多個請求單位；即使官方頁寫 10 次 trial calls，也要以實際模型頁的權重與帳戶讀回為準。不要把 10 次當成 10 次長上下文 agent 迴圈。課堂上可先用單輪摘要、短程式碼解釋與格式轉換，讓每一次請求的輸入、輸出與結果都能被記錄。

資料會經過多上游

AIHubMix 的 FAQ 與資料政策文件說明，平台本身通常不主動保存 prompt 或 model response，但會保存必要的 token count、latency、模型與呼叫等 metadata；底層模型供應商有自己的 logging、retention 與 training policy。若發生封禁或合規通知，平台可能被動保留相關請求資訊。這些說明不能轉化成「所有免費模型都零留存」。

學生只應傳送公開內容、自己生成的測試資料或得到明確批准的匿名資料。不要傳送未公開作業、個資、公司機密、原始碼、cookie、登入資訊或其他供應商的 secret。需要處理敏感資料時，優先使用已審核的本地模型、私有部署或有明確資料處理協議的官方服務。免費試用不足以豁免資料治理。

錯誤處理和付款停止

• 401：憑證缺失、失效或過期；停止並檢查 key，不要貼出 key 求助。
• 403：官方文件列出帳戶餘額不足、帳戶停用、IP 限制或模型未授權；不充值、不切換管理 token，先人工查核。
• 429：模型頻率超限；等待並重新讀回，不用另一支 key 輪替。
• 503：模型 ID 不正確、無可用通道或上游限流；重新查看當前模型頁，不能猜測模型名稱。
• 試用耗盡提示：即使 HTTP 200，也把內容提示視為停止，不送進工具鏈、不自動充值。

function classifyAiHubMixFailure(error) {
  if (error?.status === 401) return { action: 'STOP_REVIEW_API_KEY', retry: false };
  if (error?.status === 403) return { action: 'STOP_REVIEW_BALANCE_SCOPE_OR_IP', retry: false };
  if (error?.status === 429) return { action: 'WAIT_AND_REFRESH_MODEL_QUOTA', retry: false };
  if (error?.status === 503) return { action: 'STOP_REFRESH_MODEL_CATALOG', retry: false };
  return { action: 'STOP_AND_ESCALATE', retry: false };
}

主要 agent 的 fallback 不能把 AIHubMix 的自動上游 failover 當作本地安全機制。gateway 內部可能換通道，但你的資料仍可能進入另一個供應商；若回應的 provider、模型版本或資料處理狀態無法被記錄，就不要在敏感任務使用。免費入口的目標是可觀察的短實驗，不是讓錯誤永遠被隱藏。

適合的學生作業

• 用公開短文比較兩個已批准的 -free 模型回答同一個摘要提示。
• 記錄單次輸入、輸出、usage、模型 ID 與試用剩餘量，學習 quota ledger。
• 刻意測試 401、429、503 與試用耗盡提示的停機路徑，但不反覆重試。
• 把同一段 synthetic data 送往不同上游政策清楚的服務，整理資料流向差異。
• 建立一個只允許十次試用、到零就鎖定的本地 adapter。

不適合的作業包括長時間爬蟲、無限代理迴圈、把 gateway 當成官方上游 API 的替代品、把多個帳戶或 key 輪流使用、充值後宣稱仍是免費、或把學生內容投入不明的多上游模型。若一個實驗必須每天穩定跑一百次以上，就應重新申請付費與資料治理，不應壓在十次試用上。

若課程目標只是比較回答品質，十次試用足夠做一個小型、可重現的 benchmark：固定五個公開問題、固定一個短輸出上限、每個模型只跑一次，保留模型 ID 與人工評分。若目標是建造可以持續工作的 agent，這個入口就不合適；應另行選擇有明確免費額度、可設定停止、資料協議與合法預算的 provider。不要讓課程需求逼迫免費試用承擔超出它設計範圍的工作。

評測結果也不應只留下模型回答。至少要一起保存試用狀態、輸入輸出估算、是否發生上游切換、錯誤類別和資料等級。這讓學生看見「能回答」與「能被安全納入 agent」是兩個不同問題；免費模型若缺少可觀察性，就算品質很好，也只能停留在人工試用階段。

每次重新讀到官方頁面時，應把查核日期、免費模型數量、試用呼叫數、模型配額、充值條件和停止規則寫入研究紀錄。若下一次官方頁改成不同數字，不修改舊實驗的結論來掩蓋漂移，而是建立新的版本，重新審核是否仍適合學生。免費服務的價值不只在省錢，也在讓額度、政策與風險都能被看見。

這份紀錄不需要保存原始提示或完整回答；只要保存去識別化的計數、狀態與品質分數即可。研究資料和秘密資料分開存放，讓任何人都能驗證額度判定，卻不能從紀錄還原學生內容或呼叫憑證。

若資料分類不清楚，先不要送出請求，等候人工審核、確認與記錄。

安全邊界永遠優先，任何未知狀態都先停機。

放行清單與暫不批准條件

AIHubMix 目前只能放在「人工批准試用」清單，條件是：帳戶控制台讀到尚未充值、auto top-up 關閉、試用剩餘量明確；使用的是一支 server-side API key，不是管理 access token；模型頁當天可用且在 allowlist；輸入是公開或 synthetic data；每次請求前後都有本地計數；回應會過濾試用提示；401、403、429、503 與未知狀態全部停止；不自動換帳戶、不自動充值、不把 gateway failover 當作資料安全。

只要無法確認 10 次試用的實際剩餘量、免費與充值配額的邊界、模型上游與資料處理，狀態就是 REVIEW_REQUIRED，不加入主要 agent 的 fallback。這個候選可以幫學生學習 gateway、API key 與配額治理，但目前不應被描述成持續捕獲的免費 token 燃料。完成試用後，應等待下一個已重新查核的官方入口，而不是自行延長額度。

官方來源與最後判斷

本文以 AIHubMix 官方免費模型頁、免費模型說明、FAQ、資料政策、HTTP 狀態碼、管理 CLI 文件 與服務條款為依據。官方頁面會變動，使用前應重讀免費模型目錄、試用規則與上游供應商政策；不要只依賴本文的日期快照。

最後結論：AIHubMix 可以列入「不充值的 10 次人工試用」候選，但不能把一次性充值後的每日配額寫成免費，也不能把聚合器模型等同於任一上游官方 API。對主要學生 agent，最安全的做法是限制在公開資料、短提示、單次呼叫、server-side key 與本地停止閘門；一旦試用、模型、帳務或資料流向不明，就停止並交人工。

本文沒有代為註冊、建立 key、充值、呼叫真實 API、啟用上游 failover 或發布 WordPress；本機只保存官方研究與不含秘密的範例。下一篇將按照相同門檻繼續研究另一個官方免費或試用 API 入口，先確認它是真正的 token 額度、呼叫配額、試用金額還是純速率限制，再決定是否批准。