البدء السريع

ثلاث خطوات: مفتاح، طلب، ردّ. الأمثلة أدناه كاملة وقابلة للّصق كما هي بعد استبدال المفتاح والمضيف.

أنشئ مفتاحًا

من لوحة حسابك ← مفاتيح API ← إنشاء مفتاح. يبدأ المفتاح بـ vx_live_ ويُعرض مرة واحدة فقط؛ انسخه فورًا إلى مدير الأسرار لديك.

أرسل أول طلب

نداء واحد إلى /v1/chat/completions يكفي. الحقول المطلوبة: model ورسالة واحدة على الأقل.

curl
curl https://<host>/v1/chat/completions \
  -H "Authorization: Bearer vx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vfm-1",
    "messages": [
      { "role": "user", "content": "Write a haiku about databases." }
    ]
  }'
javascript
const response = await fetch("https://<host>/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VORIX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "vfm-1",
    messages: [{ role: "user", content: "Write a haiku about databases." }],
  }),
})

const data = await response.json()
console.log(data.choices[0].message.content)
console.log(data.usage.cost, data.usage.total_tokens)
python
import os
import requests

response = requests.post(
    "https://<host>/v1/chat/completions",
    headers={
        "Authorization": f"Bearer {os.environ['VORIX_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "vfm-1",
        "messages": [{"role": "user", "content": "Write a haiku about databases."}],
    },
    timeout=120,
)
response.raise_for_status()
data = response.json()

print(data["choices"][0]["message"]["content"])
print(data["usage"]["cost"], data["usage"]["total_tokens"])

اقرأ الكلفة

كل رد يحمل حقل usage فيه عدد توكنات الطلب والرد وكلفتهما — سجّله عندك إن أردت مطابقة فاتورتك.

json
{
  "id": "req_9f4d1c8e2a7b5306d4e1f2a3",
  "object": "chat.completion",
  "created": 1769040000,
  "model": "vorix-pro",
  "served_by": "vorix-pro",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "- First point\n- Second point" },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 512,
    "completion_tokens": 128,
    "total_tokens": 640,
    "cost": "$0.001664",
    "cost_micros": 1664,
    "estimated": false
  }
}

سطر الهوية — شفافية كاملة

تضيف المنصّة سطر تعليمات نظام واحدًا في بداية رسائلك، يخبر النموذج أنه مساعد VORIX وألّا يخوض في تفاصيل بنيته الداخلية. هذا السطر الوحيد هو كل ما نضيفه — رسائلك بعده تصل كما كتبتها حرفًا بحرف، بلا حقنٍ خفيّ يغيّر إخراجك أو يكسر تنسيقًا تعتمد عليه. نوثّقه هنا لأن ما يُضاف لطلبك يجب أن تعرفه.

السطر يُحتسب ضمن توكنات الدخل (بضع عشرات من التوكنات).

ثم ماذا؟

  • فعّل البثّ لتظهر الردود سطرًا سطرًا بدل انتظار الرد كاملًا.
  • اقرأ صفحة الأخطاء وتعامل مع 402 و429 قبل أن تنشر للإنتاج.
  • قارن مستويات النماذج واختر الأرخص الذي يفي بمهمّتك.
التاليالمصادقة