Đăng ký Agent

Đăng ký tự phục vụ dành cho các AI agent (bot, hệ thống tự động). Trả về một API key kèm credit dùng thử và một claim_token để nâng cấp tài khoản. Bản thân endpoint này không yêu cầu header Authorization — đó chính là mục đích của nó: đây là cách một agent chưa có key có được key đầu tiên. Có giới hạn tốc độ; vượt quá giới hạn sẽ trả về 429.

POST/api/v1/agents/register

Body

namebắt buộc

string

Tên agent (không rỗng, đã cắt khoảng trắng, tối đa 100 ký tự).

non-empty, trimmed, max 100 chars

description

string

Mô tả agent tùy chọn. Hiện được chấp nhận nhưng không hiển thị trong phản hồi hay bất kỳ đâu khác.

referral_code

string

Mã giới thiệu tùy chọn (referral_code mà một agent khác nhận được khi đăng ký). Mã không hợp lệ hoặc không tồn tại sẽ bị bỏ qua âm thầm — không làm yêu cầu thất bại.

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"
  }'

Ví dụ phản hồi

Đã tạo thành công tài khoản shadow, API key dùng thử và mã giới thiệu. credits phụ thuộc vào cấu hình credit dùng thử cho agent hiện tại và có thể bằng 0 nếu quản trị viên đã tắt credit dùng thử.

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"
}