البدء

يرشدك هذا الدليل خلال أول استدلال باستخدام واجهة GreatRouter البرمجية.

1. احصل على مفتاح API

سجّل في لوحة تحكم GreatRouter للحصول على مفتاح API. يتضمن كل حساب جديد رصيدًا مجانيًا.

عيّن متغير البيئة:

export GREAT_ROUTER_API_KEY="pk_live_..."

2. أرسل أول طلب

يستخدم GreatRouter نقطة النهاية /v1/auto/route للتوجيه التلقائي للمطالبات. أرسل مطالبتك ومدخلات النموذج؛ يختار الموجّه أفضل نموذج.

باستخدام curl

curl https://api.greatrouterai.com/v1/auto/route \
  -H "Authorization: Bearer $GREAT_ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "ما عاصمة فرنسا؟",
    "input": {
      "messages": [{"role": "user", "content": "ما عاصمة فرنسا؟"}]
    }
  }'

باستخدام Python

import requests

response = requests.post(
    "https://api.greatrouterai.com/v1/auto/route",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "ما عاصمة فرنسا؟",
        "input": {
            "messages": [{"role": "user", "content": "ما عاصمة فرنسا؟"}]
        },
    },
)

result = response.json()
print(result["result"]["choices"][0]["message"]["content"])

باستخدام Node.js

const response = await fetch('https://api.greatrouterai.com/v1/auto/route', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.GREAT_ROUTER_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'ما عاصمة فرنسا؟',
    input: {
      messages: [{ role: 'user', content: 'ما عاصمة فرنسا؟' }],
    },
  }),
});

const result = await response.json();
console.log(result.result.choices[0].message.content);

3. حدد نموذجًا مباشرة

إذا كنت تفضل نموذجًا محددًا بدل التوجيه التلقائي، استخدم /v1/models/route مع استعلام صريح:

curl https://api.greatrouterai.com/v1/models/route \
  -H "Authorization: Bearer $GREAT_ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "text_generation",
    "input": {
      "model": "meta/llama-3.3-70b-instruct-fp8-fast",
      "messages": [{"role": "user", "content": "اشرح الحوسبة الكمية في 3 جمل."}]
    }
  }'

تستخدم معرّفات النماذج التنسيق مزوّد/اسم-النموذج. استكشف جميع النماذج في النماذج.

4. استكشف المزيد

بدء سريع — المزيد من الأمثلة، بما في ذلك توليد الصور والتوجيه بحد تكلفة
مرجع API — وثائق نقاط النهاية الكاملة
النماذج — تصفح جميع النماذج المتاحة
النماذج والأسعار — الكتالوج والتسعير