نقاط النهاية

Completions

نقطة النهاية القديمة POST /completions تستقبل prompt نصيًا خامًا وتُعيد نصًا مولَّدًا، وتناسب النماذج الأساسية والتكاملات القديمة.

جرّبه في ساحة التجربة

تستقبل نقطة نهاية completions القديمة سلسلة prompt خامة وتُعيد نصًا مولَّدًا دون تطبيق أي قالب محادثة. تفيد مع النماذج الأساسية (base models) وإكمال الجزء الأوسط (fill-in-the-middle) والتكاملات الأقدم. في الكود الجديد استخدم Chat completions.

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

الطلب

المعامل	النوع	الوصف
`model`	string، مطلوب	معرّف النموذج، مثل `meta-llama/llama-3.1-8b-instruct`.
`prompt`	string، مطلوب	النص المراد إكماله.
`max_tokens`	integer	الحد الأقصى للرموز المولَّدة.
`temperature`, `top_p`, `top_k`	number	عناصر التحكم في أخذ العينات.
`stop`	string \| string[]	تسلسلات الإيقاف.
`seed`	integer	أخذ عينات حتمي بأفضل جهد ممكن.
`logprobs`	integer	تُعيد الاحتمالات اللوغاريتمية لأعلى الرموز عندما يدعم النموذج ذلك.
`stream`	boolean	بثّ أجزاء النص عبر SSE.
`provider`, `models`, `transforms`		امتدادات البوابة نفسها الموجودة في chat completions.

curl https://api14.com/api/v1/completions \
  -H "Authorization: Bearer $API14_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-3.5-turbo-instruct",
    "prompt": "The three primary colors are",
    "max_tokens": 20
  }'

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-xyz789",
  "object": "text_completion",
  "created": 1760000000,
  "model": "openai/gpt-3.5-turbo-instruct",
  "choices": [
    { "index": 0, "text": " red, yellow and blue.", "finish_reason": "stop" }
  ],
  "usage": {
    "prompt_tokens": 6,
    "completion_tokens": 7,
    "total_tokens": 13,
    "cost": 0.0000195
  }
}

الأخطاء

400 model_required، 400 invalid_json، 401 invalid_api_key، 402 insufficient_balance، 403 model_not_allowed / plan_required، 404 model_not_found، 413 payload_too_large، 429 rate_limited، 502 upstream_unavailable. تُمرَّر الأخطاء الصادرة من المزوّد بحالتها الأصلية. راجع الأخطاء.