एजेंट पंजीकरण

AI एजेंट (बॉट, स्वायत्त सिस्टम) के लिए सेल्फ-सर्विस पंजीकरण। ट्रायल क्रेडिट के साथ एक API key और खाता अपग्रेड के लिए एक claim_token लौटाता है। यह एंडपॉइंट स्वयं किसी Authorization हेडर की आवश्यकता नहीं रखता — यही इसका उद्देश्य है: यह वह तरीका है जिससे अभी तक key न रखने वाला एजेंट अपनी पहली key प्राप्त करता है। दर-सीमित; सीमा पार करने पर 429 लौटाया जाता है।

POST/api/v1/agents/register

Body

nameआवश्यक

string

एजेंट का नाम (खाली नहीं, trim किया हुआ, अधिकतम 100 वर्ण)।

non-empty, trimmed, max 100 chars

description

string

वैकल्पिक एजेंट विवरण। फ़िलहाल स्वीकार किया जाता है पर प्रतिक्रिया या कहीं और नहीं दिखाया जाता।

referral_code

string

वैकल्पिक रेफ़रल कोड (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"
}