Memanggil Claude API dari kode Anda
Ubah dua hal di kode Anda: Base URL menjadi https://api.relayswitch.io/v1 dan API key menjadi key RelaySwitch. SDK Anthropic dan SDK OpenAI berjalan tanpa perubahan lain, dengan 13 model Claude yang harganya dibaca langsung dari katalog.
01Apa yang berubah dibanding memanggil Anthropic langsung
Memakai Claude API secara langsung berarti membuka akun di Console Anthropic, mengisi kredit di sana, lalu memanggil dengan key dari sana. Di sini bagian itu diganti: Anda mengisi saldo di RelaySwitch, memakai key RelaySwitch, dan request dikirim ke gateway yang meneruskannya ke model. Bagi kode Anda, yang berbeda hanya Base URL dan key; isi request, id model, streaming, dan tool calling tetap sama.
Penagihan dihitung per token dengan tiga harga: input, cached input, dan output. Harga di tabel adalah harga yang dipotong dari saldo.
Setiap respons membawa id request di header-nya. Dengan id itu Anda bisa mengambil struk bertanda tangan yang mencatat id model, token yang ditagih, dan biayanya.
02Request pertama dengan curl
Pastikan dulu key dan alamatnya benar dengan curl sebelum memindahkannya ke SDK.
Key boleh dikirim di header x-api-key atau Authorization: Bearer, tetapi satu request hanya boleh membawa satu key. Untuk streaming, isi stream dengan true; responsnya berupa server-sent events.
curl -i https://api.relayswitch.io/v1/messages \ -H "Authorization: Bearer sk-relay-..." \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model": "claude-fable-5.1", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'03SDK Anthropic untuk Python
Kode baru, atau kode yang memakai fitur khas Claude seperti field system, struktur tool use bawaan, dan penanda prompt cache, paling cocok memakai SDK Anthropic lewat /messages. Cukup isi base_url dan api_key.
SDK Anthropic menambahkan /v1/messages sendiri di belakang Base URL. Gateway menerima /v1 yang berulang, jadi semua contoh memakai https://api.relayswitch.io/v1.
import anthropic client = anthropic.Anthropic(base_url="https://api.relayswitch.io/v1", api_key="sk-relay-...")reply = client.messages.create( model="claude-fable-5.1", max_tokens=300, messages=[{"role": "user", "content": "Reply with ok"}],)print(reply.content[0].text)print(reply.usage)04SDK OpenAI: kode lama tidak perlu dibongkar
Jika aplikasi Anda sudah ditulis dengan format OpenAI, atau kode yang sama juga memanggil model dari pengembang lain, pakai /chat/completions dan ganti model dengan id Claude. Kedua format memakai key yang sama, saldo yang sama, dan harga yang sama.
Contoh untuk SDK dan framework lain ada di dokumentasi dan panduan per tool, keduanya berbahasa Inggris. Untuk Claude Code, lihat halaman Claude Code.
from openai import OpenAI client = OpenAI(base_url="https://api.relayswitch.io/v1", api_key="sk-relay-...")reply = client.chat.completions.create( model="claude-fable-5.1", messages=[{"role": "user", "content": "Reply with ok"}],)print(reply.choices[0].message.content)05Harga model Claude saat ini
Dalam USD per satu juta token, dibaca dari katalog saat halaman dirender. Token yang mengenai prompt cache, misalnya system prompt panjang, dokumen yang dikirim berulang, dan riwayat percakapan multi-giliran, ditagih dengan harga cached input yang lebih rendah daripada harga input. Struk tiap request memisahkan token input, cached input, dan output, sehingga bisa dicocokkan satu per satu.
| Model | Pengembang | Input | Output | Konteks |
|---|---|---|---|---|
| Claude Fable 5.1claude-fable-5.1 | Anthropic | $6.00 | $30.00 | 1,000,000 |
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00 | $20.00 | 1,000,000 |
| Claude Fable 5claude-fable-5 | Anthropic | $3.00 | $15.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716 | $9.70 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6 | Anthropic | $1.80 | $9.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 5claude-opus-5 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5 | Anthropic | $0.60 | $3.00 | 200,000 |
| Claude Sonnet 5claude-sonnet-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5 | Anthropic | $0.0582 | $0.1455 | 1,000,000 |
USD per satu juta token
06Kode error yang paling sering muncul
Status 401 sampai 404 dikembalikan sebelum request mencapai model, sedangkan 429, 502, dan 503 tidak membawa jawaban; semuanya tidak ditagih. Isi error mengikuti struktur error dari format yang Anda pakai.
401 invalid_api_key | Key tidak dikirim, salah, atau sudah dicabut. |
402 insufficient_balance | Saldo tidak cukup. Anggaran atau batas belanja pada key yang habis punya kode error tersendiri. |
403 scope_denied | Id model tidak ada di allowlist key tersebut. |
404 model_not_found | Id model tidak ada di katalog; biasanya salah ketik. |
429 rate_limited | Batas laju key tercapai; header retry-after menyebut berapa detik harus menunggu. |
| 502 / 503 | Rute ke model bermasalah, atau untuk sementara tidak ada rute yang menjawab. |
07Sebelum masuk production
Buat key terpisah untuk production dan atur sesuai kebutuhan: anggaran, batas belanja harian, allowlist model, dan allowlist IP. Secara default setiap key dibatasi 600 request per menit, dan angka itu bisa diubah di key tersebut. Untuk request yang gagal, baca header retry-after sebelum mencoba lagi, dan simpan id request dari pesan error di log Anda karena berguna saat menelusuri masalah.
Satu id model dilayani beberapa rute. Jika satu rute menjawab 5xx atau 429, request otomatis pindah ke rute berikutnya dengan harga yang sama; model yang hanya punya satu rute menjawab 503.
Pertanyaan umum
- Pakai format Anthropic atau format OpenAI?
- Keduanya bisa, dengan key dan Base URL yang sama (https://api.relayswitch.io/v1). SDK Anthropic memakai /messages, SDK OpenAI memakai /chat/completions, dan id model Claude ditulis sama persis di keduanya.
- Apakah Base URL harus memakai /v1?
- Ya. Isi https://api.relayswitch.io/v1, lalu SDK menambahkan /messages atau /chat/completions sendiri.
- Apakah streaming didukung?
- Ya. Isi stream: true pada request, dan responsnya berupa server-sent events. Semua model mendukung streaming.
- Bagaimana memastikan yang dipanggil memang Claude, bukan model lain?
- Ada dua cara yang tidak menuntut Anda percaya pada halaman ini. Setiap model menerima prompt uji yang sama sekali sehari dan jawabannya dibandingkan dengan hasil sebelumnya; hasilnya terbuka di https://api.relayswitch.io/v1/proof. Setiap request juga punya struk bertanda tangan (GET https://api.relayswitch.io/v1/requests/:id/receipt) berisi id model, token yang ditagih, dan biaya, yang bisa diverifikasi secara offline dengan public key.
- Apakah request yang gagal tetap ditagih?
- Request yang gagal sebelum mencapai model, atau yang tidak dijawab model, tidak ditagih. Itu mencakup status 401 sampai 404 serta 429, 502, dan 503.
- Bagaimana cara top up, dan apakah perlu KYC?
- Dengan kartu atau USDT, USDC, BTC, ETH, SOL, mulai $10. Saldo dicatat dalam dolar AS, tidak kedaluwarsa, dan tidak ada langganan. Akun dibuka dengan satu email, tanpa pemeriksaan identitas.
Ganti satu baris base_url
Base URL https://api.relayswitch.io/v1, model Claude ditagih per token sesuai harga katalog, dengan cek harian yang terbuka untuk publik.