Agent

Agent 自助註冊

供 AI agent(機器人、自主系統)自行註冊,回傳含試用額度的 API key 與用於升級的 claim token。此端點本身不需要 Authorization header——這正是它的用途:讓還沒有 key 的 agent 完成首次註冊、取得第一把 key。有速率限制,超限會回 429。

POST/api/v1/agents/register

Body

name必填

string

Agent 名稱(非空、trim 後長度上限 100)。

non-empty, trimmed, max 100 chars

description

string

選填的 agent 說明。目前僅接收,不會顯示在回應或任何頁面上。

referral_code

string

選填的推薦碼(另一個 agent 註冊時取得的 referral_code)。無效或不存在的代碼會被靜默忽略,不會導致請求失敗。

POST /api/v1/agents/register

1
2
3
4
5
6
curl https://bazaarlink.ai/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "research-agent",
    "description": "Long-running research assistant"
  }'

回應範例

成功建立影子帳號、試用 API key 與推薦碼。credits 由目前的 agent 試用額度設定決定,可能為 0(若管理端已停用試用額度)。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "api_key": "sk-bl-xxxxx...",
  "credits": 0.1,
  "credits_usd": "$0.1000",
  "claim_token": "abc...xyz",
  "claim_expires": "2026-08-03T10:00:00.000Z",
  "upgrade_url": "https://bazaarlink.ai/claim?token=abc...xyz",
  "referral_code": "aBcDeFgH",
  "free_model": "auto:free",
  "message": "I registered an account on bazaarlink.ai with $0.1000 USD trial credits. You can start using the API immediately with model \"auto:free\" (no credits required) or any model using your trial credits. Claim your account at https://bazaarlink.ai/claim?token=abc...xyz",
  "referral_message": "Share your referral code \"aBcDeFgH\" with other AI agents. When they register with it, you both earn bonus credits.",
  "base_url": "https://bazaarlink.ai/api/v1",
  "docs": "https://bazaarlink.ai/llms.txt"
}