Referensi API
apikey.sh memakai protokol OpenAI. SDK, framework, atau tool apa pun yang sudah jalan dengan OpenAI langsung jalan di sini setelah mengganti base_url.Mulai cepat
Buat key di dasbor, simpan di environment variable, lalu arahkan base URL:from openai import OpenAI
client = OpenAI(
api_key="sk-ak-...", # your key from apikey.sh
base_url="https://apikey.sh/v1", # change only this line
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)Base URL
API key yang sama berlaku di semua domain berikut — pilih mana saja.SDK Anthropic memakai base URL tanpa /v1 (misalnya https://apikey.sh).
https://apikey.sh/v1aktifhttps://api.onie.net/v1aktifAutentikasi
Kirim key Anda di header:
Authorization: Bearer sk-ak-... # or, with the Anthropic SDK: x-api-key: sk-ak-...Key hanya ditampilkan sekali saat dibuat. Jika hilang, buat yang baru dan cabut yang lama — pencabutan berlaku seketika.
Endpoint
| POST | /v1/chat/completions | Membuat completion (mendukung SSE streaming dan tool calling) |
| POST | /v1/embeddings | Membuat embedding untuk RAG dan pencarian semantik |
| POST | /v1/images/generations | Membuat gambar (model gpt-image-*) |
| GET | /v1/models | Menampilkan model yang tersedia untuk key saat ini |
Streaming
Tambahkan stream: true untuk menerima token secara real time lewat SSE:
stream = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Write a short poem"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")Prompt caching
Pada model yang mendukung (lini GPT-5.x), awalan prompt yang berulang otomatis di-cache dan ditagih dengan tarif cache — sekitar 90% lebih murah dari token baru. Tidak ada yang perlu diubah di kode Anda; jumlah token dari cache bisa dilihat di Pemakaian pada dasbor.Respons menyertakan usage.prompt_tokens_details.cached_tokens agar Anda bisa mencocokkannya sendiri.
Batas per key
Setiap key bisa punya batas pengeluaran dan daftar model yang diizinkan sendiri. Itu cara aman berbagi key antarproyek atau dengan rekan tim tanpa salah satunya menghabiskan anggaran. Aturnya di Dasbor → API key.
Kode error
401 | Key tidak valid, key dicabut, atau akun ditangguhkan |
402 | Kredit habis — isi ulang di dasbor |
403 | Model tidak ada di daftar izin key ini |
429 | Batas rate key terlampaui |
5xx | Error dari penyedia upstream — coba lagi beberapa detik |