브라질 개발자가 Claude API를 프로덕션에서 실행하기 위한 실용 가이드입니다. Anthropic 직접 이용과의 가격 차이, Pix 및 카드 결제, 상파울루에서의 지연 시간, LGPD와 세금계산서 등 첫 호출 전에 중요한 모든 내용을 다룹니다.
5초 만에 첫 호출
Kunavo는 OpenAI wire 프로토콜과 호환됩니다. 코드가 이미 OpenAI SDK를 사용한다면 base_url에서 한 줄만 변경하면 전환할 수 있습니다. Python에서는:
from openai import OpenAI
client = OpenAI(
api_key="sk-kn-...",
base_url="https://api.kunavo.com/v1", # só essa linha muda
)
resp = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Se apresente brevemente em português."}],
)
print(resp.choices[0].message.content)Node.js / TypeScript에서도 동일합니다:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.KUNAVO_API_KEY!,
baseURL: "https://api.kunavo.com/v1",
});
const resp = await client.chat.completions.create({
model: "claude-opus-4-7",
messages: [{ role: "user", content: "Resuma este artigo em 3 tópicos." }],
});
console.log(resp.choices[0].message.content);가입은 무료입니다. $10부터 충전하고 사용한 만큼만 결제(pay-as-you-go)하며 잔액은 절대 만료되지 않습니다. Claude Opus 4.7, Sonnet 4.6, Haiku 4.5를 충분히 테스트할 수 있습니다.
Anthropic 직접 이용과의 가격 차이
Kunavo의 Claude 모델은 모델에 따라 Anthropic 공식 가격보다 30% 저렴합니다. Claude Sonnet 4.6의 직접 이용 가격은 토큰 1M개당 input $3,00 / output $15,00이며, Kunavo에서는 $2,10 / $10,50(30% 저렴)입니다. 프롬프트 캐싱을 사용하면 안정적인 접두사를 다시 읽는 비용은 input 가격의 10%, 즉 토큰 1M개당 $0,21입니다. 모든 모델의 전체 가격은 /pricing에 있습니다.
상파울루 / 리우에서의 지연 시간
Kunavo는 단일 US-East 리전(Ashburn, Virginia)에서 실행되며, TLS를 사용자와 가까운 위치에서 종료하는 anycast edge 뒤에 있습니다. edge가 단축하는 것은 TLS 핸드셰이크이지 미국까지의 이동이 아닙니다. 상파울루, 리우 또는 브라질리아에서의 왕복 시간은 미국 동부 해안까지의 물리적 거리와 모델 자체의 추론 시간이 좌우합니다. 브라질에서 Anthropic을 직접 호출해도 정확히 같은 경로를 거칩니다.
스트리밍 응답은 업스트림과 동일한 첫 토큰까지의 시간으로 도착합니다. 버퍼링도 배칭도 없습니다. 실시간 고객 지원이나 대화형 에이전트처럼 지연 시간이 중요한 작업에서는 큰 차이를 만듭니다.
결제 — Pix 및 국제 카드
Stripe를 기본 결제 시스템으로 사용합니다. 브라질 고객에게는 다음 방법을 제공합니다:
- Pix(즉시 결제, 헤알로 표시되는 금액) — 국제 신용카드가 필요하지 않습니다
- 국제 카드: Visa, Mastercard, American Express
- Apple Pay, Google Pay 및 Link
Boleto는 제공되지 않으며, 결제 페이지에 표시되지 않는 브라질 국내 카드 브랜드 Elo 및 Hipercard도 마찬가지입니다. 브라질에서 발급된 카드는 해외 결제가 활성화되어 있어야 합니다. 결제가 거부되면 은행 앱에서 이를 확인하거나, 이 조건이 필요 없는 Pix로 결제하세요.
가격은 USD로 표시되며 Stripe가 결제 시 BRL로 환산합니다. 환율은 해당 시점의 Stripe 환율을 사용하며, 구매자가 부담하는 2~4%의 환전 수수료가 이미 포함되어 있습니다(2026-10-03에 확인한 Stripe Adaptive Pricing 문서). 최소 충전 금액은 $10 USD입니다. 구독은 없으며 선불 지갑 방식이고 잔액은 만료되지 않습니다.
IOF, 세금 및 세금계산서
국제 신용카드 거래에는 현재 IOF 3.5%가 부과됩니다(적용 세율을 확인하세요). Pix도 마찬가지입니다. Stripe에 따르면 브라질 고객이 해외 기업에 결제하면 IOF가 부과되며, 은행 앱에 결제 금액과 합산되어 표시됩니다. Pix로 충전하는 전체 절차는 Pix로 API 결제하는 방법 안내를 참고하세요. Kunavo는 브라질 세금계산서나 청구서를 발행하지 않으며 결제 페이지에서도 세금 서류가 생성되지 않습니다. 날짜, 금액, 상태가 표시된 충전 내역은 결제 대시보드에서 확인할 수 있습니다. 회계 처리를 위한 증빙이 필요하면 contact@kunavo.com으로 문의하세요.
LGPD 및 데이터 저장 위치
라우팅 로직은 TLS만 종료하는 Anycast Edge가 아니라 단일 US-East 리전(Ashburn)의 게이트웨이에서 실행됩니다. 청구 및 계정 데이터는 매일 암호화된 볼륨 스냅샷을 생성하는 단일 기본 데이터베이스에 저장됩니다. 요청은 업스트림 공급자에게 전달되며, 장애 조치 시 공급자는 바뀌지만 모델은 바뀌지 않습니다. 업스트림 공급자는 자체 약관에 따라 프롬프트 내용을 처리합니다. Kunavo는 데이터 처리 계약(DPA), Zero Data Retention 또는 미국 외 데이터 레지던시를 제공하지 않습니다. 요청은 미국에서 처리된 후 업스트림 공급자에게 전달됩니다. 팀에 DPA, ZDR 또는 브라질이나 EU의 데이터 레지던시가 필요하면 모델 공급자(Anthropic, OpenAI 또는 Google)와 직접 계약하세요.
포르투갈어 지원
저희 팀은 contact@kunavo.com으로 보내는 포르투갈어 이메일에 영업일 기준 하루 안에 포르투갈어로 답변합니다.
자주 묻는 질문
- Pix를 사용할 수 있나요? 네, Stripe 결제창을 통해 사용할 수 있습니다. 결제 수단으로 "Pix"를 선택하세요.
- IOF를 내야 하나요? 국제 신용카드에서만 부과됩니다. Pix에는 없습니다.
- BRL로 세금계산서를 발행하나요? 아니요 — Kunavo는 NF-e나 인보이스를 발행하지 않습니다. 충전 내역의 증빙이 필요하면 contact@kunavo.com으로 문의하세요.
- LGPD 준수와 DPA가 제공되나요? Kunavo는 DPA를 제공하지 않으며 요청은 미국에서 처리됩니다. DPA가 필요하다면 모델 제공업체(Anthropic, OpenAI 또는 Google)와 직접 체결하세요.
- 브라질 모델 / Sabiá가 있나요? 아직 카탈로그에 없습니다. /models를 확인하고 변경 로그를 구독하세요.
시작할 준비가 되셨나요? 무료로 가입하고 $10부터 충전한 뒤 5분 안에 첫 Claude 호출을 해 보세요. 브라질에서 문의하시나요? contact@kunavo.com으로 직접 연락해 주세요. 포르투갈어로 답변해 드립니다.