NIUBIGEO API / V1

把真人測試,
接入你自己的工作流。

透過 API 計算費用、下單真人測試和文章服務、查詢積分及交付紀錄。任務由人工完成,API回傳訂單狀態。

先算費用,再下訂單。

以下是請求範例,不是測試結果:2 題 × 2 個 AI × 2 人 = 8 次提問,共 40 積分。瀏覽器模式可選 incognito(無痕)、normal(一般)或 not_applicable(App 等不適用場景)。問題可用換行字串或字串陣列傳入;忽略空行,保留重複問題。單筆最多 500 題、20 個 AI、每題 100 人,總提問次數不超過 10,000。

{
  "termsVersion": "2026-09-09.3",
  "questions": "有什么适合小团队的项目管理工具?\nNotion 和飞书分别适合什么团队?",
  "aiTypes": [
    "ChatGPT",
    "豆包"
  ],
  "peoplePerQuestion": 2,
  "browserMode": "incognito",
  "region": "上海",
  "timeWindow": "工作日 14:00–18:00,Asia/Shanghai",
  "device": "桌面 Chrome",
  "questionStyle": "按原题输入,不追问"
}

將請求保存為 human-test.json,呼叫公開計價API,不扣積分。範例使用正式網域;本地預覽時,請換成目前頁面地址。

curl -X POST https://niubigeo.ai/api/v1/quotes/human-tests \
  -H 'Content-Type: application/json' \
  --data-binary @human-test.json

創建訂單使用 POST /api/v1/orders/human-tests,請求體相同,並增加兩個請求頭:

X-Niubigeo-Key: 你的平台 API Key
Idempotency-Key: 每笔新订单生成一个 UUID

新訂單和儲值請求還需在 JSON 中提交 "termsVersion":"2026-09-09.3"。請先閱讀使用須知積分規則,提交此欄位即表示接受對應版本;版本與時間會隨訂單或儲值申請保存。積分僅限本站消費,不提供轉讓交易、提領或兌換法定貨幣功能,法定權利不受影響。

平台 Key 透過 [email protected] 開通,與 OpenRouter Key 分開使用。伺服器端按目前公開價格計費,下單時扣積分。網路失敗後,以相同內容和冪等鍵重試,不會重複扣款;同一鍵提交不同內容會回傳 409。

API列表

方法 / 路徑(前綴 /api/v1)用途認證
GET /catalog公開價格、方案和 50 積分起充規則公開
POST /quotes/human-tests計算真人測試費用,不創建訂單公開
POST /quotes/content計算文章方案費用公開
GET /account目前帳戶餘額平台 Key
GET /ledger積分流水平台 Key
POST /orders/human-tests創建真人測試訂單並扣積分平台 Key + 冪等鍵
POST /orders/content創建文章訂單並扣積分平台 Key + 冪等鍵
GET /orders查詢自己的訂單平台 Key
GET /orders/{id}查詢訂單與交付紀錄平台 Key
POST /orders/{id}/cancel取消尚未開始的訂單,退回積分平台 Key
POST /topups登記人工儲值申請,餘額不變平台 Key + 冪等鍵
GET /topups查詢儲值申請與確認狀態平台 Key

所有 POST 請求使用 application/json,請求本文最多 256KB。列表支援 offset,每頁最多 50 筆。儲值和建立訂單需提供 8–128 個字元的 Idempotency-Key。訂單、餘額與交易紀錄僅回傳目前帳戶的資料。

下載 OpenAPI 定義 ↗

文章、儲值和訂單狀態

文章請求範例:{"package":"articles30","quantity":1,"brief":"产品域名、目标用户与内容需求","termsVersion":"2026-09-09.3"}。article 為 350 積分,articles30 為 8,888 積分,articles90 為 28,888 積分,價格均包含人工發布費。

儲值請求體:{"credits":50,"termsVersion":"2026-09-09.3"}。提交後僅登記為 pending;人工確認收到付款後改為 confirmed,並記入積分流水。暫不支援線上支付API。

訂單狀態依次為 pending(等待人工處理)、in_progress(處理中)、completed(已交付)。pending 訂單可取消,變為 cancelled,積分全額退回;重複取消不會重複退款。已開始的訂單如需調整,請聯繫人工。completed 訂單的 delivery 欄位包含人工整理的交付紀錄。

常見狀態碼:401 Key 無效、402 積分不足、404 無存取權限或資源不存在、409 冪等鍵衝突或目前狀態不允許、422 參數無效、428 尚未接受目前的條款版本。錯誤回傳 {"error":"说明","code":"错误类型"}。呼叫這些API不會自動執行模型或發布內容。

已有平台帳戶?檢視積分與訂單

1 積分 = ¥1,50 積分(¥50)起充。聯繫 [email protected] 開通帳戶和人工儲值。暫不支援線上支付。

這是 niubigeo 服務帳戶 Key,與首頁的 OpenRouter Key 分開使用。

請填寫 NiubiGEO 服務 Key。相關查核紀錄將在 24 小時內刪除,不與其他網站或第三方共享。 詳情見隱私說明。

客製人工測試

告訴我們要測試的情境,我們會確認執行範圍和排程。

提交只登記需求,不扣積分。目前沒有線上付款,執行條件與排程由專人確認。也可以直接寄信至 [email protected]