BazaarLink 자주 묻는 질문
AI API, 모델, 결제, 보안과 개발자 연동에 필요한 핵심 답변을 확인하세요.
BazaarLink는 OpenRouter와 무엇이 다르며 대체할 수 있나요?
둘 다 OpenAI 호환 통합 API를 제공합니다. BazaarLink는 대만 결제·전자 통일영수증, 중국어 지원과 대만 달러 표시 가격을 추가로 제공하며 모델 정보는 카탈로그에서 확인해야 합니다.
OpenRouter 또는 OpenAI API에서 어떻게 이전하나요?
base_url과 API 키를 BazaarLink 값으로 바꾸고 전체 모델 ID를 확인한 뒤 streaming, tool calling과 오류 처리를 테스트하세요.
어떤 결제 수단이 대만 전자 통일영수증을 제공하나요?
충전 화면에서 영수증 발급 가능으로 표시된 TWD 결제 수단을 선택하고 결제 전에 사업자 정보를 입력하세요.
OpenAI SDK, Cursor와 Claude Code를 지원하나요?
사용자 지정 endpoint를 허용하는 OpenAI 호환 도구를 지원하며 Claude Code에는 Anthropic Messages 호환 endpoint도 제공합니다.
BazaarLink는 어떤 용도에 적합한가요?
여러 모델 공급자, 대만 사업비 처리, 중국어 지원과 공개 Probe 데이터가 필요한 팀에 적합합니다.
대만 전자 통일영수증이 필요하면 결제 전에 무엇을 확인해야 하나요?
대만 전자 통일영수증은 현재 실제로 제공되며 결제 화면에 발급 가능으로 표시된 결제 방식 또는 확인된 기업 결제 계약에서만 제공됩니다. 결제 전에 최신 정보를 확인하고, 회사 통일번호·견적·월별 청구가 필요하면 영업팀에 먼저 문의하세요.
무료 API 키에 신용카드가 필요한가요?
카드 없이 계정과 API 키를 만들 수 있으며 당시 제공되는 무료 모델을 사용할 수 있습니다. 제공 범위와 한도는 무료 API 페이지에서 확인하세요.
무료 할당량을 모두 쓰면 어떻게 되나요?
잔액이 있으면 유료 요금으로 계속할 수 있고 없으면 재설정을 기다리거나 충전해야 합니다. 고정 할당량을 약속하지 않습니다.
어떤 API 형식과 기능을 지원하나요?
Chat Completions, Responses, Embeddings와 미디어 기능 및 Anthropic Messages API를 제공하며 기능은 모델마다 다릅니다.
모델 ID, 가격과 context window는 어디서 확인하나요?
/api/v1/models 또는 모델 카탈로그의 전체 ID를 사용하고 각 모델 페이지의 최신 사양을 확인하세요.
API rate limit은 얼마인가요?
한도는 계정, 플랜과 모델 설정에 따라 달라집니다. HTTP 429가 오면 Retry-After 또는 backoff를 적용하세요.
Prompt와 모델 응답을 저장하나요?
일반 성공 요청은 모델, 토큰, 시간과 비용 같은 운영 기록을 주로 보관하며 전체 Prompt와 응답을 표준 기록으로 저장하지 않습니다.
API 키와 BYOK 자격 증명은 어떻게 보호하나요?
BazaarLink 키는 단방향 hash로, BYOK 자격 증명은 암호화해 저장하며 TLS와 안전한 키 교체를 지원합니다.
Upstream 공급자가 중단되면 어떻게 되나요?
가능한 경우 다음 provider 또는 모델로 fallback하며 모두 실패하면 처리 가능한 오류를 반환합니다. 클라이언트도 timeout과 retry를 구현해야 합니다.
HTTP 402, 429, 502, 503은 무엇을 뜻하나요?
402는 잔액·예산, 429는 rate limit, 502는 upstream 실패, 503은 사용 가능한 route가 없거나 일시 중단임을 주로 뜻합니다.
결제 또는 API 문제는 어디에 문의하나요?
지원 페이지나 support@bazaarlink.ai로 시간, request ID, 모델 ID와 안전한 오류 정보를 보내고 전체 API 키는 보내지 마세요.
ZDR(제로 데이터 보존) 키란 무엇이며 어떻게 켜나요?
ZDR를 켠 API 키의 요청은 제로 데이터 보존을 표명한 업스트림 공급자에게만 전달되며 BazaarLink가 고정 지정합니다. 일반 경로로 우회하지 않습니다. 이 키의 프롬프트와 응답은 저장하지 않고 기본적으로 외부 콘텐츠 심사 서비스에도 보내지 않습니다. 개인 키는 /keys에서 켤 수 있고 조직 관리자는 조직 설정에서 모든 키에 ZDR를 요구할 수 있습니다. 현재 대화 엔드포인트(chat completions, messages, responses)를 지원하며 ZDR 경로가 없는 모델은 다른 경로로 우회하지 않고 400(zdr_route_unavailable)을 반환합니다.
ZDR 키를 BYOK, BYOC 또는 가상 모델과 함께 쓸 수 있나요?
쓸 수 없습니다. ZDR 키는 직접 설정한 BYOK/BYOC 공급자 키를 무시하고 항상 BazaarLink의 ZDR 경로에서 플랫폼 가격으로 과금됩니다. byok-custom/ 또는 byoc/로 시작하는 모델은 400(zdr_route_unavailable)을 반환합니다. 가상 모델(vm/), 자동 라우팅(auto), :free·:online 같은 접미사와 models 대체 목록은 ZDR에서 지원되지 않아 400(zdr_endpoint_unsupported)을 반환합니다. 자체 공급자 키를 쓰려면 ZDR이 꺼진 키를 사용하세요.
추론 모델이 빈 응답을 반환했는데 왜 요금이 부과되나요?
추론(reasoning) 모델은 답변 전에 추론 토큰을 생성합니다. max_tokens가 너무 작으면 추론이 한도를 모두 써 버려 응답의 finish_reason이 length가 되고 보이는 내용이 없습니다. 추론 토큰은 실제로 생성되었으므로 OpenAI와 마찬가지로 사용량에 따라 과금됩니다. max_tokens를 늘리거나 reasoning effort를 낮추면 피할 수 있습니다. 로그 페이지에서는 이런 요청을 "추론에 한도 소진, 출력 없음"으로 표시합니다.