AR ▾
احصل على مفتاح API

بداية سريعة: واجهة النص لخط أنابيب واجهة الرؤية الخاصة بك

قم بتكامل محرك النص بدون رقابة في خط أنابيب الرؤية الخاص بك باستخدام الواجهة المتوافقة مع OpenAI. يغطي هذا الدليل المصادقة، وإكمال المحادثات، والبث المتدفق، والقيود لمعالجة بيانات الرؤية ذات السياق الكبير.

عنوان URL الأساسي
https://api.visionllmapi.com/v1
النموذج
uncensored
$0.15لكل 1M رمز إدخال
$0.50الرموز المخرجة / مليون
100,000سياق رموز
$0.50رصيد تجريبي
300طلب في الدقيقة

عنوان URL الأساسي والمصادقة

ابدأ بتعيين عنوان URL الأساسي الخاص بك إلى https://api.visionllmapi.com/v1. هذه نقطة النهاية متوافقة مع أدوات SDK القياسية الخاصة بـ OpenAI وأي عميل متوافق مع OpenAI. تحتاج إلى مفتاح API لمصادقة الطلبات. أنشئ مفتاحًا على صفحة الحصول على مفتاح API عن طريق تسجيل الدخول باستخدام البريد الإلكتروني وكلمة المرور فقط. لا يلزم بطاقة ائتمان للبدء، وستحصل على $0.50 كرصيد تجريبي صالح لمدة 7 أيام. احصل على هذا الرصيد بنقرة واحدة في صفحة مفتاح API الخاص بك. احفظ مفتاحك بأمان؛ يمكنك تجديده في أي وقت، مما يؤدي إلى إبطال المفتاح السابق على الفور.

الطلب الأول

أرسل طلب POST إلى /v1/chat/completions. استخدم معرف النموذج uncensored. تقبل الواجهة مدخلات نصية وتعيد مخرجات نصية، مما يجعلها مثالية لمعالجة بيانات خط أنابيب الرؤية. يمكنك تضمين موجّهات النظام لتحديد السلوك، مثل توجيه النموذج لاستخراج بيانات منظمة من نتائج التعرف الضوئي على الحروف (OCR) أو وصف محتوى الصورة بدون تدخل فلاتر المحتوى في حالات الإبداع أو الاستخدام للبالغين.

curl https://api.visionllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

سيحتوي الرد على النص المُولّد في الحقل choices[0].message.content. إذا رفض النموذج الإجابة بسبب الحدّ الصارم على المحتوى الجنسي الذي يتضمن قاصرين، فستحصل على خطأ أو محتوى فارغ حسب آلية الرفض المحددة.

مكتبة Python SDK

استخدم مكتبة OpenAI Python SDK الرسمية للتكامل بسهولة. اضبط متغيرات base_url و api_key لتشير إلى خدمتنا. تعمل هذه الطريقة مع أي مكتبة عميل متوافقة مع OpenAI. تتولى الـ SDK تجزئة JSON وفك تجزئتها، لكنك مسؤول عن معالجة هيكل الاستجابة في منطق التطبيق الخاص بك.

from openai import OpenAI

client = OpenAI(base_url="https://api.visionllmapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

هذه الطريقة مناسبة للمعالجة الدفعية أو عندما تحتاج إلى تنفيذ متزامن. للتطبيقات في الوقت الفعلي، فكر في استخدام الاستجابات المتدفقة لتقليل زمن الاستجابة المُدرَك.

مكتبة Node SDK

لبيئات JavaScript، استخدم OpenAI Node.js SDK. اضبط baseURL و apiKey لتتوافق مع نقطة نهاية الـ API الخاصة بنا. يتيح لك ذلك دمج محرك النص غير الخاضع للرقابة مباشرة في تطبيقات Node.js الخاصة بك على الويب أو الخادم. توفر الـ SDK واجهة مألوفة للمطورين الذين يستخدمون بالفعل خدمات OpenAI.

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

تأكد من معالجة بيانات الاستجابة بشكل مناسب، حيث قد يعيد النموذج كميات كبيرة من النص اعتمادًا على حجم نافذة السياق المستخدمة. لا توجد ضمانات محددة حول سلوك إعادة المحاولة أو فك تشفير JSON بما يتجاوز ما توفره وثائق المكتبة القياسية.

الاستجابات المتدفقة

فعّل البث المتدفق عن طريق تعيين stream: true في طلبك. تعيد الواجهة أحداث المرسلة من الخادم (SSE) لتسليم الرموز في الوقت الفعلي. هذا مفيد لخطوط أنابيب الرؤية حيث تريد عرض النتائج تدريجيًا. يحتوي كل حدث على جزء جزئي من الاستجابة، مما يتيح لك تحديث واجهة المستخدم أثناء توليد النص.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

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

حدّ المعدل والقيود

يُقتصر كل مفتاح API على 300 طلب في الدقيقة. الحد الأقصى لحجم جسم الطلب هو 8 MB. إذا تجاوزت حدّ المعدل، ستحصل على خطأ 429. إذا لم يكن لديك رصيد في الحساب، ستحصل على خطأ 402. إذا كان المفتاح غير صالح، ستحصل على خطأ 401. تدعم نافذة السياق ما يصل إلى 100,000 رمز للموجّه والإكمال معاً. تضمن نافذة السياق الكبيرة ألا تكون منطق الرؤية إلى النص معوقاً بحدود الرمز. لا يوجد ضمان SLA، ولا تتوفر شهادات SOC2 أو HIPAA. النموذج مُعدّل للاستخدام القانوني للبالغين لكنه يحجب المحتوى الجنسي الذي يتضمن قاصرين.

02

أسئلة وأجوبة

هل هذه واجهة برمجة متعددة الوسائط؟

لا. هذه واجهة نصية فقط. لا تقبل الصور أو الصوت أو الفيديو مباشرة. يجب معالجة بيانات الرؤية إلى نص أولاً، ثم إرسال النص إلى هذه الواجهة للمعالجة أو الاستخراج أو التوليد.

كيف يتم حساب التسعير؟

التسعير بنظام الدفع حسب الاستخدام مع رصيد مسبق الدفع. تكلف الرموز المدخلة $0.15 لكل مليون رمز، وتكلف الرموز المخرجة $0.50 لكل مليون رمز. لا تنتهي صلاحية الرصيد، ولا توجد رسوم اشتراك شهرية.

ما هو حجم نافذة السياق؟

حجم نافذة السياق هو 100,000 رمز، ويغطي كلًا من الموجّه المدخل والإكمال المُولّد. يسمح هذا بمعالجة المستندات الكبيرة أو بيانات خطوط أنابيب الرؤية في طلب واحد.

مفتاحك على بُعد نموذج واحد

أنشئ حسابًا، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.

عنوان URL الأساسيhttps://api.visionllmapi.com/v1

احصل على مفتاح API

مواصفات API

كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.

البندالقيمة
صيغة APIمتوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط
Base URLhttps://api.visionllmapi.com/v1
نقاط النهايةPOST /v1/chat/completions · GET /v1/models
معرّف النموذجuncensored
المصادقةAuthorization: Bearer YOUR_KEY
استدعاء الدوالنعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool
أقصى مخرجاتحتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل)
البث المتدفقنعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز
نافذة السياق100,000 رمز (المدخلات والمخرجات معاً)
المعاملاتtemperature, top_p, stop, seed, presence_penalty, frequency_penalty
وضع JSONresponse_format: {"type": "json_object"}
حدّ المعدل300 طلب في الدقيقة لكل مفتاح
حجم الطلبحتى 8 MB
الطلبات المتزامنةحتى 8 في الوقت نفسه لكل مفتاح
ترويسات الردX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
شحن الرصيدUSDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $20 إلى $500
رصيد تجريبي مجاني$0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن
مكافأة+5% من $50، +10% من $100، +15% من $200
السعر$0.15 لكل مليون رمز مدخلات · $0.50 لكل مليون رمز مخرجات
الفوترةرصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية
الصلاحيةالرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك
المحتوىمحتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين
تسجيل الدخولGoogle أو البريد الإلكتروني وكلمة المرور
المفاتيحمفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم

رموز الأخطاء

تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.

HTTPالنوعالمعنى
400bad_requestJSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق
401missing_key · invalid_key · key_revokedلا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله
402no_creditالرصيد فارغ — اشحن وتستأنف الطلبات فوراً
403content_blockedمحتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب
404not_foundنقطة نهاية غير معروفة
413request_too_largeجسم الطلب أكبر من 8 MB
429rate_limited · concurrencyتجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة
503upstream_busyالنموذج مشغول — أعد المحاولة بعد ثوانٍ