مرجع API
يعتمد apikey.sh بروتوكول OpenAI. أي SDK أو إطار عمل أو أداة تعمل مع OpenAI ستعمل هنا بعد تغيير base_url.البدء السريع
أنشئ مفتاحًا من لوحة التحكم، ضعه في متغير بيئة، ثم وجّه الـ 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
المفتاح نفسه يعمل على كل النطاقات أدناه — اختر ما يناسبك.يستخدم Anthropic SDK الـ base URL بدون /v1 (مثل https://apikey.sh).
https://apikey.sh/v1يعملhttps://api.onie.net/v1يعملالمصادقة
أرسل مفتاحك ضمن ترويسة الطلب:
Authorization: Bearer sk-ak-... # or, with the Anthropic SDK: x-api-key: sk-ak-...يظهر المفتاح مرة واحدة فقط عند الإنشاء. إذا فقدته، أنشئ مفتاحًا جديدًا وألغِ القديم — الإلغاء يسري فورًا.
Endpoints
| POST | /v1/chat/completions | توليد completions (يدعم SSE streaming واستدعاء الأدوات) |
| POST | /v1/embeddings | إنشاء embeddings لأنظمة RAG والبحث الدلالي |
| POST | /v1/images/generations | توليد الصور (نماذج gpt-image-*) |
| GET | /v1/models | عرض النماذج المتاحة للمفتاح الحالي |
Streaming
أضف stream: true لاستقبال الـ tokens لحظيًا عبر 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 تلقائيًا وتُحتسب بسعر الكاش — أرخص بنحو 90% من الـ tokens الجديدة. لا حاجة لأي تعديل في الكود؛ ويمكنك رؤية عدد الـ tokens المخزّنة ضمن قسم الاستخدام في لوحة التحكم.تتضمن الاستجابات الحقل usage.prompt_tokens_details.cached_tokens لتتحقق بنفسك.
حدود لكل مفتاح
يمكن لكل مفتاح أن يحمل سقف إنفاق خاصًا به وقائمة نماذج مسموح بها. هذه الطريقة الآمنة لمشاركة المفاتيح بين المشاريع أو أعضاء الفريق دون أن يستنزف أحدهم الميزانية. اضبط ذلك من لوحة التحكم ← API keys.
رموز الأخطاء
401 | مفتاح غير صالح أو ملغى، أو حساب موقوف |
402 | نفد الرصيد — اشحن من لوحة التحكم |
403 | النموذج غير مدرج ضمن قائمة هذا المفتاح |
429 | تم تجاوز حد معدّل الطلبات للمفتاح |
5xx | خطأ من المزوّد الأساسي — أعد المحاولة بعد ثوانٍ |