البدء السريع

أرسل أول طلب لك إلى api14 باستخدام OpenAI SDK الرسمية. الأمر يتطلب ثلاث خطوات ونحو دقيقة واحدة.

إنشاء مفتاح API

سجّل الدخول وافتح مفاتيح API. انقر Create key، وامنحه اسمًا ثم انسخ المفتاح. تبدأ المفاتيح بـ sk-api14- ولا تُعرض إلا مرة واحدة، احفظه في مكان آمن، مثل متغيّر بيئة:

export API14_API_KEY="sk-api14-..."

تبدأ الحسابات الجديدة برصيد مجاني صغير بالدولار على الخطة Free، يكفي لتجربة النماذج الرخيصة. أضف رصيدًا أو اختر خطة من صفحة الأسعار متى احتجت إلى المزيد.

تثبيت الـ SDK

استخدم OpenAI SDK الرسمية الخاصة بلغتك. لا تحتاج إلى أي شيء آخر.

npm install openai

pip install openai

اللغات الأخرى (Go وPHP وJava وC# وRuby وRust) مشروحة في أدلة الـ SDK، مثل Go وC# /.NET.

إرسال طلب

وجّه العميل إلى https://api14.com/api/v1 ومرّر مفتاحك. يبثّ هذا المثال الإجابة token تلو الآخر:

import OpenAI from "openai";

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

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

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

هذا كل شيء، جميع النماذج الأخرى تعمل بالطريقة نفسها. غيّر model إلى أي معرّف من صفحة النماذج، مثل anthropic/claude-sonnet-4.5 أو google/gemini-2.5-flash.

معرّفات النماذج بصيغة provider/model (مثل openai/gpt-5-mini)، وتدعم المتغيّرات مثل :free و:online و:nitro. راجع معرّفات النماذج ومتغيّراتها.

بدون streaming

احذف stream لتحصل على الإجابة كاملة في استجابة JSON واحدة:

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);

تتبع الاستجابة صيغة chat completion الخاصة بـ OpenAI:

{
  "id": "gen-1759571234-abc123",
  "object": "chat.completion",
  "model": "openai/gpt-5-mini",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Requests fly,\nJSON returns..." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 21, "total_tokens": 35, "cost": 0.0000455 }
}

usage.cost هو سعر الطلب بالدولار الأمريكي، أي المبلغ الذي يُخصم من رصيدك.

الخطوات التالية

• Chat completions، جميع معاملات الطلب.
• Streaming، صيغة الأحداث وكيفية التعامل معها.
• الصور والفيديو والكلام، قدرات أخرى.
• الأخطاء، تعامل مع 402 insufficient_balance و429 rate_limited.