사용 방법

1. Block 찾기

로그인 없이도 Blocks 페이지에서 전체 Block을 검색하고 Built-in/BYOK로 필터링할 수 있습니다. 카드를 누르면 상세 페이지에서 Input/Output 스키마, curl·Python 예시 코드, 브라우저에서 바로 실행해보는 “Try it out”을 볼 수 있습니다.

2. 회원가입 & API Key 발급

1. 회원가입에서 이메일/비밀번호로 가입합니다.
2. 대시보드의 “API Key” 메뉴에서 새 키를 발급합니다.
3. 발급 직후 딱 한 번만 원문 키(ab_live_...)가 보입니다 — 그 자리에서 반드시 복사해두세요. 이후엔 서버도 원문을 다시 보여주지 않습니다.

3. SDK로 호출하기 (Python)

pip install apibazzar

from apibazzar import Client

client = Client(api_key="ab_live_...")

result = client.run(
    "translation",
    data={"text": "Hello", "target_language": "Korean"},
)
print(result)  # {"translated_text": "안녕하세요"}

4. curl로 직접 호출하기

curl -X POST https://api.apibazzar.com/v1/execute \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"slug": "calculator", "data": {"expression": "(2 + 3) * 4"}, "secrets": {}}'

응답은 {"result": {...}} 형태로, result 안에 그 Block의 output 스키마를 따르는 값이 들어있습니다.

5. Built-in vs BYOK

Built-in Block은 준비 없이 바로 호출할 수 있습니다. BYOK(Bring Your Own Key) Block (번역/OCR/요약 등 LLM을 쓰는 Block)은 호출자가 본인의 외부 API Key를 직접 준비해야 합니다 — 요청마다 secrets로 실어 보내거나, 대시보드 “Secret 관리”에 한 번 등록해두면 이후 자동으로 채워집니다. 어느 쪽이든 APIBazzar 자체 이용료는 없습니다. 어떤 API Key가 필요한지는 각 Block 상세 페이지에 안내돼 있습니다(현재는 전부 OPENAI_API_KEY).

6. 에러/제약

• API Key가 없거나 틀림 → 401
• 계정이 정지됨 → 403
• Block이 없거나 slug 오타, 입력값이 스키마 위반 → 400 (구체적인 사유 포함)
• 요청이 너무 잦음(API Key당 분당 60회, 전역 분당 300회) → 429
• 요청 body가 너무 큼(최대 8MB) → 413

7. 직접 Block을 등록하고 싶다면

로그인 후 대시보드의 “Block 등록”에서 이름·설명·입출력 스키마 등을 먼저 등록할 수 있습니다. 등록 직후엔 본인만 볼 수 있는 초안(draft) 상태입니다.

지금은 다른 사람이 만든 코드를 안전하게 격리해서 실행하는 Sandbox가 아직 없어서, 등록만으로 바로 실행되지는 않습니다. “심사 제출”을 누르면 운영자가 요청 내용을 직접 확인하고, 실제 구현 코드를 작성·테스트한 뒤 배포하는 방식으로 진행됩니다 — 안정성과 보안을 위해 당분간은 이렇게 운영합니다. 제출 후에는 “내가 등록한 Block” 화면에서 진행 상황(심사 대기 → 승인/반려)을 확인할 수 있고, 반려되면 사유도 함께 표시됩니다. 원하는 기능이나 참고할 코드가 있다면 피드백 이나 이메일 문의로 함께 알려주세요.