Chinese LLM API 免費試用：運作方式與常見問題

關於試用

我能獲得什麼免費內容？

每個新帳戶都會獲得 $0.50 額度。該額度自註冊起有效期為七天，領取時無需輸入付款資訊。該額度適用於付費帳戶所使用的相同端點和相同模型，因此你測試的內容即為生產環境將使用的內容。

$0.50 能支撐多少用量？

這取決於你的提示詞，以下提供一個帶有明確假設的說明。假設每個請求發送 1,000 個輸入 token 並接收 500 個輸出 token。每百萬個輸入 token 價格為 $0.25，每百萬個輸出 token 價格為 $1.00，則一個請求的成本為 $0.00025 加上 $0.0005，即 $0.00075。因此，$0.50 大約可覆蓋 660 次此類請求。較短的交談會更節省額度，而長上下文呼叫則會較快耗盡額度。

試用期結束時會發生什麼事？

如果七天過去或額度已用完，請求會返回 HTTP 402 錯誤，代碼為 no_credit。資料不會被刪除。儲值預付額度後，同一支金鑰即可再次使用。沒有訂閱制，且儲值額度永不過期。

我需要新增付款資訊才能開始嗎？

不需要。註冊僅需電子郵件和密碼。金鑰會在 get-your-key 頁面 註冊完成後立即顯示。

七天的實用計畫

如果你事先決定好要學習的內容，七天時間很充裕。將試用視為小型評估專案，而非隨意探索。以下序列對大多數團隊都很有效：

1. 第 1 天，冒煙測試。 確認金鑰、模型列表以及一次短提示詞補全。以下指令可同時完成這三項。
2. 第 2 至 3 天，使用你的真實提示詞。 將二十到五十個來自你產品的代表性輸入透過 API 執行。將輸出結果與輸入並排儲存，以便同事在不重新執行的情況下進行審查。
3. 第 4 天，錯誤路徑。 故意觸發 400（請求過大）、401（金鑰錯誤），並透過少量突發流量測試 429 和 503 的處理機制。現在看到這些錯誤比在生產環境中看到更好。
4. 第 5 至 6 天，成本模型。 將記錄的 token 數量乘以公布的費率，並根據你自己的流量假設預估每月費用。
5. 第 7 天，做出決定。根據你的需求比較品質、成本與限制，然後決定是否要儲值。

Copyexport API_KEY="paste-your-key-here"

# 1) confirm the key works and see the model id
curl -s https://api.chinesellmapi.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

# 2) one short completion; read the usage block in the reply
curl -s https://api.chinesellmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"用一句话介绍杭州的春天。"}],"max_tokens":120}'

第二次呼叫會返回包含提示詞和補全 token 計數的使用量物件。從第一天開始記錄這些數據；它們是你稍後進行任何成本估算的原始資料。

金鑰與入門

我可以擁有多少支金鑰？

每個帳戶一支。如果需要新的金鑰，請從你的帳戶重新產生。舊金鑰會立即失效，因此請立即更新你的部署，否則你仍在使用舊值時會看到 401 錯誤。

我應該把金鑰放在哪裡？

放在伺服器的環境變數中，例如命名為 API_KEY，且不要放在瀏覽器程式碼或公開儲存庫中。請求會以 Authorization: Bearer <key> 的形式攜帶金鑰。

最小的有效請求是什麼？

使用 GET /v1/models 列出模型，然後向 /v1/chat/completions 發送短提示詞補全請求，模型設定為 uncensored，並設定低 max_tokens。回應中的 usage 欄位會精確顯示該呼叫耗費了多少 token。

我可以使用 OpenAI SDK 嗎？

可以。該 API 與 OpenAI 聊天補全功能相容。將基礎 URL 指向 https://api.chinesellmapi.com/v1，提供你的金鑰，並將模型設定為 uncensored。完整操作指南（包含提示詞和腳本控制）請參閱 快速入門。

限制與功能

提示詞和回覆可以有多長？

上下文視窗為 100,000 token，包含提示詞和補全。max_tokens 設定預設為 2,048，可提升至每個請求 32,000。請求主體最大可達 8 MB。如果提示詞加上 max_tokens 超過視窗限制，API 會返回 400。

我可以發送多少請求？

每支金鑰每分鐘限制為 300 次請求。超過此限制會收到 429。請將批次作業均勻分佈並加入退避機制；翻譯指南 包含一個帶速率控制的批次腳本。

它支援串流輸出和函式呼叫嗎？

兩者皆可。設定 stream: true 以啟用伺服器發送事件，最後一個區塊會包含用量資訊。支援 OpenAI 格式的函式呼叫，且 temperature、top_p 和 stop 等抽樣欄位會原樣傳遞。

哪些功能不可用？

僅提供文字：無嵌入向量、圖片、音訊、影片或微調。僅有一個模型。如果你的專案需要缺少的功能，請計畫將此 API 與其他工具搭配使用以處理該部分。

你可能遇到的錯誤

我應該預期哪些狀態碼？

錯誤會回傳類似 {"error":{"code":...,"message":...}} 的 JSON 格式。400 代表請求格式錯誤，401 代表金鑰無效或遺失，402 為 no_credit，403 為 content_blocked，404 為未知的端點，429 為達到速率限制，503 為 upstream_busy。

哪些錯誤值得重試？

僅 429 和 503。等待、加入隨機抖動並有限次數重試；幾秒鐘的時間足以讓 503 恢復。重試 400、401、402 或 403 不會改變結果。

我已經儲值但仍看到 402，該怎麼辦？

請確認你使用的是最新金鑰，因為重新產生金鑰會使舊金鑰失效。接著確認請求是發往正確的基礎 URL。如果一切正常，請發送一個最小請求並讀取回應主體中的錯誤訊息。

讓試用額度更耐用

額度設計得較小，因此一些習慣能延長其使用時間。測試時請將 max_tokens 設低，因為輸出 token 的成本是輸入 token 的四倍：每百萬個輸出 token 為 $1.00，每百萬個輸入 token 為 $0.25。先使用短而具代表性的提示詞進行測試，僅在短提示詞運作正常後，再使用最長的輸入。避免沒有停止條件的 API 呼叫迴圈，並在程式碼中限制重試次數。

帶有明確假設的範例：評估集包含 50 個提示詞，每個提示詞約 600 個輸入 token，回覆上限為 300 個輸出 token。一次測試需消耗 30,000 個輸入 token 和 15,000 個輸出 token，費用為 $0.0075 加上 $0.015，共 $0.0225。在額度耗盡前，你可以執行該評估集約 22 次，足以充分比較多個提示詞變體。

如果你傳遞非常長的提示詞，請記住每次呼叫都會對整個提示詞計費。一份 40,000 token 的文件傳送二十次，其費用等同於二十次獨立的大型請求，因此請盡可能快取或摘要共用上下文。目前的費率請見 定價頁面，參數詳細資訊請見 文件。

內容規範與隱私

允許哪些內容？

合法的成人內容、小說與具爭議性的主題不會被拒絕。服務對象為 18 歲以上的成年人。針對長篇小說與角色聊天，請參考 小說指南，其中涵蓋提示詞結構與費用說明。

什麼總是會被封鎖？

涉及未成年人的性內容在任何情況下都會被封鎖，並返回 403 錯誤，包括小說和角色扮演。此封鎖無法透過提示詞措辭變更，因此不要重試。

我的提示詞會用於訓練嗎？

不會，提示詞不會用於訓練。