Chat completions

تستخدم نقطة نهاية chat completions صيغة المحادثة الخاصة بـ OpenAI وتعمل مع كل نموذج نصي في الكتالوج: GPT وClaude وGemini وLlama وDeepSeek وMistral ومئات غيرها. يُمرَّر جسم الطلب إلى المزوّد الأصلي دون تغيير. يقتصر دور api14 على التحقق من مفتاحك والنموذج والحدود والرصيد، ثم تسجيل الاستخدام عند انتهاء الطلب.

POST https://api14.com/api/v1/chat/completions
Authorization: Bearer sk-api14-...
Content-Type: application/json

الطلب

يمكن أن يكون content في الرسالة نصًا أو مصفوفة من أجزاء المحتوى (text وimage_url وfile وinput_audio). راجع الرؤية والملفات.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

const result = await client.chat.completions.create({
  "model": "openai/gpt-5-mini",
  "messages": [
    {
      "role": "user",
      "content": "Explain vector databases in two sentences."
    }
  ]
});
console.log(result.choices[0].message.content);

الاستجابة

{
  "id": "gen-1760000000-abc123",
  "object": "chat.completion",
  "created": 1760000000,
  "model": "anthropic/claude-sonnet-4.5",
  "provider": "Anthropic",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": { "role": "assistant", "content": "Hello! How can I help you today?" }
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 9,
    "total_tokens": 21,
    "prompt_tokens_details": { "cached_tokens": 0 },
    "completion_tokens_details": { "reasoning_tokens": 0 },
    "cost": 0.000171
  }
}

usage.cost هو تكلفة الطلب بالدولار الأمريكي. يخصمها api14 من رصيدك بعد انتهاء الطلب. أما id فهو معرّف عملية التوليد، ويمكنك الاستعلام عنه لاحقًا عبر الاستعلام عن عملية توليد.

ملاحظات حول الفوترة

• تدفع السعر المُعلَن للنموذج؛ وتُعاد قيمة الرسوم في usage.cost. راجع الأسعار والفوترة.
• لا تُحتسب عليك الطلبات الفاشلة (أي رمز حالة 4xx أو 5xx).
• إذا تضمّن الطلب models: [...]، فيجب أن يكون كل نموذج احتياطي مسموحًا به لمفتاحك وخطتك، وإلا رفضت البوابة الطلب قبل إرساله إلى المزوّد الأصلي.

الأخطاء

تعود أخطاء المزوّد الأصلي، مثل تجاوز طول السياق أو الإشراف على المحتوى، برمز حالتها الأصلي وبصيغة الخطأ نفسها. راجع الأخطاء.