Mixedbread 免費 $5 credits 怎麼用？Toast 1 與學生 Agent Retrieval

本篇是免費 token fuel 系列第 92 篇，研究 Mixedbread Search 的 Starter 免費入口。Mixedbread 官方 Pricing 目前列 Starter 可用一次性 USD 5 credits、免信用卡、3 個 workspace users、10 個 stores 與 100 requests/min；它提供 embeddings、reranking、文件解析和多模態 Store search。這是 retrieval fuel，不是一般聊天模型的免費 token 池，也不是每月自動補回的額度。

本篇分類為 CONDITIONAL_MIXEDBREAD_STARTER_5_ONE_TIME_SEARCH_CREDITS_FREE_DATA_POLICY_REVIEW。它對主要 AI agent 的價值，是把公開或 synthetic 的 PDF、圖片、文件、程式碼、音訊與影片整理成可搜尋的 Store，再回傳帶有 file id、chunk index、score 與來源欄位的 retrieval evidence。它不是讓 agent 無限上傳資料的免費資料庫。

本文只做官方文件整理，不代註冊、不建立或取得 API key、不上傳檔案、不執行 live search、不建立 public store、不購買 credit、不連 MCP、不進行 WordPress 外部寫入。Mixedbread Free Tier 的 Privacy Policy 與 Terms 對 usage data 是否可用於 model training 的表述並不一致，因此文章把這個矛盾列為資料停止線。

Mixedbread 的角色和單純 embedding endpoint 不完全相同：它把檔案解析、分塊、向量化、搜尋、rerank、結果整理與部分 agent workflow 放在同一個 managed search surface。這可以減少學生自己維護向量資料庫的工作，但也讓資料、帳務、刪除和 provider policy 集中在同一個外部服務。

對主要 agent，這個 provider 最好被標記為 retrieval_only 或 grounding_sidecar。planner 可以提出 query，gateway 才能依 allowlist 搜尋；模型不能自行建立 Store、打開 public、上傳任意檔案、修改 billing 或把搜尋結果當成系統指令。

如果要把 retrieval evidence 接回文章、報告或 SEO 工作流，必須保留來源、版本、檔案雜湊、chunk index、查核時間和人工 verdict。這和只取得一個漂亮的自然語言摘要不同；摘要可以協助閱讀，不能替代可回讀的原始證據。

學生也可以先使用本地 JSON fixture 模擬 Store、file status、search response、429、402 和 delete response，測試 adapter 的狀態機。只有當 mock 的 credit reserve、data policy、rights、retention 和人工接手路徑都通過，才值得消耗一次性 Starter credit。

本系列對免費方案的共同原則，可先參照 YOLO LAB AI agent 使用 FAQ。Mixedbread 的特殊地方是它不只產生 token，而是替 agent 管理一個會保存文件與索引的 Store，所以每次工作都要同時檢查用量與資料生命週期。

免信用卡只降低開通門檻，不等於免帳戶、免 authentication、免 Terms、免 API usage logs、免 source license 或免下游模型成本。Starter 用完後的 402、paid upgrade 或 Scale prompt 都是 owner decision，agent 不可以把它當成一般 retry。

一次性 credit 的正確策略是小步驟與可預估的 fixture：先少量 ingestion，再少量 search，再人工核對 result，最後刪除。不要讓背景 job 以每分鐘輪詢的方式消耗 credit，也不要為了測試 ranking 而把同一份文件重複建立在多個 Store。

任何「Free」「Starter」「one-time」標籤都要附查核日期與官方來源。若下一次讀回的 Pricing、Terms、Privacy、API limits 或 account dashboard 已不同，舊文章只能作為歷史紀錄，不能繼續當成新請求的批准證據。

先把五美元說準

官方 Pricing 目前寫 Starter「Try Mixedbread with $5 in one-time credits」與「No card required」。這是一次性 usage credit，不是五美元現金、不是五百萬固定 tokens、不是每月 $5，也不是每個學生各有一份。Pricing 沒有在同一段承諾 monthly reset，因此主要 agent 應把它記為 one_time_credit，不能寫成 monthly_free_tokens。

五美元可能被 indexing、search、rerank、OCR、transcription、summary、storage 或 agent model 消耗；官方 Pricing 以 content tokens、query、storage 與 model token 分別列價。尤其 `mixedbread/web` 是特別的 web store，每個 query 依 search with rerank 計費。課程必須先設定單次檔案、query、top_k、搜尋次數和總 credit safety reserve，再做 canary。

function classifyMixedbreadFuel(snapshot) {
  if (snapshot.provider !== 'MIXEDBREAD') return 'PROVIDER_MISMATCH';
  if (snapshot.plan !== 'STARTER') return 'PLAN_RECHECK';
  if (snapshot.creditType !== 'ONE_TIME') return 'CREDIT_UNIT_REVIEW';
  if (snapshot.paymentMethodAttached) return 'PAYMENT_OWNER_REVIEW';
  if (snapshot.freeDataPolicyConflict) return 'FREE_DATA_STOP';
  if (snapshot.remainingCredits <= snapshot.safetyReserve) return 'CREDIT_STOP';
  return 'RETRIEVAL_CANARY_ALLOW';
}

它是 managed retrieval sidecar

Mixedbread 官方 Overview 將服務定義為給 applications、agents 和 AI systems 使用的 multimodal search API。Store 是搜尋索引，檔案上傳後由平台處理 parsing、chunking、embedding 與 indexing；agent 用自然語言 query 找相關 chunks，再把 evidence 交給主要模型。這可以補上模型對長文件、圖片、表格、程式碼與影片的檢索能力。

主要 agent 不把 Mixedbread 當成 planner 的永久記憶。它應該把搜尋結果視為外部 evidence，保存 query、store id、file id、chunk index、score、source URL、retrieval time 和人工 verdict。回答仍要回到原始 chunk 驗證；高分不等於事實，摘要也不等於原始文件。

Starter 的範圍與非範圍

官方 Pricing 的 Starter 表目前列 3 workspace users、10 stores、100 requests/min 與 $5 one-time credits。官方 Changelog 又提到 Free Tier users 可使用最多 1,000 store files 與核心平台功能；這些是不同維度，不能把 10 stores、1,000 files 和 $5 credits 相乘成無限知識庫。

Store、file、chunk、query、search result 和 Toast 1 agent model 都要分開記錄。Store 數量上限不是檔案數量上限；檔案數量上限也不是 credit；workspace user 上限不代表可以把同一個 API key 貼給三個學生。任何 plan、file count、credit、rate limit 或 data policy 未讀回，就停在 PLAN_READBACK_REQUIRED。

截至 2026-08-25 的敲門模型：Toast 1，但不是免費模型

本次查核把 Mixedbread Pricing 目前列出的 Toast 1 當作 model entry，但必須寫清楚：它是以 Starter 一次性 credit 支付的 agent model，不是「免費模型」或固定免費 token。官方價格表目前列 Toast 1 input launch price $0.30／1M LLM tokens、output $0.72／1M LLM tokens，且 search usage 另計；因此學生 agent 要把 model token、search query、content token、storage 與剩餘 credit 分開記帳。

function admitMixedbreadModel(snapshot) {
  if (snapshot.model !== 'Toast 1') return 'MODEL_REVIEW_REQUIRED';
  if (snapshot.creditType !== 'ONE_TIME') return 'CREDIT_SCOPE_RECHECK';
  if (snapshot.searchCostSeparate !== true) return 'SEARCH_COST_READBACK_REQUIRED';
  if (snapshot.freeModelEntitlement === true) return 'FREE_MODEL_CLAIM_STOP';
  return 'CREDIT_FUNDED_CANARY';
}

如果當日 Pricing、workspace plan 或 dashboard 不再列出 Toast 1，或 credit、search、model rate、data policy 任一欄位無法讀回，就回到 MODEL_REVIEW_REQUIRED。這段只定義課程的 read-back gate，不代表目前帳戶已開通、已取得 API key 或已成功執行任何 request。

免費資料政策存在矛盾

Mixedbread Privacy Policy 目前寫 Free Tier users 的 usage data，包括 model logs、queries 和相關資訊，會以原生形式收集，用於 service improvement、analytics 和 research；同一段又寫不使用 Free Tier user data 做 model training，且資料 retained indefinitely。這已足以讓課程拒絕私有資料、個資與未公開研究。

Terms and Conditions 的 Free Tier 段落則寫 usage data、queries 和其他 input 可用於 model training、analytics、service improvement 與 research，並 indefinite retention。這與 Privacy Policy 的「不做 model training」說法不一致。本文不替 provider 做法律解釋，直接將兩份一手文件的差異標記為 FREE_DATA_POLICY_CONFLICT，直到 owner 取得明確的當日書面確認前，只允許 public／synthetic fixture。

這個矛盾不能用「我沒有上傳秘密」來完全消除，因為 query 本身也可能洩露研究題目、客戶名稱、產品路線或尚未公開的結論。Free Tier 的安全 fixture 不只要移除檔案內容，也要把 query、metadata、filename、external_id 和 Store name 做匿名化。

檔案刪除與 usage log retention 也是兩個不同事件。刪除 Store 可以移除文件、chunks、embeddings、metadata 和處理記錄，但不能據此宣稱 Free Tier 的 query logs、model logs、IP 或其他 usage data 同步消失。課程報告只保存必要的查核結果，不複製完整 provider log。

對公開資料也要做來源與授權判斷。公開技術文件、公開規格、合成手冊與自己擁有的程式碼比較適合 canary；網路抓到的 PDF、圖片、音訊、影片和第三方 repo 仍要確認再處理、embedding、OCR、轉錄與摘要權利。

對同一份 fixture 反覆測試時，可以在本地快取 content hash 和預期 chunk，先比較 mock 結果，再決定是否需要消耗 real search。這能避免學生為了調整 top_k、query wording 或 rerank flag，不斷重新 ingestion 或重複查詢。

如果搜尋結果要交給下一個主要模型，packet 只帶最小必要文字和來源，不把整個 Store 或所有 chunks 全量送入 context。這不只節省 Mixedbread 和下游模型成本，也能降低 prompt injection、誤引用和資料外洩的表面。

Free Tier 的用途是驗證 retrieval flow，不是替責任組織完成資料治理。只要 privacy、terms、retention、source rights 或 deletion outcome 有一個不清楚，狀態就應回到人工審查，而不是用更小的 query 或更低的 top_k 來假裝風險已經消失。

主要 agent 可以在 response 中明確標示 evidence_status=unverified，讓下游知道這只是檢索結果，不是已核准的事實。

學生在課堂上應先學會停止、刪除和回報不一致，再追求更高的搜尋分數或更快的延遲。

這種順序能把一次性 credit 留給真正有教學價值的 canary。

function admitMixedbreadData(data, policy) {
  if (!data.publicOrSynthetic) return 'PRIVATE_DATA_STOP';
  if (data.containsPersonalData) return 'PERSONAL_DATA_STOP';
  if (!policy.privacyReadback || !policy.termsReadback) return 'POLICY_READBACK_REQUIRED';
  if (policy.freeTrainingConflict) return 'FREE_DATA_POLICY_CONFLICT';
  if (data.hasThirdPartyRestrictions) return 'RIGHTS_REVIEW';
  return 'LOW_RISK_FIXTURE_ALLOW';
}

API key 只從 owner route 注入

Mixedbread API Reference 目前使用 Authorization: Bearer YOUR_API_KEY，base URL 是 https://api.mixedbread.com/。官方 Introduction 說使用者登入後自行建立 API key，再保存到 `.env`。這是帳戶 owner 的工作，本文不代登入、不建立、不複製、不接收任何有效 key。

主要 agent 只接受 server-side MXBAI_API_KEY，不接受 prompt 內的 key，也不讓模型決定 store identifier、file path 或 upload destination。若平台提供 search-only key，學生 route 應優先使用只讀 scope；寫入、刪除、建立 public store 與修改 billing 由 owner 另外管理。

function buildMixedbreadHeaders(env) {
  if (!env.MXBAI_API_KEY) return { error: 'KEY_NOT_INJECTED' };
  return {
    Authorization: `Bearer ${env.MXBAI_API_KEY}`,
    'Content-Type': 'application/json'
  };
}

這段只展示 header 形狀，環境變數名稱不是 secret，實際 key 不會進入文章或測試。若 key 外洩，owner 應撤銷、檢查 usage、stores、files 與 logs，再建立新 scope；新 key 不會增加 Starter credit，也不是延長免費量的手段。

Store 是可設定生命週期的索引

官方 Create Stores 文件說 Store 有 UUID 和名稱，名稱可以作為搜尋 identifier；private 是預設，只有 organization 可存取。Store 預設不會過期，但可以設定 expires_after，例如以 last_active_at 為錨點的 7 天或 30 天。這對學生 demo 很重要，因為免費資料不應永久堆積。

from mixedbread import Mixedbread
from mixedbread.types import ExpiresAfterParam

mxbai = Mixedbread(api_key="owner-provided-placeholder")
store = mxbai.stores.create(
    name="student-demo-search",
    expires_after=ExpiresAfterParam(anchor="last_active_at", days=7),
)
print(store.id)

上段是官方 SDK 風格的生命週期示例，不執行、不建立真實 Store。要注意 last_active_at 可能會因搜尋、上傳或刪除而重設計時器，因此課程仍要有硬性的 local deleteAt，而不能只信 provider 的自動清理。Store 名稱與學生身份也不要放入公開 URL 或 log。

檔案 ingestion 有自己的狀態機

官方 Create Files 文件把 upload 和 upload_and_poll 分開：upload 立即回傳，status 從 pending 進入 in_progress，再到 completed；completed 才表示 parsing、chunking、embedding 與 indexing 可以搜尋。failed 要查看 last_error，cancelled 則停止處理。搜尋前不應只看 HTTP 201，必須讀回 file status。

external_id 可以用來對應 repository 相對路徑，預設同一 external_id 的新檔案會覆蓋舊檔。這很方便，但也可能把正確資料意外覆寫。學生 adapter 要先計算 content hash、確認 overwrite policy，再決定 upload；不允許模型自行用原始檔名覆蓋既有 Store。

function acceptStoreFile(file, expectedHash) {
  const ready = file.status === 'completed';
  if (!file.id || !file.storeId) return 'FILE_ID_MISSING';
  if (file.contentHash !== expectedHash) return 'FILE_HASH_MISMATCH';
  if (file.status === 'failed') return 'INGESTION_FAILED_REVIEW';
  if (file.status === 'cancelled') return 'INGESTION_CANCELLED_REVIEW';
  return ready ? 'SEARCHABLE_FILE_ALLOW' : 'POLL_WITH_DEADLINE';
}

第一輪只索引一份 synthetic 文件

第一個 canary 使用一份短的 synthetic Markdown 或已確認 public license 的小 PDF，內容放入三個可驗證句子與一個虛構表格。先在本地做 MIME、大小、hash、文字／圖片資料分類與 rights check，再預估 content token、ingestion cost、storage 和 search reserve。不要用同學作業、公司文件、私有 repository 或含個資的 PDF。

若要測圖片、OCR、audio 或 video，另外建立 fixture 與預算；不要在同一個 $5 canary 裡同時嘗試所有 modality。高品質 parsing 可能啟動 OCR、transcription、summary 或 multimodal enrichment，成本和資料暴露面都比 fast parsing 大。沒有必要時先用 fast，並把 config 寫死。

Python SDK 的最小 upload search 形狀

from pathlib import Path
from mixedbread import Mixedbread

mxbai = Mixedbread(api_key="owner-provided-placeholder")
store = mxbai.stores.create(name="synthetic-rag-canary")
file_result = mxbai.stores.files.upload_and_poll(
    store_identifier=store.id,
    file=Path("./synthetic-doc.pdf"),
)
results = mxbai.stores.search(
    query="Which fictional quota is documented?",
    store_identifiers=[store.id],
    top_k=3,
)
print(file_result.status, results.data)

這段依官方 Quickstart 的 SDK 形狀整理，但本文不安裝套件、不建立 Store、不上傳檔案、不呼叫 search。真實執行前要把 placeholder 換成 owner 的 server-side secret，確認 plan、credit、policy、file rights、store expiry 和 deletion route；如果 upload status 沒有 completed，就不進 search。

搜尋結果要帶回原始 chunk

Search API 回傳的 chunk 可能包含 chunk_index、mime_type、model、score、file_id、filename、store_id、metadata、text、image_url、OCR text、summary 或 audio／video transcription。主要 agent 至少要保存 file id、chunk index、score 與原始來源，再回讀 exact chunk；不要只保存摘要或把 signed URL 當成永久資料。

function acceptSearchResults(response, query) {
  if (!response || !Array.isArray(response.data)) return 'SEARCH_SCHEMA_STOP';
  const evidence = response.data.slice(0, 5).map(chunk => ({
    fileId: chunk.file_id,
    chunkIndex: chunk.chunk_index,
    score: chunk.score,
    filename: chunk.filename,
    source: chunk.metadata?.url || chunk.external_id || null,
    textDigest: chunk.text ? chunk.text.length : 0
  }));
  if (evidence.some(item => !item.fileId || item.chunkIndex === undefined)) {
    return 'EVIDENCE_FIELDS_MISSING';
  }
  return { query, evidence, humanReview: 'PENDING' };
}

score 是排序訊號，不是信心保證；chunk text 可能是 OCR、transcription 或模型生成的 summary，也可能含有惡意指令。主要 agent 先把 chunk 標為 untrusted evidence，再依來源、時間、版本與人工抽查做回答。若搜尋結果找不到原始 file 或 chunk，停止生成可發布結論。

Agentic Search 要更嚴格的預算

Mixedbread Search 文件提供 agentic search，agent 可以規劃多次搜尋、重寫 query、執行 Store retrieval，再回傳與一般 search 相容的結果。它適合研究複雜問題，但也可能發生多輪 tool call、更多 query、更多 output tokens 與更難估算的 credit 消耗。學生第一輪只用固定 query 與 top_k，不開 agentic。

若日後批准 agentic route，設定 maximum tool calls、max top_k、單一 Store allowlist、總時間、總 credit reserve 和 human approval。把 provider 的 agent narration 與 evidence 分開保存；不要因為模型說「我已查證」就跳過來源回讀。

function gateAgenticSearch(job, ledger) {
  if (!job.ownerApproved) return 'AGENTIC_OWNER_REVIEW';
  if (job.storeIdentifiers.some(id => !ledger.allowlist.includes(id))) {
    return 'STORE_ALLOWLIST_STOP';
  }
  if (job.maxToolCalls > 3) return 'TOOL_CALL_CAP_STOP';
  if (ledger.remainingCredits <= ledger.safetyReserve) return 'CREDIT_STOP';
  return 'AGENTIC_CANARY_ALLOW';
}

Web Store 不是免費 web search

官方 Web Store 使用 `mixedbread/web` 作為 store identifier，可用同一個 Store API 搜尋網路，並將 URL、title 與 excerpt 放進結果。但 Public Stores 文件明確說 `mixedbread/web` 每個 query 依 search with rerank 計費；它不是免費 web retrieval，也不是把 $5 變成無限網路搜尋的捷徑。

網頁內容還有 freshness、robots、著作權、paywall、prompt injection 與引用問題。若主要 agent 使用 Web Store，保存 query、結果 URL、retrieval time、source title 和 chunk digest；沒有人工查核以前，不把結果直接重寫成 SEO 文章、商業建議或高風險決策。

Public Store 會把帳單轉給呼叫者

Mixedbread Public Stores 文件說 public Store 可以讓其他 organization 使用 public name 搜尋；外部呼叫者的搜尋費用由呼叫該 request 的 API key 承擔，而不是 Store owner。這對公開課程資料有用，但也代表學生若複製別人的 public Store，自己的 Starter credit 仍可能被消耗。

課程預設不建立 public Store、不把 private file 轉 public、不把 owner key 交給外部。若要分享，先選完全公開且有權分享的 synthetic corpus，明確列出 public name、caller billing、資料來源與刪除方式。搜尋外部 Store 仍要經過自己的 rights 與 data gate。

刪除是永久操作

官方 Manage Stores 文件寫 Delete Store 會永久移除 Store 和所有內容；Delete Store File 文件則列出 original file、generated chunks、embeddings、metadata、processing history 與 logs 都會永久移除。這不是可以隨便測試的 API。每次 delete 前要確認 store／file identifier、owner approval、local backup policy 與 deletion evidence。

function approveMixedbreadDelete(target, state) {
  if (!state.ownerApproved) return 'DELETE_OWNER_APPROVAL_REQUIRED';
  if (!target.storeId || !target.fileId) return 'DELETE_TARGET_READBACK_REQUIRED';
  if (target.containsPrivateData && !state.deletionTicket) return 'DELETE_TICKET_REQUIRED';
  if (target.isPublic) return 'PUBLIC_VISIBILITY_REVIEW';
  return 'DELETE_ONE_TARGET_ALLOW';
}

刪除後做 retrieve 或 list read-back，保存 deleted=true、target id、時間與 owner ticket，不保存原始檔案或完整內容。若 provider 的 Free Tier data logs 是 indefinite，刪除 Store 不必然等於所有 usage log 已消失；這正是本篇要求不送私有資料的原因。

Rate limit 是 operation-specific

Mixedbread API Rate Limiting 文件目前依 operation type 分開列 limit 與 burst：Read 1,200、List 600、Write 360、Update 480、Delete 240，window 為 1 minute，且超過會回 429 與 Retry-After。Pricing 的 Starter 100 requests/min 是 plan 層級提示，不能用它覆蓋 operation-specific limit；adapter 取較保守的有效上限。

function routeMixedbreadResponse(status, headers, state) {
  if (status === 401) return 'KEY_STOP';
  if (status === 402) return 'CREDIT_OWNER_REVIEW';
  if (status === 403) return 'STORE_SCOPE_STOP';
  if (status === 404) return 'STORE_FILE_READBACK_STOP';
  if (status === 429) return {
    action: state.retryCount === 0 ? 'BACKOFF_ONCE' : 'THROTTLE_HANDOFF',
    retryAfter: Number(headers['retry-after'] || 0)
  };
  if (status >= 500) return 'TRANSIENT_REVIEW';
  return status >= 400 ? 'INPUT_REVIEW' : 'READBACK_REQUIRED';
}

429 只代表當下限流，不代表 credit 用完；402 也不代表一定是 rate limit。兩者要分開記帳。重試要綁定 operation、store id、file id、query digest、attempt、Retry-After 與 side effect，避免 upload、delete 或 agentic search 因為 timeout 被重複執行。

Content token 與 model token 不同

Mixedbread Pricing 將輸入資料轉換成 content tokens：文件可能以 page 估算，圖片、音訊和影片各有自己的 token conversion；Index fast、Index high quality、storage、search、rerank 與 Toast 1 的 input／output tokens 也有不同單位。這些只是成本估算與 provider metering，不是可交給其他 LLM 使用的 token。

agent ledger 要保存原始檔案 bytes、duration 或 page count、estimated content tokens、actual usage read-back、query count、rerank flag、model、credit before／after 與 error status。若只看到一個搜尋結果，不要假設 ingestion、embedding、storage、query 和 model generation 沒有成本。

建立 retrieval adapter 的最小合約

function makeRetrievalRecord(input, response) {
  return {
    provider: 'MIXEDBREAD',
    storeId: response.storeId,
    fileId: response.fileId,
    chunkIndex: response.chunkIndex,
    queryDigest: input.queryDigest,
    score: response.score ?? null,
    source: response.source ?? null,
    contentClass: input.contentClass,
    policy: 'PUBLIC_OR_SYNTHETIC_ONLY',
    humanReview: 'PENDING'
  };
}

adapter 不保存 API key，不讓模型自由指定 upload path，不把完整 private document 寫入 telemetry，也不把 response text 直接標成 verified。只有在 source、chunk、query、時間、權利與人工 verdict 都存在時，才交給主要 agent 做 grounded answer；否則回傳缺資料或人工接手。

主要 agent 應只拿 evidence

最安全的整合不是讓主要模型直接擁有 Mixedbread API key，而是由 gateway 完成 search，回傳最小 evidence packet：query、source URL、file id、chunk index、片段、retrieval timestamp、score、policy status 和 citation。模型只能基於 packet 回答，不能自行擴充 store、上傳檔案或刪除資料。

若回答要求引用，引用必須指向原始 source 或可回讀的 file／chunk，而不是指向短暫 signed URL。若 source 是 `mixedbread/web`，保存查核日與原始 URL；網頁變動後重新檢查。若 source 內容含 prompt injection，當作資料文字處理，不當作 system instruction。

Starter 只適合小型 RAG canary

推薦順序是：建立 local mock → 讀回 Starter plan 與 one-time credit → 只上傳一份 synthetic file → 等待 completed → 固定 query、top_k=3 → 讀回 file／chunk → 做人工答案比對 → 保存 ledger → 刪除 file 或設定 store expiration。每一步都要能在沒有 live key 的情況下用 mock response 重現。

第二輪才研究 metadata filters、rerank、web store 或多檔案 Store；第三輪才研究 agentic search、Toast 1、multimodal file 或 client-executed tools。任何一輪出現 credit unknown、data policy conflict、private data、public visibility 或 paid prompt，都停在當輪。

function nextMixedbreadStep(state) {
  if (!state.mockPassed) return 'RUN_LOCAL_MOCK';
  if (!state.planReadback) return 'REFRESH_STARTER_PLAN';
  if (!state.dataApproved) return 'CHECK_PUBLIC_OR_SYNTHETIC_DATA';
  if (!state.creditReserved) return 'RESERVE_ONE_TIME_CREDIT';
  if (!state.fileCompleted) return 'UPLOAD_AND_POLL_WITH_DEADLINE';
  if (!state.evidenceRecord) return 'SEARCH_AND_SAVE_EVIDENCE';
  if (!state.humanReview) return 'HUMAN_REVIEW';
  return 'DELETE_OR_EXPIRE_STORE';
}

不要以免費 credit 上傳私有 corpus

即使價格頁寫 no card，資料政策仍可能要求你承擔 query logs、model logs、retention 與 service improvement。學生作業、公司文件、客戶資料、聲音、醫療、學籍、內部 repository、未公開研究與 access token 都不應進 Free Tier。若確實需要 private corpus，先取得 organization 的 data processing approval，或改用本地 retrieval。

同理，公開 PDF 也要查 license、robots、資料來源與是否允許再處理。能被網路下載不等於能被第三方 embedding、OCR、summary 或 rerank。免費 credit 只降低試用成本，不改變原始資料的權利。

Billing 停止線要先於 402

在任何 live canary 前，owner 要確認 Starter、one-time credit、payment method、workspace、store、file、search mode、rerank、web store、auto top-up 或 paid upgrade 狀態。出現 402 Payment Required、credit balance 不足、付款提示或 pricing read-back stale，就停止，不自動充值、不啟用 Scale、不重註冊、不換別人的 key。

刪除與 retention 要有證據

local deletion job 至少保存 store id hash、file id、upload time、data class、owner、deleteAt、delete response、deleted flag 與 read-back time。真正刪除前先確認沒有必要的課程 evidence；刪除後清理本地 PDF、cache、SDK temporary file、search response 與 signed URL。Free Tier logs 可能 indefinite，不能宣稱所有副本立即消失。

何時不應採用 Mixedbread Starter

如果目標是長期免費聊天 token、每月重置模型額度、私有企業資料、production SLA、大量 ingestion、無法接受 usage logs indefinite，或需要法律上明確的 no-training contract，Starter 不是合適預設。如果只想做小型 retrieval、citation、PDF／圖片理解或 agent search canary，才值得在 public／synthetic corpus 上測試。

它最適合被放在主要 agent 的 read-only retrieval adapter 後面。當 credit、rate limit、source rights、policy、store status 或 deletion evidence 不符合條件時，adapter 應回傳 local fallback 或人工 handoff，不讓 Mixedbread 決定主要 agent 的全域狀態。

官方來源與查核範圍

本篇主要依據 Mixedbread Pricing 的 Starter、credits、stores、workspace users、rate limit 與 usage pricing；以 Overview、Quickstart、Create Files、Search 與 Data Models 確認 Store、file status、chunk evidence 與 multimodal search。

帳戶與風險另對照 API Reference、Rate Limiting、Error Handling、Public Stores、Privacy Policy、Terms and Conditions 與 Changelog。Free Tier 的 privacy／terms 差異屬於本篇重要停止條件，使用前要重新讀回當日版本。

若要把這篇方案放進課程實驗，建議把 acceptance 分成 ingest、search、citation 和 delete 四張小表。每張表記錄 fixture hash、store／file 狀態、query、top_k、回傳時間、HTTP status、credit 前後讀值和人類抽查結論；只要其中一格缺少官方可解釋的 read-back，就把結果標成 incomplete，而不是用模型回答看起來合理來補洞。這樣同一個 synthetic corpus 才能在不同 provider 之間比較，不會把 retrieval 品質誤認成聊天模型能力。

學生 agent 的角色也應限制在「提出查詢、保留來源、指出不確定性、請求人工覆核」。它不應自行把課堂檔案送到 public store、不應把搜尋結果當作已核准答案，也不應在 402、429、政策衝突或刪除 read-back 失敗時重試到成功。主要 agent 仍要保留 provider-neutral 的 fallback；Mixedbread 只是一個可停用的 retrieval adapter，不能成為課程資料、付款狀態或整個 agent pipeline 的單一真相。這是學習環境的基本防線。

本篇完成閘門與下一篇

本篇完成條件是：一次性 $5 credit、Starter 限制、content／query／model token 單位已分開；Store、file、chunk、search、agentic search、public web、delete、429、402、API key 與 data policy 有官方來源；Privacy Policy 與 Terms 的 Free Tier 矛盾已明示；沒有真實 secret、沒有 live upload／search、沒有私有資料、沒有外部發布。這是本機草稿完成，不代表某個帳戶仍有 $5。

完成本篇 read-back 後，下一輪再找第 93 篇尚未收錄的官方免費方案。仍以合法發現、官方查核、低風險 fixture、可回復刪除、清楚帳務停止線和學生 agent 實際用途為選擇標準；不把免費 key 分享、資料蒐集或規避限制當成燃料策略。