التوثيق
DzRouter يتحدث بواجهتي OpenAI وAnthropic. إن كانت أداتك تسمح بتغيير عنوان الأساس فهي تعمل.
الأساسيات
عنوان الأساس
https://dzrouter.com/v1المصادقة
أرسل مفتاحك في الترويسة Authorization: Bearer YOUR_KEY أو x-api-key: YOUR_KEY.
أسماء النماذج
استخدم المعرّف كما هو في صفحة النماذج، مثل claude-opus-5-5. الطلب GET /v1/models يعيد القائمة الكاملة.
بداية سريعة
from openai import OpenAI
client = OpenAI(
base_url="https://dzrouter.com/v1",
api_key="sk-dz-…",
)
reply = client.chat.completions.create(
model="claude-opus-5-5",
messages=[{"role": "user", "content": "Salam!"}],
)
print(reply.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://dzrouter.com/v1",
apiKey: process.env.DZROUTER_API_KEY,
});
const reply = await client.chat.completions.create({
model: "claude-opus-5-5",
messages: [{ role: "user", content: "Salam!" }],
});
console.log(reply.choices[0].message.content);curl https://dzrouter.com/v1/chat/completions \
-H "Authorization: Bearer $DZROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5-5",
"messages": [{"role": "user", "content": "Salam!"}],
"stream": true
}'from anthropic import Anthropic
client = Anthropic(
base_url="https://dzrouter.com",
api_key="sk-dz-…",
)
msg = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Salam!"}],
)
print(msg.content[0].text)أدوات البرمجة
في أي أداة، اختر مزوّدًا «متوافقًا مع OpenAI» (أو «Anthropic») ثم املأ:
| Base URL | https://dzrouter.com/v1 |
|---|---|
| API key | sk-dz-… |
| Model | claude-opus-5-5 |
opencode — opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"dzrouter": {
"npm": "@ai-sdk/openai-compatible",
"name": "DzRouter",
"options": {
"baseURL": "https://dzrouter.com/v1",
"apiKey": "{env:DZROUTER_API_KEY}"
},
"models": { "claude-opus-5-5": {} }
}
}
}Claude Code
export ANTHROPIC_BASE_URL="https://dzrouter.com"
export ANTHROPIC_AUTH_TOKEN="sk-dz-…"
export ANTHROPIC_MODEL="claude-opus-5-5"
claude
Cursor · Cline · Roo Code · Continue
OpenAI Compatible → Base URL + API key + Model.
نقاط الوصول
POST /v1/chat/completions | OpenAI chat (stream: true) |
POST /v1/messages | Anthropic messages (stream: true) |
GET /v1/models | Model catalog |
POST /v1/embeddings | Embeddings |
الأخطاء
401 | مفتاح API مفقود أو غير صالح أو ملغى. |
402 | رصيدك فارغ. اشحن ثم أعد المحاولة. |
429 | طلبات كثيرة جدًا — خفّف الوتيرة (600 طلب في الدقيقة لكل مفتاح). |
5xx | فشل مزوّد النموذج. لا يُحتسب الطلب؛ أعد المحاولة. |
الحدود
600 طلب في الدقيقة لكل مفتاح، وحجم أقصى للطلب 50 ميغابايت، وينقطع البث بعد دقيقتين دون بيانات.