API reference

apikey.sh ใช้โปรโตคอลเดียวกับ OpenAI ทุก SDK เฟรมเวิร์ก หรือเครื่องมือที่ใช้กับ OpenAI ได้อยู่แล้ว ใช้ที่นี่ได้ทันทีเพียงเปลี่ยน base_url

เริ่มต้นใช้งาน

สร้างคีย์ในแดชบอร์ด เก็บไว้ใน environment variable แล้วชี้ 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 เดียวกันใช้ได้กับทุกโดเมนด้านล่าง — เลือกอันที่ถนัด

https://apikey.sh/v1ใช้งานอยู่

https://api.onie.net/v1ใช้งานอยู่

Anthropic SDK ใช้ base URL แบบไม่มี /v1 (เช่น https://apikey.sh)

การยืนยันตัวตน

ส่งคีย์ไปใน header:

Authorization: Bearer sk-ak-...

# or, with the Anthropic SDK:
x-api-key: sk-ak-...

คีย์จะแสดงครั้งเดียวตอนสร้างเท่านั้น หากทำหาย ให้สร้างใหม่แล้วเพิกถอนคีย์เดิม — การเพิกถอนมีผลทันที

Endpoints

POST	`/v1/chat/completions`	สร้าง completion (รองรับ SSE streaming และ tool calling)
POST	`/v1/embeddings`	สร้าง embedding สำหรับ RAG และการค้นหาเชิงความหมาย
POST	`/v1/images/generations`	สร้างรูปภาพ (โมเดล gpt-image-*)
GET	`/v1/models`	แสดงรายการโมเดลที่คีย์ปัจจุบันใช้ได้

Streaming

เพิ่ม stream: true เพื่อรับ token แบบเรียลไทม์ผ่าน 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

ในโมเดลที่รองรับ (ตระกูล GPT-5.x) ส่วนต้นของ prompt ที่ซ้ำจะถูกแคชอัตโนมัติและคิดในอัตราแคช — ถูกกว่า token ใหม่ราว 90% ไม่ต้องแก้อะไรในโค้ด ดูจำนวน token ที่แคชได้ในหน้า Usage บนแดชบอร์ดresponse จะมี usage.prompt_tokens_details.cached_tokens ให้ตรวจสอบเองได้

ลิมิตรายคีย์

แต่ละคีย์ตั้งวงเงินและรายการโมเดลที่อนุญาตของตัวเองได้ นี่คือวิธีที่ปลอดภัยในการแชร์คีย์ข้ามโปรเจกต์หรือให้เพื่อนร่วมทีม โดยไม่มีใครใช้งบจนหมด ตั้งค่าได้ที่ Dashboard → API keys

รหัสข้อผิดพลาด

`401`	คีย์ไม่ถูกต้อง คีย์ถูกเพิกถอน หรือบัญชีถูกระงับ
`402`	เครดิตหมด — เติมเงินในแดชบอร์ด
`403`	โมเดลไม่อยู่ในรายการที่คีย์นี้อนุญาต
`429`	เกิน rate limit ของคีย์
`5xx`	ผู้ให้บริการต้นทางขัดข้อง — ลองใหม่ในอีกไม่กี่วินาที

โมเดลที่ใช้ได้

มี 37 โมเดลพร้อมใช้งาน ดูรายการแบบ machine-readable ที่ GET /v1/models หรือ /api/models (JSON ไม่ต้องยืนยันตัวตน)