Cohere Trial API Key 免費試用怎麼用？用 Command A+ 建立學生 AI Agent

Cohere 的 trial API key 可以成為學生 AI Agent 的第八種燃料，但它的定位是免費、限量、適合學習與 proof of concept 的 evaluation key，不是可以無限供應的 production token。Cohere 官方目前說明，註冊後可建立免費的 trial key；官方限流頁同時標示 trial keys 每月最多 1,000 次 API calls。Chat API 多數列出的試用速率是每個 model 每分鐘 20 次，Embed、Rerank、Tokenize 與其他 endpoint 則有各自不同的限制；當日敲門模型可先查 command-a-plus-05-2026，但仍需以帳戶 model read-back 為準。

這個方案很適合拿來教學生 RAG、embedding、rerank、tool use、structured output 與 Agent adapter。但免費不等於沒有資料風險：Cohere 最新 Privacy Policy 說明，Trial Users 的輸入與輸出可能被收集，用於研究、開發、產品效能與安全改進，並提醒不要把個人資料送進 trial environment。因此主要 AI Agent 接入前，必須先建立公開資料閘門、配額帳本、失敗分流和人工停止線。

本篇只介紹如何從 Cohere 官方入口建立自己的試用 key，以及如何以不暴露秘密的方式讓受控 adapter 使用它。不代收、不索取、不分享別人的 key，也不透過多帳戶、代理服務、輪換 token 或偽造請求來規避限額。若試用額度用完，正確作法是停止或改用已審核的替代燃料，等待管理者決定是否升級 paid production key。

Cohere trial key 是什麼

Cohere 官方把 API key 分成 evaluation/trial key 與 production key。Trial key 是免費但受限的學習入口，可以拿來測試不同模型、建立個人專案與完成 proof of concept；production key 則是付費、限制較高，適合公開服務與正式流量。這兩個名稱不能混用，尤其不能把「可以註冊」解讀成「有永久免費生產額度」。

Trial key 的真正燃料單位不是一個固定的 token 數。官方主要用 API calls、每分鐘 request、每分鐘 input 數量與 endpoint-specific limit 管理使用量，Chat 回應也會回傳 tokens 與 billed_units 等 metadata。學生要保存請求數、輸入輸出 token、model、endpoint 和時間，而不是只看畫面上還能不能按下送出。

如果課堂目標是理解主要 AI Agent 的 routing，可以把 Cohere trial key 當作一個受限 provider：短摘要走 Chat，公開文件先用 Embed，候選文件再交給 Rerank，最後以 Chat 產生帶引用的回答。這樣學生學到的是完整資料流與錯誤處理，不是把所有工作塞進一次超長 prompt。

免費額度與付費 tier 必須分開

截至本篇查核日，Cohere 官方限流文件寫明 trial keys 以及部分較新的 Chat model variant，每月上限為 1,000 API calls。Chat API 表中，Command A+、Command A、Command R+、Command R、Command R7B、North Mini Code 等列出的 trial rate limit 是每分鐘 20 requests。這些數字是官方目前公開表格的狀態，未來可能變更，啟動時仍需重新讀取 dashboard 與限流文件。

其他 endpoint 不能沿用 Chat 的數字。官方目前列出的試用限制包含 Audio Transcriptions 每分鐘 5 requests、Embed 每分鐘 2,000 inputs、Embed Images 每分鐘 5 inputs、EmbedJob 每分鐘 5 requests、Rerank 每分鐘 10 requests、Tokenize 每分鐘 100 requests；未列出的 Default endpoint 則是每分鐘 500 requests。這些是 requests 或 inputs，不等於 token，也不等於每天可永久使用的保證。

免費試用若不能滿足正式吞吐量，官方路徑是升級 production key，而不是建立更多 trial key。Production 使用通常會產生費用，組織管理者也要確認 SaaS agreement、資料政策、模型限制與使用目的。學生的 adapter 應把 production provider 標成需要管理者批准的狀態，不要在前端提供「自動升級」或輸入付款資料的流程。

從官方入口建立自己的 trial key

官方 Installation 文件建議先在 Cohere Platform 註冊或登入，再從 API keys 頁建立 trial key。這個流程的安全邊界很簡單：學生只能建立並管理自己的帳戶和自己的 key；如果是學校或社團帳戶，則由明確授權的組織管理者建立 project、分配權限與設定停止線。文章不會放任何可用 secret，也不會把 dashboard 截圖當成 token 分享給讀者。

const apiKey = process.env.COHERE_API_KEY;
if (!apiKey) throw new Error('Set COHERE_API_KEY in the server environment');

const response = await fetch('https://api.cohere.com/v2/chat', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'command-a-plus-05-2026',
    messages: [{
      role: 'user',
      content: '只整理公開資料，列出三個重點與一個需要人工查證的地方。'
    }],
    max_tokens: 180
  })
});

if (!response.ok) throw new Error(`Cohere request failed: ${response.status}`);
const result = await response.json();
console.log(result.message?.content ?? result);

這段 JavaScript 使用環境變數和 server-side request，COHERE_API_KEY 只是變數名稱，不是實際 key。範例選用當日模型頁列為 Live 的 command-a-plus-05-2026；Model ID、API version 和參數仍要以當日 Cohere API reference 與帳戶 model read-back 為準。若課堂只想練習 adapter，也可以先把 fetch 替換成 mock response，確認 routing、帳本和錯誤分流後，再由有權限的管理者做一次低量 smoke。

當日敲門模型：先查 Command A+

截至 2026 年 8 月 24 日，Cohere 官方模型總覽把 command-a-plus-05-2026 列為 Live，支援文字與影像、Chat endpoint，context 欄位為 128K；Command A 的模型頁則把它列為目前 API 的模型 ID。它適合拿來測試學生 Agent 的短摘要、結構化輸出、影像理解或工具路由，但「目前可用」不代表 trial key 取消每月 1,000 calls 或每分鐘 20 requests 的限制。

第一個 smoke 只送公開資料，將輸出上限設小，回讀 model、endpoint、usage、status 與是否產生 citations；再視課程需要比較 command-a-03-2025 或 command-a-reasoning-08-2025。如果帳戶的 model list、trial rate limit 或 endpoint capability 不同，adapter 應停止並要求人工更新 allowlist，不要自動切到相似名稱。

不要把 key 放在學生瀏覽器

API key 是 bearer secret。只要前端 JavaScript、瀏覽器 localStorage、mobile app bundle、公開 notebook、Git repository 或聊天 prompt 能讀到它，就不能再視為受控秘密。學生畫面應只傳送 student_id、task_id、data_class、model allowlist 和任務內容給內部 gateway；gateway 再從 server-side environment 或 secret manager 取出 provider key。

如果 key 不小心出現在 commit、截圖或 log，先撤銷並重建自己的 key，再檢查使用量與 access logs。不要把舊 key 貼到社群請人代查，也不要用另一個 key 覆蓋事故。對學生來說，最重要的學習是知道 secret exposure 是安全事件，並能說出 revoke、rotate、audit 和最小權限的差異。

組織使用時，可以讓每個 class project 擁有自己的 key 與 usage owner，但建立 project 的目的應是隔離與觀測，不是把月度試用額度倍增。若官方或組織帳戶的額度是共用的，多個 project 仍可能在同一個上層限制下消耗資源。任何「建立十個帳戶就能拿十倍免費量」的建議，都應視為規避政策而拒絕。

用 Chat API 練習主要 Agent

Cohere Chat 適合做小型 routing、摘要、分類、公開資料問答與格式化回覆。主要 AI Agent 可以先將任務拆成意圖判斷、資料檢索、回答生成和人工驗收四段，每段都記錄 provider、model、endpoint、prompt version、輸入 token、輸出 token 和結果狀態。Trial key 的價值在於提供這個流程的真實限流經驗，而不是讓學生無限制地重跑相同 prompt。

對每個任務先設定 max_tokens、最大重試次數與總預算。輸出只要求完成題目所需的長度，避免把非常大的上限當作「比較聰明」。如果回應包含 metadata，將它轉成不含 prompt 內容的 usage record；需要除錯時也只保存 request id、status、model 和截短後的錯誤分類。

若學生要做 RAG，回答應附上實際使用的 document id 或引用片段，並讓人工檢查來源是否真的支持結論。Cohere 官方 RAG 文件也提醒，RAG 會降低幻覺風險但不保證答案正確；因此引用欄位是可驗證性工具，不是自動通過課堂作業的證明。

Embed 與 Rerank 是另一種免費學習路徑

如果主要 Agent 的問題是找資料，而不是直接生成長文，可以把 trial key 的低量額度用在 Embed 和 Rerank。Embed 把公開文件與使用者問題轉成向量，Rerank 再對少量候選文件重排。這種拆法能讓學生觀察 chunk size、向量相似度、rerank top_n、來源品質和最終回答之間的關係。

Embed 的限制以 inputs 為單位，Rerank 則以 requests 為單位，兩者都不能直接換算成「還剩多少 token」。應先用固定的公開小資料集做 baseline，例如十篇沒有個資的課堂文章，再記錄每次 query 的候選數、輸入長度、回應時間和命中來源。資料集固定後，才看得出 provider 限制與 prompt 變更的差異。

不要把第三方網站內容直接批量送入試用 API。先確認來源授權、robots、個資和課程用途，再做去識別化與截短。向量本身也可能洩漏文件特徵；學生 Agent 的資料閘門要把原文、embedding、rerank 結果和 log 一起納入保存期限與刪除政策。

Cohere RAG 的引用與人工驗收

Cohere 官方 RAG 文件示範以 documents 傳入上下文，回應可以帶有 citations。主要 Agent 應要求每個重要敘述對應 document id、標題或來源 URL；若模型沒有給出引用，或引用的段落與回答不一致，就標記為需要人工查證，不要自動發布或把它送進下一個有副作用的工具。

課堂評測可以分成四類：來源完整且回答正確、來源存在但回答超出證據、沒有足夠來源而應拒答、以及 API 失敗。四類都要有固定答案或人工判準。Trial key 的限額不應讓學生只測成功案例；429、401、400、空文件、超長 context 和格式錯誤才是 adapter 是否可靠的關鍵。

Tool use 與 structured output 的安全邊界

Cohere 官方工具文件說明，Chat API 可以讓模型提出工具名稱和參數，應用程式再決定是否執行。這不代表模型擁有工具權限。主要 Agent 必須先驗證 tool name、JSON schema、欄位長度、資料分類、學生權限和是否需要人工確認，再執行 allowlist 裡的讀取型工具。

適合學生的第一個工具可以是讀取固定公開資料集、計算簡單統計或查詢本地 mock database；不適合一開始就開放付款、刪除、發布、shell、寄信或讀取整台電腦。即使 trial key 不會自動收費，工具副作用仍可能造成資料遺失或對外誤操作，所以要和 token 預算分開管控。

Structured output 能約束 JSON 的欄位、型別和 required fields，但不能保證資料真實、引用正確或工具安全。解析失敗時，adapter 應保存 schema error 的分類，退回人工或重新要求較短的格式；不要把整個原始 prompt、key 或工具回傳的秘密寫入 debug log。

Trial environment 的資料政策

Cohere Privacy Policy 最新版本針對 Trial Users 說明，Cohere 會收集使用者提交給 Cohere Products 的內容和產品產生的輸出，並可能用於研究與開發，包括分析使用趨勢、改善效能與安全。官方也說明這些 trial 與 research environment 不適合處理 personal information，並要求不要在輸入中提交個人資料。

因此學生可以先用公開課本片段、自己撰寫的無識別資料、公開規則和 synthetic records；不要送出姓名、電話、地址、學號、病歷、付款資料、帳號 cookie、API key、公司機密或尚未公開的研究資料。如果作業必須處理個資，應停在本地 mock，改由老師與組織管理者評估合約、DPA、enterprise tier 或其他合規部署。

資料閘門最好在 provider adapter 之前執行，讓 Agent 知道拒絕原因是 data_class、secret_like、personal_information、oversize 或 provider_limit。拒絕事件只保存類別和 request id，不保存原始敏感內容。這樣學生學到的是可審計的安全控制，而不是在呼叫後才發現資料已經離開本機。

用 401、402、429 與 5xx 做分流

Cohere 官方錯誤文件把 401 用於缺少、無效或過期的 API key；402 表示帳戶達到 billing limit；429 表示超過 rate limit。這三種不能共用無限重試：401 要停下並檢查自己的 secret，402 要交給有付款權限的管理者，429 才適合用有限次數的退避。若是 400、422 等輸入錯誤，應修正 request；若是 5xx，則記錄並在有限重試後人工接手。

async function callCohere(call) {
  const maxRetries = 2;

  for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
    const response = await call();
    if (response.ok) return response;

    if ([400, 401, 402, 403, 404, 422].includes(response.status)) {
      throw new Error(`Stop and review Cohere status ${response.status}`);
    }

    const retryable = response.status === 429 || response.status >= 500;
    if (!retryable || attempt === maxRetries) return response;

    const waitMs = Math.min(8000, 750 * 2 ** attempt);
    await new Promise((resolve) => setTimeout(resolve, waitMs));
  }

  throw new Error('Cohere retry budget exhausted');
}

這段程式只是低量、無副作用請求的 retry skeleton，不是繞過限制的工具。實際 adapter 還要加入 request id、idempotency 判斷、Retry-After 或 provider header、整體課堂預算和 circuit breaker。遇到 429 時，不要把同一個 prompt 同時送給十個 endpoint；遇到 402 時，不要偷偷換成未知代理或別人的 key。

把每月 1,000 calls 變成課程預算

若以官方目前的每月 1,000 calls 作為保守基線，老師可以先保留 10% 做健康檢查和最後回歸，20% 做失敗案例，剩下的再分配給 Chat、Embed、Rerank 和學生作業。這不是 Cohere 的保證配額，而是課堂內部的預算模型；正式啟用前仍要以帳戶當日限制和 endpoint 表格為準。

每一個 task 先獲得一個小額 quota，例如一次作業最多兩次生成、四次檢索和兩次 rerank；失敗時不會自動無限增加。學生若需要更多次測試，先把 prompt、來源和預期結果固定，再用本地 mock 重播，最後才用 trial key 做一個實際確認。這能把珍貴的免費 calls 用在學習 provider 行為，而不是重複打字。

燃料帳本至少保存時間、student_id、task_id、endpoint、model、預估 input/output token、實際 usage、status、retry count 和人工驗收結果。不要保存 API key、完整個人資料或不必要的原文。若 dashboard 與本地帳本不一致，先停止批次工作，檢查 Playground、其他 project、重試與共用帳戶，再決定是否恢復。

適合學生的 Cohere 任務

• RAG 小實驗：用固定公開文件測試 chunk、Embed、Rerank 與引用品質。
• Agent routing：根據任務類型選 Chat、Embed、Rerank 或本機模型。
• 格式驗收：用 structured output 產生固定 JSON，再由程式驗證欄位和人工判準。
• 限流演習：故意使用 mock 429、401、402、422 和 500，檢查停止與退避是否正確。
• 不適合用途：個資、秘密、未公開研究、正式 production、無限背景任務與任何付款自動化。

主要 AI Agent 的 Cohere adapter

主 Agent 不應把 Cohere key 直接交給學生，而應提供一個明確的 provider adapter。adapter 收到任務後，先檢查 data_class、student_id、approved_endpoint、approved_model、max_tokens、monthly_budget、allow_tools 和 citation_required；通過後才向 Cohere 發送請求。回應交回主 Agent 時，只包含清理後的內容、引用、usage 摘要、provider status 和可供 UI 顯示的停止原因。

如果 Cohere 失敗，fallback 也要受 allowlist 控制。公開摘要可以轉到另一個已查核 provider；含有來源引用的 RAG 任務則可能先排隊；需要工具副作用的任務則直接停下。fallback 不應改變資料政策，也不應把同一份被拒絕的個資送到更多服務。

主要 Agent 可以為每個 provider 實作同一個介面，例如 generate、embed、rerank、estimate、health 和 revoke，但各 provider 的限制要保留在 capability manifest。Cohere 的 Chat 每分鐘 requests、Embed inputs 和 Rerank requests 不能被抽象成一個模糊的「token remaining」欄位。

不要把 trial key 變成班級共用秘密

一把 key 貼在班級聊天室，短期看似方便，實際上會讓所有人共享限額、無法追蹤責任，也可能讓秘密被轉發。更安全的做法是由管理者在後端保存 key，學生透過登入後的 task endpoint 使用受限能力；每次呼叫掛上 student_id 和 task_id，達到個人配額就停止。

如果課堂只是練習 API，也可以讓學生用自己的 trial key，但要明確說明這是自己的帳戶、自己的使用量和自己的資料責任。老師不應要求學生把 key 回傳給自己，也不應在作業繳交欄位收集完整 secret。作業只交程式碼中的環境變數名稱、mock 結果和不含秘密的驗收紀錄。

免費方案的停止線與交接

當每月 calls 接近內部保留值、某個 endpoint 觸發 429、帳戶出現 402、key 失效、資料閘門拒絕，或 Cohere 隱私政策與課程要求不再相容時，Cohere adapter 應立即停止新增工作。停止畫面要說清楚是暫時速率限制、帳務狀態、認證問題、資料風險還是課程預算用完，不能只顯示一個「AI unavailable」。

停止後保留不含秘密的結果、usage 摘要、最後成功時間和人工決策。要繼續課程時，可以改用本機模型或另一個已完成官方查核的 provider；若要升級 Cohere production key，則由管理者重新確認費用、條款、資料處理、模型限制和回滾方式。免費 trial 不應成為沒有 owner 的永遠背景服務。

給學生的安全清單

• 只從 Cohere 官方 dashboard 建立自己的 trial key，不索取或分享他人的 key。
• 把 trial 理解成免費但受限的 evaluation 使用；官方目前表格列出每月 1,000 calls，並非永久無限額度。
• 依 endpoint 分開看 Chat、Embed、Rerank、Tokenize 和 transcription 的限制，不把 request、input 和 token 混為一談。
• key 只放 server-side environment 或 secret manager，不放瀏覽器、Git、截圖、notebook 和 prompt。
• Trial User 不送個資、秘密、付款資料、cookie、未公開研究或第三方機密。
• 429 有限退避；401、402、403、404、422 和資料拒絕要停止並交給正確 owner。
• 不建立多帳戶、不輪換 token、不使用未知代理、不用共用 key 規避官方或組織的限額。

結語：把 Cohere 試用額度變成可驗證的學習燃料

Cohere trial API key 的優點是入口清楚、免費試用可使用多個模型與 API，而且很適合用來教 RAG、embedding、rerank、引用、tool use 和限流處理；它的限制也同樣清楚：目前官方標示每月 1,000 API calls，Chat 與其他 endpoint 有不同速率，Trial User 的資料可能被用於研究與產品改進。即使 command-a-plus-05-2026 是當日敲門模型，這些條件仍讓它適合課堂實驗，不適合被誤寫成永久免費的主要 production token。

若要接到主要 AI Agent，先在沒有真實 key 的本地環境測試 capability manifest、公開資料閘門、citation 驗收、usage 帳本、429／401／402 分流與撤銷流程，再由有權限的管理者做一次低量 smoke。本文目前只完成官方文件查核與本地草稿驗收，沒有代替任何人建立 Cohere key，也沒有對 Cohere 發出真實 API 請求。更多 Agent 基本邊界可延伸閱讀 YOLO LAB AI Agent 常見問題。

下一次課堂回顧時，請同時比較成功答案、被限流答案、被資料閘門拒絕的答案，以及切換到本機模型後的差異，讓學生看到燃料管理本身也是 Agent 工程的一部分。

官方來源： Different Types of API Keys and Rate Limits、How Does Cohere’s Pricing Work、Installation、An Overview of Cohere’s Models、Command A、Going Live with a Cohere Model、Errors、Retrieval Augmented Generation、Tool Use Parameter Types、Cohere Privacy Policy。