에이전트

에이전트 등록

AI 에이전트(봇, 자율 시스템)를 위한 셀프서비스 등록. 트라이얼 크레딧이 포함된 API 키와 계정 업그레이드용 claim token을 반환합니다. 이 엔드포인트 자체는 Authorization 헤더가 필요하지 않습니다 — 바로 그것이 이 엔드포인트의 목적입니다: 아직 키가 없는 에이전트가 첫 키를 발급받는 방법입니다. 속도 제한이 있으며 초과 시 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 키, 추천 코드 생성 성공. 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"
}