النماذج

OpenAI: Text Embedding 3 Small

Markdown · JSON

OpenAI: Text Embedding 3 Small

يعيد نموذج تضمين النصوص الصغير من الجيل الثالث لدى OpenAI متجهات من 1,536 بُعدًا افتراضيًا، ويدعم تمثيلات أقصر. استخدم المخرجات الرقمية للبحث الدلالي واسترجاع الشيفرة والتجميع والتوصيات والتصنيف.

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

text-embedding-3-small هو نموذج تضمين النصوص الأصغر من الجيل الثالث لدى OpenAI. ويحوّل المادة المكتوبة إلى متجهات رقمية تتضمن 1,536 مكوّنًا افتراضيًا. وتقيس هذه المتجهات العلاقات بين النصوص لخطوة أخرى من البحث أو التحليل؛ ولا يولّد النموذج إجابة حوارية عن المدخل.

مثل نموذج الجيل الثالث الأكبر، يدعم أداة التحكم dimensions لدى المُنتج للحصول على تضمينات أقصر. وصُمّم التدريب للاحتفاظ بالمعلومات الممثّلة للمفاهيم في متجه مختصر، ويؤثر اختيار الحجم في جودة التطبيق ومتطلباته من الموارد. حافظ على اتساق النموذج والأبعاد المختارة عبر السجلات والاستعلامات التي تُقارَن.

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

تشمل الاستخدامات الموثّقة الأخرى التجميع والتوصية بمحتوى مرتبط والتصنيف واكتشاف القيم الشاذة وقياس التنوع. ويمكن لسير عمل رسائل محدد النطاق تجميع الطلبات المتشابهة أو مقارنتها بأوصاف الفئات. ويحدّد التطبيق كيفية تحوّل نتيجة التشابه إلى فئة أو توصية أو عنصر للمراجعة؛ ويظل التضمين نفسه بيانات رقمية.

تحدّد OpenAI حد مدخلات أقصى يبلغ 8,192 رمزًا لكل نص. وتقبل واجهة التضمين سلاسل نصية أو مدخلات مجزّأة إلى رموز ومدخلات متعددة في طلب واحد، وترفض السلاسل الفارغة، وتطبّق حدًا إجماليًا من 300,000 رمز. جهّز المادة الطويلة كمقاطع ذات معنى، واحتفظ بالعناوين أو التعريفات اللازمة لفهمها. واستخدم مجموعة متسقة من حقول المصدر بدلًا من إنشاء تضمينات لأنواع مختلفة من السجلات بقواعد تجهيز غير مرتبطة.

يعيد المُنتج متجهات float افتراضيًا، ويوثّق أيضًا ترميز base64. ويذكر الدليل أن تضمينات OpenAI مطبَّعة إلى طول معياري واحد، ويوصي بتشابه جيب التمام؛ ويمكن للضرب النقطي حسابه، وتعطي المسافة الإقليدية الترتيب نفسه. وإذا اختُصر تضمين من الجيل الثالث يدويًا بعد إعادته، فأعد تطبيع المتجه المختصر كما يصف الدليل. وتتيح أداة التحكم dimensions تجنّب جعل الاقتطاع اليدوي خطوة التجهيز المعتادة.

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

Ailoot Ultra · التضمينات POST /v1/embeddings openai/text-embedding-3-small

openai/text-embedding-3-small

OpenAI /openai/text-embedding-3-small
معرّف النموذج ID
  • openai/text-embedding-3-small
  • text-embedding-3-small

البداية

يعيد نموذج تضمين النصوص الصغير من الجيل الثالث لدى OpenAI متجهات من 1,536 بُعدًا افتراضيًا، ويدعم تمثيلات أقصر. استخدم المخرجات الرقمية للبحث الدلالي واسترجاع الشيفرة والتجميع والتوصيات والتصنيف.

المدخلات المقبولة
النص · token_ids
النتائج
embedding

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · التضمينات POST /v1/embeddings
الإدخال
text, token_ids
الإخراج
embedding
السياق
⁦8,192⁩ tokens
صيغة الإخراج
json
الحقلالنوعالمتطلبالقيم والحدودالقيمة الافتراضية
الحقلmodelالنوعstringالمتطلبمطلوبالقيم والحدود
openai/text-embedding-3-small
القيمة الافتراضية—
الحقلinputالنوعstring|string[]|integer[]|integer[][]المتطلبمطلوبالقيم والحدود
الحد الأدنى للعناصر: ⁦1⁩
الشروط: دفعة متجانسة غير فارغة. معرّفات التوكنات أعداد صحيحة غير سالبة.
سعة الإدخال: الحد الأقصى: ⁦8,192⁩ · وحدة النص: بايتات UTF8 · وحدة الرموز: عناصر مصفوفة الرموز
القيمة الافتراضية—
الحقلencoding_formatالنوعstringالمتطلباختياريالقيم والحدود
float
القيمة الافتراضيةfloat
الحقلdimensionsالنوعintegerالمتطلبغير مدعومالقيم والحدود
الحد الأدنى: ⁦1⁩
القيمة الافتراضية—
الحقلuserالنوعjson_valueالمتطلباختياريالقيم والحدود
الشروط: يسمح المصدر بحقل البيانات الوصفية هذا بصيغة JSON؛ ويعتمد المعنى الدقيق لدى المزوّد الأصلي على النموذج.
القيمة الافتراضية—
الحقلsession_idالنوعjson_valueالمتطلباختياريالقيم والحدود
الشروط: يسمح المصدر بحقل البيانات الوصفية هذا بصيغة JSON؛ ويعتمد المعنى الدقيق لدى المزوّد الأصلي على النموذج.
القيمة الافتراضية—
الحقلtraceالنوعjson_valueالمتطلباختياريالقيم والحدود
الشروط: يسمح المصدر بحقل البيانات الوصفية هذا بصيغة JSON؛ ويعتمد المعنى الدقيق لدى المزوّد الأصلي على النموذج.
القيمة الافتراضية—
الحقلproviderالنوعobjectالمتطلباختياريالقيم والحدود
الشروط: تم رفض provider.options
القيمة الافتراضية—
تركيبات مواد الإدخال

text_to_embedding

معلمات الطريقة ودورة حياتها
المعلمةالمواصفات
المعلمةcontent_typeالمواصفاتapplication/json
المعلمةrequiredالمواصفاتmodel, input
المعلمةinput_shapesالمواصفاتstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[]
المعلمةencoding_formatالمواصفاتfloat
المعلمةdimensions_overrideالمواصفاتfalse
المعلمةmax_input_budget_unitsالمواصفات8192
المعلمةmultimodal_objectsالمواصفاتfalse
المعلمةmaterial_typesالمواصفاتtext, token_ids

دورة الحياة: synchronous_json

احتفظ بفهرس كل متجه وبُعده.

اسم النموذج متعدد الوسائط لا يتيح استخدام كائنات الصور على هذا المسار المحدد.

الباقات

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع
التعرفة القياسية عند اختيار الوضع السريع
الوضع المرن
التعرفة القياسية عند اختيار وضع flex
أقصى جهد للاستدلال
التعرفة القياسية عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

تعرفات Ailoot

الأسعار حسب الإعدادات

الإعداداتجدول التعرفةالرسوم
الإعداداتالتعرفات الأساسية للرموزجدول التعرفةالتعرفة الأساسيةالرسوم
الإدخال · رموز الإدخال $0.00004 / 1K من الرموز
الإخراج · رموز الإخراج $0 / 1K من الرموز
الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

أمثلة للطلبات

Ailoot Ultra · التضمينات

curlPython SDK
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/text-embedding-3-small", "input": ["First document", "Second document"]}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT
from openai import OpenAI
import os

client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='openai/text-embedding-3-small',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)

استلام النتائج وحفظها

Ailoot Ultra · التضمينات

json

الاحتفاظ بكل النتائج المكتملة

احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.

احتفظ بكل متجه مع فهرسه. يجب أن يساوي عدد المتجهات عدد المدخلات، وأن تكون الأبعاد متسقة.

عند الحاجة إلى التحقق من الاستجابة الأصلية

لا تُستحدث نقطة نهاية لمهام التضمين.

حقول الاستجابة
الحقلالنوع
الحقلobjectالنوعstring
الحقلmodelالنوعstring
الحقلdata[].indexالنوعinteger
الحقلdata[].embeddingالنوعfinite float[]
الحقلusageالنوعobject
الأخطاء والخطوات التالية
الاستجابةالشرطالخطوة التالية
الاستجابة⁦400⁩ · invalid_request_errorالشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحةالخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد.

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra openai/text-embedding-3-small, text-embedding-3-small

الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

معرّفات النماذج ذات الصلة IDs

openai/text-embedding-3-small, text-embedding-3-small

Ailoot Ultra · تمثيلات متجهية · text-embedding-3-small POST /v1/embeddings text-embedding-3-small

text-embedding-3-small

OpenAI /text-embedding-3-small
معرّف النموذج ID
  • openai/text-embedding-3-small
  • text-embedding-3-small

البداية

يعيد نموذج تضمين النصوص الصغير من الجيل الثالث لدى OpenAI متجهات من 1,536 بُعدًا افتراضيًا، ويدعم تمثيلات أقصر. استخدم المخرجات الرقمية للبحث الدلالي واسترجاع الشيفرة والتجميع والتوصيات والتصنيف.

المدخلات المقبولة
النص
النتائج
embedding

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · تمثيلات متجهية · text-embedding-3-small POST /v1/embeddings
الإدخال
text
الإخراج
embedding
السياق
⁦8,192⁩ tokens
صيغة الإخراج
json
الحقلالنوعالمتطلبالقيم والحدودالقيمة الافتراضية
الحقلmodelالنوعstringالمتطلبمطلوبالقيم والحدود
text-embedding-3-small
القيمة الافتراضية—
الحقلinputالنوعstring|string[]|integer[]|integer[][]المتطلبمطلوبالقيم والحدود
الحد الأدنى للعناصر: ⁦1⁩
الشروط: دفعة متجانسة غير فارغة. معرّفات التوكنات أعداد صحيحة غير سالبة.
سعة الإدخال: الحد الأقصى: ⁦8,192⁩ · وحدة النص: بايتات UTF8 · وحدة الرموز: عناصر مصفوفة الرموز
القيمة الافتراضية—
الحقلencoding_formatالنوعstringالمتطلباختياريالقيم والحدود
float
القيمة الافتراضيةfloat
الحقلdimensionsالنوعintegerالمتطلبغير مدعومالقيم والحدود
الحد الأدنى: ⁦1⁩
القيمة الافتراضية—
الحقلuserالنوعjson_valueالمتطلباختياريالقيم والحدود
الشروط: بيانات وصفية اختيارية بصيغة JSON؛ وتعتمد الدلالات الدقيقة لدى المزوّد على النموذج المختار.
القيمة الافتراضية—
الحقلsession_idالنوعjson_valueالمتطلباختياريالقيم والحدود
الشروط: بيانات وصفية اختيارية بصيغة JSON؛ وتعتمد الدلالات الدقيقة لدى المزوّد على النموذج المختار.
القيمة الافتراضية—
الحقلtraceالنوعjson_valueالمتطلباختياريالقيم والحدود
الشروط: بيانات وصفية اختيارية بصيغة JSON؛ وتعتمد الدلالات الدقيقة لدى المزوّد على النموذج المختار.
القيمة الافتراضية—
الحقلproviderالنوعobjectالمتطلباختياريالقيم والحدود
الشروط: تم رفض provider.options
القيمة الافتراضية—
تركيبات مواد الإدخال

text_to_embedding

معلمات الطريقة ودورة حياتها
المعلمةالمواصفات
المعلمةcontent_typeالمواصفاتapplication/json
المعلمةrequiredالمواصفاتmodel, input
المعلمةinput_shapesالمواصفاتstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[]
المعلمةencoding_formatالمواصفاتfloat
المعلمةdimensions_overrideالمواصفاتfalse
المعلمةmax_input_budget_unitsالمواصفات8192
المعلمةmultimodal_objectsالمواصفاتfalse
المعلمةmaterial_typesالمواصفاتtext
المعلمةtext_file_materialالمواصفاتاقرأ مستند UTF-8 الفعلي وضع نصه في الإدخال المحدد أو السلسلة النصية لمحتوى الرسالة.

دورة الحياة: synchronous_json

أرسل معرّف النموذج الدقيق والحقول المطلوبة.

احتفظ بكل عنصر مُعاد وبمعرّفاته الأصلية.

الباقات

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع
التعرفة القياسية عند اختيار الوضع السريع
الوضع المرن
التعرفة القياسية عند اختيار وضع flex
أقصى جهد للاستدلال
التعرفة القياسية عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

تعرفات Ailoot

الأسعار حسب الإعدادات

الإعداداتجدول التعرفةالرسوم
الإعداداتالتعرفات الأساسية للرموزجدول التعرفةالتعرفة الأساسيةالرسوم
الإدخال · رموز الإدخال $0.00004 / 1K من الرموز
الإخراج · رموز الإخراج $0 / 1K من الرموز
الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

أمثلة للطلبات

Ailoot Ultra · تمثيلات متجهية · text-embedding-3-small

جسم طلب JSON مكتمل بالحد الأدنىcurl · استخدم مستندك بترميز UTF-8Python · احفظ النتيجة كاملة
{
  "model": "text-embedding-3-small",
  "input": [
    "First document",
    "Second document"
  ],
  "encoding_format": "float"
}
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json, os
from pathlib import Path

source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
    raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
    raise SystemExit('Choose a document containing text')
payload = {'model': 'text-embedding-3-small', 'input': ['First document', 'Second document'], 'encoding_format': 'float'}
payload['input'] = [text]
Path('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path

result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
for vector in result.get('data', []):
    print('Vector', vector.get('index'), json.dumps(vector.get('embedding')))
PY_RESULT
import json, os
from pathlib import Path

source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
    raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
    raise SystemExit('Choose a document containing text')
payload = {'model': 'text-embedding-3-small', 'input': ['First document', 'Second document'], 'encoding_format': 'float'}
payload['input'] = [text]
from urllib.request import Request, urlopen
from urllib.error import HTTPError

api_key = os.environ['AILOOT_API_KEY']
if not api_key.strip():
    raise SystemExit('Set AILOOT_API_KEY before making a request')
headers = {'Authorization': 'Bearer PLACEHOLDER_KEY', 'Content-Type': 'application/json'}
headers['Authorization'] = 'Bearer ' + api_key
request = Request('https://api.ailoot.ai/v1/embeddings', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')
try:
    with urlopen(request, timeout=120) as response:
        raw = response.read()
        Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')
except HTTPError as error:
    Path('result.json').write_bytes(error.read())
    Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')
    raise
Path('result.json').write_bytes(raw)
import json
from pathlib import Path

result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
for vector in result.get('data', []):
    print('Vector', vector.get('index'), json.dumps(vector.get('embedding')))

استلام النتائج وحفظها

Ailoot Ultra · تمثيلات متجهية · text-embedding-3-small

json

الاحتفاظ بكل النتائج المكتملة

احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.

احتفظ بكل متجه ذي قيم منتهية مع فهرسه الأصلي. حافظ على جميع الأبعاد وكائن الاستخدام كاملاً.

عند الحاجة إلى التحقق من الاستجابة الأصلية

لا تُستحدث نقطة نهاية لمهام التضمين.

حقول الاستجابة
الحقلالنوع
الحقلobjectالنوعstring
الحقلmodelالنوعstring
الحقلdata[].indexالنوعinteger
الحقلdata[].embeddingالنوعfinite float[]
الحقلusageالنوعobject
الأخطاء والخطوات التالية
الاستجابةالشرطالخطوة التالية
الاستجابة⁦400⁩ · invalid_request_errorالشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحةالخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد.

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra openai/text-embedding-3-small, text-embedding-3-small

الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

معرّفات النماذج ذات الصلة IDs

openai/text-embedding-3-small, text-embedding-3-small

FAQ · OpenAI: Text Embedding 3 Small
ما المدخلات والنتائج المتاحة؟

POST /v1/embeddings · openai/text-embedding-3-small: text, token_ids → embedding

POST /v1/embeddings · text-embedding-3-small: text → embedding

ما الحقول التي يستخدمها الطلب؟

POST /v1/embeddings · openai/text-embedding-3-small: model, input, encoding_format, provider

POST /v1/embeddings · text-embedding-3-small: model, input, encoding_format, provider

ما الحدود المطبقة؟

POST /v1/embeddings · openai/text-embedding-3-small: ctx: 8192; input.budget.maximum: 8192 (بايتات UTF8); input.min_items: 1

POST /v1/embeddings · text-embedding-3-small: ctx: 8192; input.budget.maximum: 8192 (بايتات UTF8); input.min_items: 1

المزيد من التفاصيل

اربط Ailoot بخدمة Claude Code أوOpenCode أوHermes أوتطبيقك.

الشركة ومحفظة مشاريعها

الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.

اشتر الرموز بخصم.

خصم اشتراك للعمل المنتظم. الرموز الترويجية حتى 50% على شراء الرموز.

الاشتراك
اختر خطة بخصم لطلباتك المنتظمة.
رمز خصم حتى 50%
أدخل الرمز عند الشراء. يعاد حساب السعر وفق العرض الساري.
المصروفات في السجل
يحفظ النموذج والرموز والمبلغ لكل طلب.

اختر اشتراكا · اعرض أسعار النماذج

اربط API بالمنتج الذي تبيعه.

SaaS والتطبيقات والبوتات وفق العرض واتفاقية ترخيص Ailoot. لإعادة البيع، اطلب ترخيص موزع.

تطبيق تجاري
أضف توليد النص والصور والفيديو والصوت إلى ميزات خدمتك المدفوعة.
ترخيص إعادة البيع
أرسل وصف المشروع وطريقة توفير الوصول. اطلب شروط استخدام وإعادة بيع مكتوبة.
المستندات على الموقع
العرض واتفاقية الترخيص وسياسة معالجة البيانات متاحة قبل الربط.

اطلب ترخيص إعادة بيع · العرض واتفاقية الترخيص