百度千帆免費額度怎麼用？Qwen3 Coder 學生 AI Agent 導流

百度千帆目前有一條適合學生個人實驗的新使用者免費 tokens 路線。百度官方現行表格列出 17 個指定預置模型服務，各有 1,000,000 tokens、有效期 3 個月；免費額度只抵扣線上推理，不抵扣批量推理。模型清單和免費資格會變動，因此要在每次啟用前回到千帆控制台和官方文件重新查核。

本篇只把它批准為每位學生自己的低量、非生產學習燃料。學生自行建立 API Key、自行保管、自行看剩餘額度和帳單；主 agent 不收集 key、不建立全班共用 proxy、不用重複註冊擴大免費量。百度官方另有付費「Token 福利包」，那是購買的積分產品，不是本篇的新使用者免費額度。

當日敲門模型：Qwen3-Coder-480B-A35B-Instruct

本篇把 Qwen3-Coder-480B-A35B-Instruct 作為當日 Agent coding 敲門候選：它目前出現在百度千帆新使用者免費額度表，每項指定服務列 100 萬 tokens、3 個月有效。這是「官方表格可查到的免費候選」，不是我們替所有帳戶保證可用，也不是不經評測就宣稱全系列最佳。若你的模型廣場沒有顯示這個完整 model id 與免費額度，就停在人工查核，改用當日確實列為 Free 的服務。

學生要同時保留候選 model id、服務版本、免費資源剩餘量、到期時間、chargeType=Free 與 chargeStatus=Free 的查核紀錄。需要較強推理時，官方同一張表也列出 DeepSeek-V3.1-Think-250821；但選擇權仍由當日控制台資格、任務需求與本地低量預算決定。

先分清免費額度和付費福利包

新使用者免費額度是首次開通後由平台發放的限時資源；Token 福利包則按價格購買積分、依模型和工具扣減。兩者都可能在官方文件出現「token」字樣，但資格、有效期、計費順序和停止方法不同。文章不把付費福利包寫成免費燃料，也不因看到某個模型在福利包列表就宣稱新帳戶免費。

學生在 console 先確認資源名稱是新使用者免費額度，計費詳情的扣款類型也要顯示免費，而不是 Token 福利包、Tokens 量包、按量後付費或其他產品資源。

一百萬 tokens 是每個服務的額度

官方新使用者表格目前把 ERNIE、DeepSeek、Kimi、Qwen、bge、qianfan-sug 等 17 個指定服務列為 100 萬 tokens、3 個月有效，其中包含 Qwen3-Coder-480B-A35B-Instruct 與 DeepSeek-V3.1-Think-250821。這不是一個可以在所有模型間任意移動的總池；每個 model id、版本、推理服務和控制台資源都要獨立確認。

不要把 17 個表格列項直接相加成 1,700 萬 tokens，也不要把沒有出現在當日免費表的新版模型算進去。版本有日期後綴、latest 別名或服務名稱變更時，先讀模型詳情與餘額再更新 allowlist。

三個月是一次性有效期

免費額度的有效期是 3 個月，不是每月補回，也不是每一支 key 各有 3 個月。開通日、模型服務建立日和控制台顯示的剩餘時間要保存在本地 manifest；到期後未用的額度作廢，不應用換 key 或新帳戶重新取得。

如果官方日後改變起算點、指定模型或新使用者規則，本文的數字只作查核起點。真正呼叫前刷新頁面、重新讀回服務狀態並記錄時間，不把舊文章中的三個月視為永久保證。

模型版本要和免費表一起固定

同一家族的日期版本、latest、preview 和自訂服務可能有不同價格與免費資格。學生設定檔保存完整 model id、服務名稱、模型頁查核時間和三個月到期時間；版本退役或官方重新指向時，先停止並重新評測，不在背景程序中靜默替換。

allowlist 通過的條件不是名稱包含 ERNIE、DeepSeek 或 Qwen，而是當日服務清單顯示 Free、控制台有可用免費額度、請求走預置線上推理，且帳戶沒有需要付費的狀態。

免費餘額和限流要雙向讀回

控制台顯示的三個月免費餘額和 API response headers 是不同訊號。餘額回答還剩多少免費 tokens，RPM／TPM headers 回答短時間還能送多少請求；兩邊都可能有更新延遲。實驗前後各讀一次，並在帳單詳情確認扣款類型是免費額度。

若餘額、headers、usage 或計費詳情互相矛盾，先停機等待同步，不能以最有利的數字繼續壓測。報告保存查詢時間、request id、模型、狀態碼和非敏感統計，讓下一位學生知道數字可能不是即時值。

完成後刪除臨時憑證

作業結束依序停止 agent、IDE plugin、cron 和 queue worker，刪除 API Key、清除環境變數與錯誤 log，檢查沒有 Docker 或 CI 程序仍在呼叫，再保留不含 secret 的 adapter、假資料、評測結果和官方查核時間。免費資源的可重現性來自流程，不來自把別人的永久 key 留在設定檔。

若需要交接，交接的是模型查核清單、輸入輸出統計、錯誤分類和停止條件；接收者在自己的百度千帆帳戶重新建立 key 和 quota manifest，才能驗證現在仍然是免費線上推理。

這樣既能保留學習成果，也不會把上一位學生的帳務風險帶進下一次實驗。

下一次啟用仍以當日官方文件和自己的控制台為準。

不以快取的額度數字代替現況。

每次都要重新讀回服務與帳單。

再決定是否開始下一輪請求。

不依賴舊快取。

以新的查核結果為準。

再發送請求。

免費額度只抵扣線上推理

官方文件明確說新使用者免費額度只支持預置模型服務的線上推理，不支持批量推理。批量任務、調優、自訂服務、應用資源、工具資源和其他千帆產品不能自動套用這筆免費 tokens。

學生第一個 lab 限定 chat completion 或同等短文字 inference；不啟用 batch、檔案批次、長期 RAG、模型調優、圖片／影片長任務或背景工作。若要做其他產品，建立新的產品級成本和條款查核，不把免費文字額度延伸過去。

先用服務清單查免費狀態

百度官方預置服務 API 支援用 chargeType=Free 和 chargeStatus=Free 篩選，這比在程式中硬編一份舊模型名稱可靠。服務清單回應仍要與控制台的免費額度、版本詳情和餘額交叉核對，不能只因 API 回傳 Free 就跳過帳戶資格和到期時間。

const apiKey = process.env.QIANFAN_API_KEY;
if (!apiKey) throw new Error('missing QIANFAN_API_KEY');

const response = await fetch(
  'https://qianfan.baidubce.com/v2/service?Action=DescribePresetServices',
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      chargeType: ['Free'],
      chargeStatus: ['Free'],
      protocolVersion: 2
    })
  }
);
if (!response.ok) throw new Error(`service list failed: ${response.status}`);
const payload = await response.json();
console.log({ checkedAt: new Date().toISOString(), services: payload.result?.serviceList || [] });

這段只是查詢示意，實際 API 的權限、參數格式和回應欄位要以當日文件為準。服務清單不會替代免費餘額 read-back，也不會替使用者開通後付費。

API Key 要用最小權限

官方 API Key 文件說，key 是調用鑑權憑證，建立時可以配置權限粒度和接入點。全權限 key 可能能讀寫帳戶下所有線上資源，因此學生實驗優先選自訂權限，只允許需要的預置推理服務。

key 永久有效的官方說明不代表應永久保存。作業完成、電腦轉移或疑似洩漏後刪除 key，並檢查 CI、IDE、Docker、shell history 和本地 agent 設定。官方明確提醒不要分享，洩漏後刪除會拒絕後續呼叫。

主帳號和子使用者要分開治理

百度千帆的 API Key 與子使用者權限可以分離；主帳號能管理帳戶下的 key，普通子使用者只看到自己的 key。這不是邀請學生共用主帳號的理由，而是讓正式團隊能用 IAM 授權最小範圍的能力。

本篇個人路線由學生自行建立和刪除 key。若學校已有正式百度雲組織，應由管理者決定資源、接入點、資料和帳務責任；主 agent 不代學生申請子使用者，也不把一把主帳號 key 放進全班服務。

OpenAI 相容介面要固定版本

官方快速開始文件提供 https://qianfan.baidubce.com/v2 和 /v2/chat/completions，可用 Bearer API Key，並支援 OpenAI SDK。相容介面只代表請求格式容易移植；model id、tools、streaming、usage、錯誤和內容政策仍要依千帆文件測試。

不要把付費 Token 福利包的模型列表直接當成新使用者免費模型列表。每個 request 都要由 allowlist 鎖定 model、服務狀態、查核日期和剩餘免費額度。

文字呼叫採低額度設定

下面只使用環境變數和短文本，示範如何在本地 gate 通過後呼叫文字模型。真正的 model id 應來自當日免費服務清單和模型詳情，不能直接複製示例中的付費或已退役模型。

const key = process.env.QIANFAN_API_KEY;
const model = process.env.QIANFAN_FREE_MODEL || 'Qwen3-Coder-480B-A35B-Instruct';
const approved = new Set(
  (process.env.QIANFAN_APPROVED_FREE_MODELS || '')
    .split(',')
    .map((value) => value.trim())
    .filter(Boolean)
);
if (!key || !process.env.QIANFAN_APPROVED_FREE_MODELS || !approved.has(model)) throw new Error('model is not freshly approved as free');

const result = await fetch('https://qianfan.baidubce.com/v2/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${key}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model,
    messages: [{ role: 'user', content: '用三句話說明 API 配額。' }],
    max_tokens: 160,
    temperature: 0.2
  })
});
const data = await result.json().catch(() => ({}));
console.log({ status: result.status, model, usage: data.usage || null, requestId: data.id || null });
if (!result.ok) throw new Error(data.message || `request failed: ${result.status}`);

輸入輸出 token 要共同記帳

免費額度是 token 資源，不代表一個 request 只扣一點。長 system prompt、完整對話歷史、程式碼 repository 和高 max tokens 都會快速耗用 100 萬額度。送出前估算輸入，回應後讀取 usage，並為每位學生設定比供應商更低的每日上限。

本地 usage record 保存 model、開始時間、輸入長度、輸出長度、估算 token、實際 usage、重試次數、HTTP 狀態和剩餘額度查核時間。不要把完整 prompt、個資、Authorization header 或整份回應放到普通 log。

Responses API 的 headers 是配額訊號

官方 Responses API 文件列出 RPM、輸入 TPM、輸出 TPM 的 rate-limit headers，包括 limit 和 remaining。這些是短時間限流訊號，不是新使用者三個月免費 tokens 的剩餘量；兩者都要記錄，不能拿 RPM remaining 當成免費余额。

在每次受控呼叫後讀取 headers，若 remaining requests 或 tokens 很低，提前停止下一輪。免費額度頁和計費詳情才用來確認免費資源包；headers 用來調整即時並發和退避。

429 只做有限退避

429 可能是 rate limit、模型容量或帳戶服務狀態。退避是等待可用性恢復，不是用 key 輪換繞過限制。每個 task 最多重試兩次，保存 request id 和剩餘 headers；連續出錯就交給學生查看 console。

async function boundedCall(request, maxAttempts = 2) {
  for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
    const response = await request();
    if (response.status !== 429 || attempt === maxAttempts) return response;
    await new Promise((resolve) => setTimeout(resolve, 800 * attempt));
  }
  throw new Error('bounded retry ended unexpectedly');
}

const response = await boundedCall(() => fetch(
  'https://qianfan.baidubce.com/v2/chat/completions',
  { method: 'POST', headers: { Authorization: `Bearer ${key}` } }
));
if (response.status === 429) throw new Error('rate limit remains; stop this task');

免費額度耗盡要停在付費確認

官方 FAQ 說每個新使用者有 100 萬 tokens、3 個月免費資源，免費資源用完後需要購買千帆付費服務。這不是主 agent 可以自動完成的 fallback。收到 quota exhausted、service stopped、billing required 或沒有免費資源時，停止並通知帳戶持有人。

不要自動選另一個未查核模型、切換到 Token 福利包、啟用按量後付費或建立新帳戶。付費批准若真的發生，必須另建 paid manifest、模型價格、每日預算和人工停止點；本篇的免費路線在這裡結束。

401、403、5xx 要分流

401 多半是 API Key 或授權格式問題；403 可能是接入點、權限、內容安全或服務資格；400 是 model 或 request schema；429 是限頻或配額；500、503、504 是服務或暫時性故障。每種狀態都要留下 request id 和不含 secret 的摘要。

401 不要把 key 印出來，403 不要用更高權限 key 繞過，429 不要換帳戶，5xx 只作有限重試。任何模型或接入點變更先回到官方模型頁和免費資源頁查核。

主帳戶 API Key 可以永久有效

官方認證文件目前寫 API Key 可永久有效、每個主帳號或子使用者有數量上限；這是管理能力，不是安全建議。學生仍應採短期作業 key、最小接入點權限和完成後刪除，避免長期憑證被忘在舊專案。

主 agent 只保留 key 的非敏感識別和建立／刪除時間。若 key 曾進入公開 repo、CI log 或瀏覽器，刪除並檢查所有使用它的程序，再重新生成一把最小權限 key；不把旋轉當成免費配額策略。

資料和內容要最小化

免費額度不改變資料權利。學生不要把姓名、學號、客戶資料、商業秘密、未公開程式碼、密碼或未授權的第三方內容送入模型。先用公開、去識別化或 synthetic data，並在作業中保留來源和授權說明。

主 agent 預設只做文字建議，關閉自動瀏覽、寫檔、發信、付款、部署和其他副作用工具。模型輸出需要人工檢查，不能因為 token 免費就降低內容安全、智慧財產和個資的門檻。

Qianfan 應用資源不是模型免費額度

千帆同時有模型服務、AppBuilder 應用、組件、知識庫和其他資源。官方 FAQ 說應用和組件可能有自己的免費資源、有效期和開通流程，且 SDK／組件調用不一定和 GUI 顯示的資源共用。不能用 AppBuilder 的免費數字代表模型 API 仍有 100 萬 tokens。

學生先決定實驗是「模型 API」還是「應用平台」，使用對應的官方文件和帳務項。這篇只批准預置模型線上推理，不批准把免費模型包裝成公開應用分發或多使用者服務。

小型評測先於主 agent 接入

用十到二十筆固定、無個資的案例測試繁體中文、指令遵循、JSON 格式、拒答、延遲、usage、429 和模型版本。每次記錄免費資格查核時間、model id、API base URL、prompt 版本和 max tokens，再與另一條已批准的模型路線比較。

只要模型下架、免費狀態變更、3 個月到期或 API response schema 改變，就重新評測。不要因為一個成功回應就宣稱千帆可以穩定支援主要 agent 的所有任務。

學生個人工作流

第一步學生自行確認新使用者資格、免費模型、服務版本、到期時間和付款狀態。第二步建立最小權限 API Key，放入本地環境變數。第三步查詢 Free service list、刷新控制台餘額，設定本地每日 tokens、請求數和並發上限。

第四步用合成資料做短請求和小型評測，保存不含 secret 的 usage record。第五步實驗完成後停止排程與 plugin、刪除 key、清除臨時 log，並只交接程式、假資料、評測結果和官方查核時間。

不把免費 tokens 變成共用 gateway

官方 API Key 文件明確要求不要分享 key，並建議最小權限；因此學生使用的正確形式是每個人自己的帳戶和 key，不是老師收集後轉給全班。不能用主子使用者、永久 key 輪換或多帳戶註冊來放大免費量。

若團隊需要集中服務，先走正式 IAM、接入點、資料處理、付費和條款審查。免費新使用者額度只能支援個人學習實驗，不代表百度千帆允許建立主 agent 共用服務、公開課程 API 或轉售接口。

停止條件提前固定

當免費 model 不在官方清單、額度已用完、3 個月已到、服務變成 Tokens／Calls／Opened、需要批量推理、收到連續 429、key 權限不明、資料含個資或任務需要對外服務時，立即停止。不以重建帳戶、換 key 或切換付費福利包解決。

恢復要重新讀官方免費額度、服務清單、模型版本、API Key 權限、錯誤碼、條款和帳單，再由帳戶持有人明確批准新的 manifest。沒有 fresh read-back 就不自動重啟。

官方文件清單

啟用前請閱讀官方新使用者免費額度、官方預置服務列表、官方文字生成 API、官方 API Key 管理、官方認證鑑權、官方 Response 與 rate-limit headers、官方錯誤碼與官方 Token 福利包。若控制台與文章不同，以當日官方資料為準。

和既有免費燃料的分工

百度千帆適合作為「指定預置模型、每項 100 萬 tokens、3 個月有效、只抵線上推理」的個人中文模型實驗分支。它和 Tencent TokenHub 同樣有一次性免費資源包，但千帆要特別區分服務清單的 Free 狀態、Token 福利包、應用資源與模型 API。想比較另一條中文模型路線，可閱讀Tencent TokenHub 免費體驗說明，也可先看AI Agent 常見問題。

跨供應商 fallback 只能把每一個學生自己的 key 放在自己的 adapter 中，並維持獨立配額、帳務和停止記錄。不能把多家免費額度拼成匿名公共池，也不能用 fallback 掩蓋千帆免費額度已結束。

本篇批准結果

百度千帆通過「每位學生個人、新使用者指定預置服務、線上推理、3 個月內、最小權限 API Key、公開或 synthetic data、低量且可停止」的窄批准。它沒有通過「共用 key、批量推理、付費 Token 福利包冒充免費、免費耗盡後自動購買或建立主 agent 公共 gateway」的批准。

本篇沒有登入百度千帆、沒有建立或讀取 API Key、沒有購買 Token 福利包、沒有做實際 API smoke，也沒有對 WordPress 或公開網站寫入。正式啟用前必須重新查核免費模型表、服務清單、權限、額度和帳單。