ブログ一覧へ戻る
ガイド·2026年5月24日·読了5分

韓国でClaude APIを始める — OpenAI SDK移行、ソウルからの遅延、韓国語トークン

韓国の開発者向けClaude API入門:base_urlを1行変更してOpenAI SDKから移行する方法、ソウルから呼び出す際の遅延の発生箇所、韓国語のトークン消費とモデル選択。モデル別料金と決済方法は、Claude APIの料金・決済ガイドにまとめています。

韓国でClaude APIを使用する開発者から最も多く寄せられる質問に、一度に回答します。Anthropic本社と比較した料金、ソウルでの実測レイテンシ、韓国発行カードでの支払い可否、そしてOpenAI SDKで1行だけ変更して移行する方法まで説明します。

5秒で最初の呼び出し

KunavoはOpenAIワイヤプロトコルと100%互換です。既存のOpenAI SDKを使用している場合、移行コストはbase_urlの1行を変更するだけです。Pythonの例:

quickstart.py
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も同様です:

quickstart.mjs
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);

登録は無料で、$10からチャージして使った分だけ支払う従量課金(pay-as-you-go)であり、残高は失効しません。Claude Opus 4.7、Sonnet 4.6、Haiku 4.5を十分にテストできます。同じOpenAI互換キー1つで、ClaudeだけでなくGemini、GPT、画像・動画モデルまで呼び出せます。

本社との料金差 — Claude APIの料金

KunavoのClaudeモデルはAnthropic公式料金より30%安価です。Claude Sonnet 4.6は本社では入力$3.00、出力$15.00(100万トークンあたり)ですが、Kunavoでは入力$2.10、出力$10.50として請求されます(約30%割引)。プロンプトキャッシュを利用すると、キャッシュ読み取りは入力料金の10%、つまり実質$0.21/100万トークンで再読み込みできます。モデル別の全料金と支払い方法は、Claude APIの料金・支払いまとめと料金ページで確認してください。

ソウルからの遅延

Kunavoの入口はAnycastエッジネットワークで、TLSは最寄りのノードで終了します。ゲートウェイ自体は単一のUS-Eastリージョン(バージニア州アッシュバーン)で稼働しています。エッジが短縮するのはTLSハンドシェイクの往復であり、太平洋を横断する区間ではありません — ソウルから呼び出す場合、往復時間はソウルと米国東部の物理的距離に左右され、そこにモデル自体の推論時間が加わります。Anthropicのus-east-1を直接呼び出しても同じ区間を通ります。ストリーミングはSSEパススルーで実装されているため、Time-to-first-tokenはアップストリームと同一です。

支払い — 国内カード、KakaoPay?

支払いはStripeで処理されます。韓国のお客様が利用できる方法:

  • クレジット / デビットカード: Visa、Mastercard、American Express、JCB
  • Apple Pay、Google Pay(Chrome・Androidで設定済みの場合)、Link(ワンクリック決済)
  • チェックアウトが韓国ウォンで表示される場合:KakaoPay、Naver Pay、PAYCO、Samsung Pay、韓国国内カード

価格は米ドル($USD)で設定されており、Stripeがチェックアウト時に韓国ウォンへ自動換算します。この換算レートには購入者が負担する2~4%の換算手数料が含まれ、ドルで支払う場合はかかりません(Stripe Adaptive Pricingドキュメント、2026-10-03確認)。最低チャージ額は$10 USD(約1万4千ウォン前後)です。サブスクリプションではなくプリペイドウォレット方式のため、未使用残高は失効しません。

KakaoPayはKunavoへのチャージ手段として決済画面に表示されますが、Tossはサポートされていません。KakaoPay・Naver Pay・PAYCO・Samsung Payと韓国国内カードは、決済画面が韓国ウォンで表示される場合に限り表示されます。この経路では、韓国国内カードは海外決済が有効でなくても利用できます。ドルで支払う場合は、海外決済に対応したカードが必要です(海外決済がブロックされている場合は、カード会社のアプリで解除する必要があります)。これらの手段はKunavo残高へのチャージであり、Anthropicへの直接支払いではありません。

韓国語使用時のトークンコスト

Claudeは韓国語の入出力でも英語と同等の品質を発揮します。ただし、韓国語は英語より約1.5~2倍多くトークンを消費します(1文字あたり約0.5~0.7トークン)。料金計算時にはこの点を考慮してください。

敬語とタメ口の区別は、システムプロンプトで明示するのが最も確実です:

「あなたは韓国のカスタマーサポート担当者です。すべての回答は必ず敬語(-습니다/-입니다)で作成し、お客様に丁寧かつ親切に対応してください。」

モデル選択ガイド

  • Claude Opus 4.7 — 最高水準の推論能力。韓国語のニュアンス理解が必要な複雑な作業、長いコンテキストの要約、コード生成に適しています。
  • Claude Sonnet 4.6 — 料金と能力のバランスに優れています。韓国のスタートアップで最も多く採用されているモデルです。チャットボット、コンテンツ生成、エージェントのメインモデルに適しています。
  • Claude Haiku 4.5 — 高速で低価格。分類、フィルタリング、簡単な要約、エージェントの前処理に適しています。Sonnetの約1/10のコストです。

次のステップ

  1. 無料で登録 — $10からチャージ、従量課金、残高の失効なし
  2. OpenAI互換APIキーを作成 — base_urlを変更するだけで既存のOpenAI SDKをそのまま利用可能
  3. Chat completionsで初回呼び出し — Claude・Gemini・GPTが同じエンドポイント
  4. Claude APIの料金を見る · 支払い方法のまとめ · OpenRouterとの代替比較

質問はcontact@kunavo.comまでお送りください。1営業日以内に回答します。