Começando com a Claude API na Coreia — migração do OpenAI SDK, latência em Seul e tokens em coreano

Respondemos de uma vez às perguntas mais frequentes dos desenvolvedores que usam a Claude API na Coreia. Compare os preços com os da Anthropic, veja a latência medida em Seul, saiba se cartões emitidos no país podem ser usados e aprenda a migrar do OpenAI SDK alterando apenas uma linha.

Primeira chamada em 5 segundos

O Kunavo é 100% compatível com o protocolo de comunicação da OpenAI. Se você já usa o OpenAI SDK, o custo da migração é alterar apenas base_url uma linha. Exemplo em Python:

from openai import OpenAI

client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",  # 이 한 줄만 바꾸면 끝
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "한국어로 인사해주세요"}],
)
print(resp.choices[0].message.content)

Node.js / TypeScript funciona da mesma forma:

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: "서울 오늘 날씨 알려줘" }],
});
console.log(resp.choices[0].message.content);

O cadastro é gratuito e o pagamento é pré-pago (pay-as-you-go), a partir de $10, cobrando apenas o que for usado; o saldo não expira. Você pode testar amplamente Claude Opus 4.7, Sonnet 4.6 e Haiku 4.5. Com uma única chave compatível com OpenAI, você chama não apenas Claude, mas também Gemini, GPT e modelos de imagem e vídeo.

Diferença de preço em relação à sede — custo da Claude API

Kunavo oferece os modelos Claude a preços 30% mais baratos que os preços oficiais da Anthropic. Claude Sonnet 4.6 custa na sede $3.00 para entrada e $15.00 para saída (por 1 milhão de tokens), enquanto no Kunavo a cobrança é de $2.10 para entrada e $10.50 para saída (cerca de 30% de desconto). Usando o cache de prompts, as leituras do cache custam 10% da tarifa de entrada — ou seja, é possível reler efetivamente por $0.21/1 milhão de tokens. Consulte Resumo de preços e pagamentos da Claude API e a página de preços para ver os preços completos por modelo e os métodos de pagamento.

Latência em Seul

A entrada do Kunavo é uma rede edge anycast, e o TLS é encerrado no nó mais próximo. O gateway em si é executado em uma única região US-East (Ashburn, Virgínia). O que a edge reduz é a ida e volta do handshake TLS, não o trecho que atravessa o Pacífico — ao fazer uma chamada de Seul, o tempo de ida e volta é dominado pela distância física entre Seul e o leste dos Estados Unidos, somada ao tempo de inferência do próprio modelo. Chamar diretamente us-east-1 da Anthropic percorre o mesmo trecho. O streaming é implementado como passthrough de SSE, portanto o Time-to-first-token é igual ao do upstream.

Pagamento — cartões locais, Kakao Pay?

Os pagamentos são processados pela Stripe. Métodos disponíveis para clientes na Coreia:

• Cartões de crédito/débito: Visa, Mastercard, American Express, JCB
• Apple Pay, Google Pay (quando configurado no Chrome·Android), Link (pagamento com um clique)
• Quando o checkout exibe won sul-coreano: KakaoPay, Naver Pay, PAYCO, Samsung Pay, cartões nacionais

Os preços são definidos em dólares americanos ($USD), e a Stripe faz a conversão automática para won sul-coreano no momento do checkout. Essa taxa de câmbio inclui uma taxa de conversão de 2–4% paga pelo comprador, que não é cobrada quando o pagamento é feito em dólares (documentação do Stripe Adaptive Pricing, verificada em 2026-10-03). O valor mínimo da recarga é de US$ 10 (aproximadamente 14.000 won). Como funciona como uma carteira pré-paga, e não como uma assinatura, o saldo não utilizado não expira.

O KakaoPay aparece como método de pagamento para adicionar saldo ao Kunavo, e o Toss não é compatível. KakaoPay, Naver Pay, PAYCO, Samsung Pay e cartões nacionais só aparecem quando o checkout exibe won sul-coreano; nesse fluxo, os cartões nacionais não precisam estar habilitados para pagamentos internacionais. Ao pagar em dólares, é necessário um cartão habilitado para pagamentos internacionais (se o bloqueio de pagamentos internacionais estiver ativado, é preciso desativá-lo no aplicativo da administradora do cartão). Esses métodos adicionam saldo ao Kunavo; não são pagamentos feitos diretamente à Anthropic.

Custo dos tokens ao usar coreano

O Claude oferece qualidade equivalente à do inglês na entrada e saída em coreano. No entanto, o coreano consome cerca de 1,5 a 2 vezes mais tokens que o inglês (aproximadamente 0,5 a 0,7 token por caractere). Leve isso em consideração ao calcular o preço.

A distinção entre linguagem honorífica e informal é especificada com mais segurança no prompt do sistema:

“Você é um atendente de suporte ao cliente na Coreia. Escreva todas as respostas obrigatoriamente em linguagem honorífica (-습니다/-입니다) e responda aos clientes de forma educada e gentil.”

Guia de escolha de modelos

• Claude Opus 4.7 — a maior capacidade de raciocínio. Adequado para tarefas complexas que exigem compreensão de nuances em coreano, resumos de contexto longo e geração de código.
• Claude Sonnet 4.6 — equilíbrio entre preço e capacidade. É o modelo mais adotado por startups coreanas. Adequado como modelo principal para chatbots, geração de conteúdo e agentes.
• Claude Haiku 4.5 — rápido e barato. Para classificação, filtragem, resumos simples e pré-processamento de agentes. Custa cerca de 1/10 do Sonnet.

Próximos passos

1. Cadastre-se gratuitamente — carregue a partir de US$ 10, pague conforme o uso, sem expiração do saldo
2. Crie uma chave de API compatível com OpenAI — basta alterar base_url para continuar usando o SDK da OpenAI
3. Faça sua primeira chamada com chat completions — Claude, Gemini e GPT no mesmo endpoint
4. Veja os preços da API do Claude · Entenda as formas de pagamento · Compare alternativas ao OpenRouter

Envie suas perguntas para contact@kunavo.com. Responderemos em até 1 dia útil.