بداية سريعة: واجهة النص لخط أنابيب واجهة الرؤية الخاصة بك
قم بتكامل محرك النص بدون رقابة في خط أنابيب الرؤية الخاص بك باستخدام الواجهة المتوافقة مع OpenAI. يغطي هذا الدليل المصادقة، وإكمال المحادثات، والبث المتدفق، والقيود لمعالجة بيانات الرؤية ذات السياق الكبير.
- عنوان URL الأساسي
https://api.visionllmapi.com/v1- النموذج
uncensored
عنوان 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. النموذج مُعدّل للاستخدام القانوني للبالغين لكنه يحجب المحتوى الجنسي الذي يتضمن قاصرين.
أسئلة وأجوبة
هل هذه واجهة برمجة متعددة الوسائط؟
لا. هذه واجهة نصية فقط. لا تقبل الصور أو الصوت أو الفيديو مباشرة. يجب معالجة بيانات الرؤية إلى نص أولاً، ثم إرسال النص إلى هذه الواجهة للمعالجة أو الاستخراج أو التوليد.
كيف يتم حساب التسعير؟
التسعير بنظام الدفع حسب الاستخدام مع رصيد مسبق الدفع. تكلف الرموز المدخلة $0.15 لكل مليون رمز، وتكلف الرموز المخرجة $0.50 لكل مليون رمز. لا تنتهي صلاحية الرصيد، ولا توجد رسوم اشتراك شهرية.
ما هو حجم نافذة السياق؟
حجم نافذة السياق هو 100,000 رمز، ويغطي كلًا من الموجّه المدخل والإكمال المُولّد. يسمح هذا بمعالجة المستندات الكبيرة أو بيانات خطوط أنابيب الرؤية في طلب واحد.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.
عنوان URL الأساسيhttps://api.visionllmapi.com/v1
مواصفات API
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| Base URL | https://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 |
| وضع JSON | response_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 | النوع | المعنى |
|---|---|---|
400 | bad_request | JSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق |
401 | missing_key · invalid_key · key_revoked | لا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله |
402 | no_credit | الرصيد فارغ — اشحن وتستأنف الطلبات فوراً |
403 | content_blocked | محتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب |
404 | not_found | نقطة نهاية غير معروفة |
413 | request_too_large | جسم الطلب أكبر من 8 MB |
429 | rate_limited · concurrency | تجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة |
503 | upstream_busy | النموذج مشغول — أعد المحاولة بعد ثوانٍ |