StepFun step-3.7-flash 15 天試用怎麼用？學生 AI Agent 導流

StepFun 官方目前有一個很適合拿來教「免費額度不是永久燃料」的案例：新使用者可獲得 15 天 Flash Mini Free Trial，試用有自己的 credits 與週期限制，使用 API 時需要可用的 Step Plan 與 API Key。不過官方促銷條款同時寫明，這個活動在 2026 年 8 月 24 日 23:59 UTC 結束，而且每位使用者只能參加一次。因此本文是一篇日期限定的試用介紹，不是長期可重複捕獲的 token 方案；活動結束後，沒有新的官方試用讀回就應從候選清單移除。

StepFun 的「free credit」也不能直接等同於固定 token 池。官方標準 API 定價說 input 與 output token 會按模型價格計費，先扣 free credit，再扣 paid balance，而且 free credit 可能過期；最新 Step Plan overview 則改以每月 Credits 作為統一計量，沒有舊版以 5 小時或 prompt window 解讀的固定換算。學生 agent 必須把試用狀態、Credits／free credit、有效期、模型與帳務模式分開讀回。

本系列只整理合法的公開試用與免費資源，不代替學生註冊、不建立或分享 API key，不邀請刷券、不重複註冊、不充值，也不在試用用完後偷偷轉到 paid balance。若你要先理解共同的憑證與資料原則，可閱讀 AI agent 使用 FAQ。

當日敲門模型：step-3.7-flash

若活動仍在官方條款的有效窗口內，本文先把 step-3.7-flash 列為學生 agent 的敲門候選。StepFun 最新 Step Plan overview 把它列為 flagship multimodal reasoning model，quick start 也把它作為第一次整合驗證的優先模型；但候選不等於帳戶已經啟用，也不等於 15 天試用可以使用所有 flagship 功能。仍要從控制台讀回 plan、模型、Credits、endpoint 與到期時間。

第一次只做短文字、低輸出上限與單一請求，使用 OpenAI 相容的 Step Plan endpoint；若帳戶沒有當前模型權限、試用已過期、活動截止或 free／paid 狀態不明，就停在 REVIEW_REQUIRED。不要因為標準 API 也出現相近模型名稱，便自行切換 endpoint 或把付費方案當成免費燃料。

先確認活動還在有效時間內

官方促銷條款目前寫明活動結束時間是 2026-08-24 23:59 UTC。這個時間與讀者所在地不同，不能只看本機日期寫成「今天都還能申請」。申請或寫入課程清單前，先打開官方條款與 StepFun 控制台，確認活動狀態、帳戶資格與當前時間；若已過截止時間，本文只保留為歷史說明，不再把它列作可取得的免費燃料。

每位使用者只能參加一次。官方條款把新使用者的 benefit 寫成 15 天 Flash Mini Free Trial；若試用期間把包含的 credits 用完，條款還描述系統會自動發放一張 15 天 trial voucher。這個後續 voucher 不是邀請人頭獎勵，也不是可以無限重複取得的技巧；它是否真的發到特定帳戶，要以控制台讀回為準，不應由 agent 自行創造條件。

試用、Step Plan 與標準 API 要分開

• Flash Mini Free Trial：官方促銷提供的日期限定試用；是否有 credits、有效期與後續 voucher，要看活動條款與帳戶狀態。
• Step Plan：最新文件定義為訂閱型服務，以每月 Credits 統一扣量；月度 Credits 月底清除、不自動結轉，付費方案不能寫成免費。
• 標準 API：開放平台的按 token 計費服務，使用標準 endpoint 時可能從 free credit 扣到 paid balance；不能因為帳戶看得到 credit 就假設所有 API 都是零成本。
• Studio 與其他產品：官方頁面分別介紹 Studio、Step Plan 和 API；產品 quota 與帳務邊界要個別讀回，不能混用。

Step Plan quick start 的官方建議順序是先確認帳戶有可用的 Step Plan，再建立 Step API Key，最後整合工具。這個順序很重要：先建立 key 不代表帳戶已經有試用或訂閱權限。學生 agent 只在控制台確認 trial plan 仍有效、free credit 可用、paid balance 不會被扣款後才放行；任何一項未知都停在人工審核。

Flash Mini 目前以 Credits 供應

Step Plan overview 目前說明每個方案按月發放 Credits，所有模型使用量都換算成 Credits 扣除；Flash Mini 每月列 400M Credits，月度餘額月底清除、不結轉。Credits 不是免費 token 池，也不能直接換算成學生每天可以送出的 request；活動試用的實際 credits、到期與可用模型仍要以帳戶讀回為準。

標準 API 定價則以 input token、output token 與模型單價計算，multimodal 圖像也可能使用另一個計量。當 agent 呼叫工具、把歷史對話反覆帶回或使用很大的輸出上限時，free credit 會消耗得更快。學生作業應先限制單次輸入、輸出、工具輪數與總時間，並在每一輪保存 usage 與 plan 狀態。

free credit 的優先扣除順序也不能被解讀成「用完一定停止」。官方定價說明先扣 free credit、再扣 paid balance，這表示帳戶如果留有正餘額或已啟用付費路徑，請求可能在免費 credit 歸零後繼續產生費用。學生 agent 的安全預設必須是沒有可被動用的 paid balance，或在 provider 外層用硬閘門拒絕繼續；不能靠「希望帳戶報錯」來保護預算。

如果控制台只顯示總餘額，沒有分開列出 free credit、paid balance、voucher 與 plan quota，請不要把總數寫入 STEP_FREE_CREDIT。讀回資料要帶來源、時間與帳戶範圍，並確認它是 API 的 Step Plan 狀態而不是 Studio 的創作點數。不同產品的點數、prompt、token 與帳務不能相加，也不能把某個頁面的展示數字當成另一個 endpoint 的可用量。

試用 voucher 若在 credits 用完後自動出現，也要把它當成新的狀態重新審核：記錄 voucher 建立時間、有效期、可用模型、可用 endpoint、是否免費、是否需要付款方式，以及是否有自動續費。沒有這些讀回就不自動切換 voucher。自動切換的控制權留在人工，而不是在 agent 的 retry loop 裡。

活動只有一次參與資格，學生之間也不能把自己的 voucher、key 或帳戶轉交給別人。若多人要做同一個實驗，由課程管理者建立合規的共享流程，將每個人的任務預算在 adapter 中隔離；不要把一支 key 放進所有 notebook。任何邀請獎勵、轉介、批量註冊或代理方法都必須遵守條款，不能用來延長個人免費期。

若使用者是未成年人，還要遵守學校、家長或課程對雲端 AI 服務的額外規定；不要因為官方頁面有試用就代替本人完成身份、付款或同意條款。學生應知道自己正在接受哪個服務、資料會送到哪裡，以及如何在試用結束前停止。

建立本地試用狀態閘門

StepFun 沒有要求我們使用一組固定名稱的本地環境變數，以下狀態是課程 adapter 的安全模型。STEP_TRIAL_STATUS 必須來自剛剛的控制台讀回；STEP_FREE_CREDIT、STEP_PLAN_EXPIRES_AT 與 STEP_PLAN_MODE 不可從舊日誌推測；STEP_PAID_BALANCE_ALLOWED 應明確為 false，除非另外取得付費授權。

function assertStepFunTrial(state, now = Date.now()) {
  if (state.trialStatus !== 'ACTIVE_FREE_TRIAL') throw new Error('StepFun trial is not active');
  if (state.planMode !== 'FLASH_MINI_TRIAL') throw new Error('Unexpected StepFun plan mode');
  if (state.paidBalanceAllowed === true) throw new Error('Paid fallback is not approved');
  if (!Number.isFinite(state.freeCredit) || state.freeCredit <= state.reserveCredit) {
    throw new Error('Free credit is below the safety reserve');
  }
  if (!Number.isFinite(Date.parse(state.expiresAt)) || Date.parse(state.expiresAt) <= now) {
    throw new Error('StepFun trial has expired');
  }
  if (state.promoEndsAt && Date.parse(state.promoEndsAt) <= now) {
    throw new Error('The promotion window has ended');
  }
}

assertStepFunTrial(readFreshStepFunState());

這個閘門的重點是確認狀態，不是模擬 StepFun 的內部 billing。若控制台只顯示一個沒有來源的 quota 數字，無法分辨 free credit 和 paid balance，或看不到試用的到期時間，就不要設成 ACTIVE_FREE_TRIAL。當活動截止日已過，即使帳戶頁仍顯示舊的 voucher，也要重新確認條款與使用資格。

試用狀態檔應設定短暫有效時間，例如只允許在一次課堂工作階段內使用；工作階段結束就要求新的 read-back。不要把昨天的 ACTIVE 狀態放進 agent 長期記憶，也不要只用環境變數中的日期作為證明。有效期、free credit 與 promotion end time 都要由受控讀回產生，並保留查核者與查核時間。

API Key 只放在 server-side

官方 API key 頁面提醒最多可建立有限數量的 secret keys，並可能在發現外洩時自動輪換。學生不應把 key 寫入前端、Git、notebook 輸出、截圖或多人聊天室。使用一支用途單一、短期、可撤銷的 key，從 secret store 注入到 server-side adapter；不要把帳戶密碼或控制台 session 交給 agent。

活動規則與 Step Plan 條款也禁止使用 proxy、token rotation、bulk registration、異常併發或其他方式規避限制。若一支 key 到期或外洩，正常流程是停用、重新建立、更新 secret 與檢查日誌，不是把多支 key 輪流塞進 provider fallback。主控制器應能在人工判定前讓整個 StepFun adapter 停止。

正確的 Step Plan endpoint

StepFun 官方文件把 OpenAI 相容的 Step Plan endpoint 寫成 https://api.stepfun.ai/step_plan/v1，不能直接拿標準 API 的 https://api.stepfun.ai/v1 取代。Anthropic Messages 相容介面使用另一個 base path。若 endpoint、模型、plan 或 key 不匹配，請先查設定，不要自動切到標準按量計費入口。

模型也要從試用 plan 的當前支援清單讀回。即使標準 API 能看到同名模型，Step Plan 試用不一定擁有相同的模型、工具、速度或上下文；如果帳戶沒有明確列出某個模型，就不要用名稱猜測可用。把模型 ID、plan、endpoint 和最後一次成功讀回的時間一起記錄，方便活動變更後重新審核。

async function callStepTrial(prompt) {
  const key = process.env.STEP_API_KEY;
  const model = process.env.STEP_APPROVED_MODEL || 'step-3.7-flash';
  if (!key || !model) throw new Error('StepFun API key or model is missing');

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

  const data = await response.json().catch(() => ({}));
  if (!response.ok) throw Object.assign(new Error(`StepFun HTTP ${response.status}`), { status: response.status, data });
  return { text: data.choices?.[0]?.message?.content ?? '', usage: data.usage ?? null, id: data.id ?? null };
}

範例使用短文字、非串流與低輸出上限，方便在第一次課堂實驗中保存 usage。官方文件說明不同模型與協定可能有參數差異；要使用 Messages、vision、tool call 或 reasoning 參數，先讀相應官方文件與模型限制。不要因為 OpenAI 相容就假設所有 OpenAI 參數都被接受。

如果一次請求同時帶入長 system prompt、歷史對話與工具結果，應在送出前估算 prompt token，並把估算值和 max completion token 一起寫入本地預算。輸出上限不是實際輸出量，但它可能影響限流與預估成本；低量試用應用較小上限，讓一次錯誤不會消耗整個課程的預算。

用量回讀與估算

成功回應時保存 usage.prompt_tokens、usage.completion_tokens 與 usage.total_tokens，同時保存模型、時間、試用狀態與本地任務 ID。usage 是請求結果的證據，不是下一次可用 Credits 或 free credit 的即時保證；控制台的月度 Credits、試用餘額與到期狀態仍要按課程設計重新讀回。

當本地估算與控制台數字不同，採用較小的安全值。輸入包含長歷史、工具結果或圖片時，重新估算預算；不要用「一個 prompt 大約等於幾次 request」當成精確會計。若 API 回應逾時或連線中斷，也不要自動把使用量歸零，因為無法確定請求是否已被平台接收。

一個可重現的實驗應在開始前固定模型、輸入、輸出上限、工具數與截止時間；結束後保存 response ID、usage、狀態碼與免費狀態。若要比較兩個模型，分別使用明確預算，不要在第一個模型不足時偷偷把第二個模型當作無限補位。這樣才能知道差異來自模型品質，還是來自不同的 quota 和上下文大小。

課堂控制器可以每天輸出一份簡短報告：仍在活動窗口的帳戶數、已批准的模型、剩餘 free credit、最早到期時間、成功與停止的請求數、以及任何 paid fallback 嘗試。報告不含 key、prompt 或完整回應，只供管理者決定是否繼續。任何 paid fallback 嘗試都應被視為安全事件，而不是普通的重試。

當活動結束，清理 adapter 中的試用 secret、停用臨時 key、刪除暫存回應，並把文件狀態改為 EXPIRED。保留官方條款 URL 與查核日期即可，不保留帳戶資料或可重新登入的憑證。下一次若 StepFun 再推出活動，建立新研究版本，不直接復活舊狀態。

這個收尾流程也適用於個人學生：把試用狀態與研究結果保留，把登入資訊與秘密刪除。若日後需要重新驗證，只能由本人依官方流程重新查核，不能從舊檔案恢復憑證或自動發起新請求。

試用的期限、用途與資料分類都要被記錄在同一份作業說明內，避免只記得模型名稱而忘了停止條件。

完成作業後，管理者可以用這份說明確認哪些請求屬於免費試用，哪些請求必須另行申請付費與資料審核；這也是後續重新開啟任何 provider 前的最小證據。

任何未記錄的請求都不算通過驗收，先停機再補證據。完整記錄才能繼續，再行決定。

這是試用安全的最後一道防線，完成後才可進入下一輪研究。

任何新活動都要重新查核，不能沿用過期的免費狀態；記錄與驗收必須同步，資料與憑證不得混存，安全優先，持續更新與複核，必要時重做，直到證據完整。

超額與錯誤要停止

• 401：key 缺失、失效或格式錯誤；停止並查 secret，不把 key 放到錯誤訊息。
• 403：可能是 plan、模型、帳戶或付款狀態問題；不要充值、不要切標準 API，交人工確認。
• 429：可能是模型、endpoint 或服務層限流；等待新的狀態讀回，不用第二個帳戶繞過。
• 400／404：檢查 endpoint、model ID、參數與協定；不要猜測新的模型名稱。
• Credits／free credit 用完：立即停止。官方定價說後續可能從 paid balance 扣除，學生 agent 不得自動接受這個分流。

function classifyStepFunFailure(error) {
  if (error?.status === 401) return { action: 'STOP_REVIEW_API_KEY', retry: false };
  if (error?.status === 403) return { action: 'STOP_REVIEW_PLAN_AND_BILLING', retry: false };
  if (error?.status === 429) return { action: 'WAIT_AND_REFRESH_QUOTA', retry: false };
  if (error?.status === 400 || error?.status === 404) return { action: 'STOP_REVIEW_ENDPOINT_MODEL', retry: false };
  if (error?.code === 'ETIMEDOUT') return { action: 'STOP_UNTIL_REQUEST_STATE_IS_KNOWN', retry: false };
  return { action: 'STOP_AND_ESCALATE', retry: false };
}

免費試用最怕「錯誤後自動重試」，因為每次重試可能都在消耗 prompt 或 free credit。若課程需要重試，外層控制器才可以在新的 quota read-back、有限次數、等待時間與人工批准下重送。主要 agent 的預設是停止，不是把錯誤藏在 fallback 裡。

資料與試用條款的邊界

StepFun 是雲端模型服務，學生 agent 的預設輸入應是公開或 synthetic data。不要把未公開作業、個資、公司機密、cookie、API key、登入資訊或受限制的程式碼送進試用。若要測試工具呼叫，工具結果也要先去識別化；避免模型把秘密回傳到日誌或下游服務。

一次性活動也有使用條款、促銷結束時間與帳戶資格。不得透過邀請、批量註冊、代理、token 輪換或其他自動方法取得超出本人一次試用的額度。試用結束後若要繼續使用，必須重新走付費與資料治理審核，不由主要 agent 自動升級。

適合學生的短期作業

• 在活動有效期內，用五個公開問題測試 Flash Mini 的短回答與 JSON 格式化。
• 記錄一次任務的 prompt token、completion token、total token 與 free credit／Credits 讀回。
• 比較「一個短 request」和「含歷史與工具結果的多輪任務」對 Credits 消耗的影響。
• 演練 endpoint 錯誤、429、free credit 不足與試用到期時的安全停機。
• 在活動截止後重新打開官方條款，確認 agent 會拒絕過期 trial，而不是繼續碰標準 paid API。

不適合的任務包括長時間爬蟲、無限 agent loop、 production API、共用課堂 key、重複註冊、邀請刷券、試用到期後自動付費，以及把 Flash Mini trial 當成 OpenAI 或 Anthropic 的永久替代品。這篇文章的價值在於讓學生學會讀懂期限、Credits、token usage 和 billing stop，而不是追求把一次試用榨到最後一個請求。

放行清單與過期處理

StepFun 只有在活動尚未結束、本人帳戶確實讀到 ACTIVE trial、試用 plan 與 API endpoint 相符、free credit 高於安全餘量、paid fallback 未被啟用、key 在 server-side、模型在 allowlist、資料是公開或 synthetic、且錯誤會停止時，才可放進學生 agent 的人工批准清單。活動截止時間一到，所有未完成的候選都重新查核，不繼承舊文章的 READY 狀態。

若控制台沒有顯示 free credit、到期日、是否會扣 paid balance 或試用 voucher 的來源，狀態就是 REVIEW_REQUIRED。不自行猜測，不充值，不建立第二帳戶，也不將 StepFun 的標準 API 當作免費 fallback。日期限定的活動完成後，應留在歷史索引，等待下一次由官方條款明確重新開放的活動。

官方來源與最後判斷

本文以 StepFun 官方試用促銷條款、官方方案頁、Step Plan quick start、Step Plan overview、定價概覽、價格與限流、付費服務條款 與token count API為依據。活動日期與帳戶資格容易變動，使用前必須重新開啟官方條款與控制台讀回。

最後結論：StepFun 15 天 Flash Mini trial 可以作為日期限定的學生 API 實驗，但不是可持續捕獲、永久免費或可重複註冊的 token 燃料。只在活動有效、free credit 與 plan 狀態可讀回、paid balance 被鎖住、低量任務可停止時使用；活動截止或狀態不明就立即排除。免費試用的正確用途，是教學生如何在期限、用量與付款邊界內安全整合 agent。

本文沒有代為註冊 StepFun、建立 API key、啟用試用、建立 voucher、充值、呼叫真實 API 或發布 WordPress；本機只保存官方研究與不含秘密的範例。下一篇會沿用同一閘門，繼續研究下一個可驗證的官方免費或試用 API 入口。