مفتاح API متوافق مع OpenAI: احصل عليه وأرسل طلبًا
مفتاح API متوافق مع OpenAI هو رمز حامل عادي يعمل مع أي مكتبة OpenAI SDK بمجرد توجيه العميل إلى عنوان URL أساسي مختلف. توضح هذه الصفحة كيفية الحصول عليه لواجهة برمجة التطبيقات النصية المستضافة في هذا الموقع وإجراء طلب عمل في بضع دقائق.
محدّثSpeech To Text API

ما هو المفتاح فعلياً
يصف "متوافق مع OpenAI" شكل واجهة برمجة التطبيقات HTTP، وليس الشركة وراءها. تقبل الخدمة نفس جسم JSON الذي ترسله مكتبات OpenAI SDK على POST /v1/chat/completions، وتقرأ نفس رأس Authorization: Bearer. وبسبب ذلك، يمكن لمفتاح من هذه الخدمة أن يناسب أي أداة تتيح لك تعيين عنوان URL أساسي مخصص ومفتاح API: المكتبات الرسمية لـ Python و Node، و LangChain، و curl العادي، ومعظم عملاء سطح المكتب للدردشة.
المفتاح ليس مفتاح OpenAI، ولن يعمل على api.openai.com. والعكس صحيح أيضاً: مفتاح OpenAI لن يعمل هنا. ينتمي كل مفتاح إلى خدمة واحدة، وهذه الخدمة تشغل نموذجاً واحداً مفتوح الأوزان، مُضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، ويستضيفه مزود مستقل. إنه ليس واجهة برمجة التطبيقات الرسمية لأي بائع نماذج، ولا يعيد التوجيه إلى بائعين آخرين.
إليك ما تحتاج إلى تذكره. عنوان URL الأساسي لهذا الموقع هو https://api.speechtotextapis.com/v1. معرف النموذج هو uncensored. المفتاح هو أي سلسلة نصية تحصل عليها بعد التسجيل. كل ما يلي هو اختلاف في تلك القيم الثلاث.
الخدمة مخصصة للنصوص فقط. تتعامل مع إكمال الدردشة، والبث المتدفق، واستدعاء الدوال، ووضع JSON. لا تولّد الصور أو الصوت، ولا تقدم التضمينات (embeddings)، ولا تقوم بضبط النماذج. إذا وصلت إلى هنا من خلال خط أنابيب الصوت، فإن المهمة النموذجية هي خطوة النص بعد التحويل: تنظيف النص المنقول، وتقسيمه إلى مشاهد، وإعادة كتابة الحوار، أو استخراج البيانات المهيكلة. يغطي دليل معالجة نص الصوت هذا الجانب بمزيد من التفاصيل.
احصل على مفتاحك في أربع خطوات
- سجّل. استخدم Google، أو سجّل بعنوان بريد إلكتروني وكلمة مرور.
- افتح صفحة مفتاح API. توجد في صفحة المفتاح على هذا الموقع. يتم إنشاء مفتاحك وعرضه هناك.
- استلم رصيد تجريبي مجاني. يعطيك زر على نفس الصفحة رصيداً تجريبياً بقيمة $0.50 بنقرة واحدة. هو واحد لكل شخص، صالح لمدة 7 أيام، ولا يحتاج إلى بطاقة.
- انسخ المفتاح إلى مخزن الأسرار. متغير البيئة كافٍ لاختبار محلي. لأي شيء يتم نشره، استخدم مدير الأسرار في المضيف الخاص بك.
يُقصد بالتجربة إثبات أن التكامل يعمل قبل أن تدفع أي شيء. بسعرها الحالي، تكفي للعديد من الطلبات القصيرة، ويوضح قسم التكلفة أدناه الحسابات. عندما تكون جاهزًا للمتابعة، يعرض صفحة الأسعار مبالغ شحن الرصيد. الرصيد مسبق الدفع، ولا توجد اشتراكات، والرصيد لا ينتهي، لذا لا يوجد ضغط لإنفاق الشحن قبل موعد نهائي.
مفاتيح التجربة محدودة أكثر من المفاتيح الكاملة: طلبين متزامنين و 60 طلباً في الدقيقة. هذا الكثير لبرنامج نصي أولي. إذا كنت تخطط لتوزيع عشرات أجزاء النص المنقول بالتوازي، فانتظر أن تصل إلى الحد حتى تنتقل إلى حساب ممول.
الإعدادات الثلاثة التي يطلبها كل عميل
بغض النظر عن البرنامج الذي تستخدمه، تطلب شاشة الإعداد نفس الأشياء الثلاثة بأسماء مختلفة قليلاً.
| الإعداد | اسم الحقل النموذجي | القيمة |
|---|---|---|
| نقطة النهاية | عنوان URL الأساسي، أساس API، المضيف | https://api.speechtotextapis.com/v1 |
| بيانات الاعتماد | مفتاح API، رمز، سر | مفتاحك من صفحة المفتاح |
| النموذج | نموذج، اسم النموذج، محرك | uncensored |
تفاصيل واحدة تسبب الارتباك: عنوان URL الأساسي ينتهي بالفعل بـ /v1. تضيف مكتبات SDK مسار /chat/completions تلقائيًا، لذا لا يجب عليك إضافته. إذا طلب عميلك عنوان URL الكامل لنقطة النهاية للدردشة بدلاً من العنوان الأساسي، فإن القيمة هي https://api.speechtotextapis.com/v1/chat/completions.
إذا كانت الأداة تقدم فقط خيار "OpenAI" الثابت مع مضيف مضمّن في الكود ولا توجد طريقة لتحريره، فلا يمكنها التحدث مع هذه الخدمة. ابحث عن خيار "مخصص" أو "متوافق مع OpenAI" أو "متقدم" الذي يعرض حقل عنوان URL الأساسي.
طلبك الأول
ابدأ بـ curl، لأنه يزيل كل الطبقات بينك وبين API. استبدل YOUR_KEY بالمفتاح الذي نسخته.
curl https://api.speechtotextapis.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
]
}'
الاستجابة الناجحة هي كائن JSON يحتوي على مصفوفة choices. النص موجود في choices[0].message.content، ويسجل كائن usage الرموز التي تم احتساب تكلفتها لك.
نفس الاستدعاء باستخدام المكتبة الرسمية لـ Python يبدو هكذا. فقط base_url و api_key يختلفان عن إعداد OpenAI القياسي.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.speechtotextapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
],
)
print(resp.choices[0].message.content)
وفي Node، باستخدام نفس الحزمة:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.speechtotextapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Rewrite this in plain English: the beta shipped on Tuesday." },
],
});
console.log(resp.choices[0].message.content);
لا تحتاج إلى تعيين max_tokens. عند حذفه، يمكن للنص المُولَّد أن يستخدم أي جزء متبقي من نافذة الـ 100,000 رمز بعد الموجّه. قم بتعيينه بنفسك إذا كنت تريد سقفًا صارمًا للتكلفة لكل استدعاء.
تحقق من أن المفتاح يعمل دون إنفاق الرموز
قبل توصيل مفتاح بنظام أكبر، قم بإجراء استدعاء رخيص لنقطة النهاية الخاصة بالنماذج. يؤكد ذلك قبول المفتاح وصحة عنوان URL الأساسي.
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
يطبع الخيار -i رؤوس الاستجابة، وهي المكان الذي تبلغ فيه الـ API عن الحالة المفيدة:
- يحدد
X-Request-Idالطلب. أضفه إذا تواصلت مع الدعم بشأن استدعاء معين. - يُظهر
X-Balance-USDالرصيد المتبقي في الحساب. - يُظهر
X-RateLimit-Limit-RequestsوX-RateLimit-Limit-Concurrencyحدود المعدل التي تنطبق على مفتاحك، بحيث يمكنك معرفة ما إذا كان المفتاح يحمل حدودًا تجريبية أو كاملة بسرعة.
قراءة X-Balance-USD في كودك الخاص هي طريقة رخيصة لتنبيه نفسك قبل نفاد الرصيد. قم بتسجيله مرة واحدة لكل مهمة بدلاً من مرة واحدة لكل طلب إذا كنت لا تريد إخراجًا مزعجًا.
تكلفة استخدام المفتاح
امتلاك مفتاح لا يكلف شيئًا. أنت تدفع مقابل الرموز: $0.15 لكل مليون رمز إدخال و $0.50 لكل مليون رمز إخراج، تُخصم من رصيد مسبق الدفع. الطلبات الفاشلة أو المرفوضة لا تُحسب تكلفتها.
مثال عملي مع مكالمة تنظيف النص أعلاه. لنفترض أن الموجّه يحتوي على 1,000 رمز، والرد المنقح يحتوي على 500 رمز.
- الإدخال: 1,000 / 1,000,000 × $0.15 = $0.00015
- الإخراج: 500 / 1,000,000 × $0.50 = $0.00025
- المجموع: $0.0004 لكل استدعاء
لذلك يغطي رصيد التجربة البالغ $0.50 حوالي 1,250 استدعاءً بهذا الحجم ($0.50 / $0.0004). ستختلف أرقامك الخاصة، لأن النصوص الصوتية تختلف في الطول، لكن الطريقة نفسها: احسب الرموز الداخلة، احسب الرموز الخارجة، اضرب.
عند شحن الرصيد، يتم قبول أي مبلغ صحيح من $20 إلى $500. الشحنات الأكبر تحمل مكافأة: +5% من $50، +10% من $100 و+15% من $200. على سبيل المثال، شحن بقيمة $100 يمنحك رصيدًا بقيمة $110. يمكنك الدفع بالعملات المشفرة (USDT على TRC20، USDC على Base).
الحفاظ على أمان المفتاح
مفتاح API هو كلمة مرور لرصيدك. يمكن لأي شخص يملكه إنفاق رصيدك، لذا عامله بهذه الطريقة.
- احتفظ به بعيدًا عن أنظمة التحكم في الإصدار. اقرأه من متغير بيئة أو مدير أسرار.
- لا تدرجه في كود جافا سكريبت الخاص بالمتصفح أو في حزمة تطبيق الهاتف المحمول. يمكن فحص أي شيء يعمل على جهاز المستخدم. ضع خادمًا صغيرًا بين واجهة المستخدم والـ API واسمح للخادم بإضافة الرأس.
- لا تلصقه في لقطات الشاشة أو التذاكر أو رسائل الدردشة.
- إذا كنت تعتقد أن المفتاح قد تسرب، توقف عن استخدامه وتواصل مع الدعم الفني على الفور بدلاً من الانتظار لرؤية ما إذا كان هناك أي شيء يحدث.
من حيث الخصوصية: لا تُستخدم المطالبات المرسلة إلى واجهة برمجة التطبيقات للتدريب. هذا بيان حول الخدمة، وليس سببًا لإرسال أسرار لا تحتاج إلى إرسالها. قم بإزالة البيانات الشخصية من النصوص الصوتية عندما لا تتطلب المهمة ذلك.
عند فشل الاستدعاء
تأتي معظم مشاكل اليوم الأول من أحد الأسباب الأربعة.
عنوان URL الأساسي خاطئ
الخطأان المعتادان هما عدم وجود /v1 ووجود /chat/completions مكرر. قارن قيمة عنوان URL حرفًا بحرف مع القيمة الموجودة في الجدول أعلاه.
يحتوي المفتاح على حرف زائد
النسخ من صفحة غالبًا ما يجلب مسافة أو سطرًا جديدًا في النهاية. قص القيمة في الكود الخاص بك، وتأكد من أن العنوان يبدأ بـ Bearer، ثم مسافة واحدة، ثم المفتاح.
اسم النموذج ليس uncensored
تستخدم العملاء غالبًا اسم نموذج افتراضي مختلف. اضبط اسم النموذج صراحةً في كل استدعاء.
HTTP 429
هناك نوعان، ويحدد رمز الخطأ الفرق بينهما. يعني rate_limited أنك أرسلت طلبات كثيرة جدًا في الدقيقة الواحدة. يعني concurrency أن عدد الطلبات النشطة في آن واحد كبير جدًا. يحتفظ الطلب الذي يستخدم البث المتدفق بمكانه في الطلبات المتزامنة حتى ينتهي البث، لذا يمكن أن يؤدي القارئ البطيء إلى هذا الخطأ حتى بمعدل طلبات منخفض. يعني رمز 429 مع رأس Retry-After: 5 أن الخدمة مثقلة مؤقتًا؛ انتظر خمس ثوانٍ ثم أعد المحاولة. يؤدي تطبيق استراتيجية زيادة زمنية أسية قصيرة في العميل إلى التعامل مع الحالات الثلاث.
لمعرفة القائمة الكاملة للمعاملات، وتنسيق البث المتدفق، وتفاصيل استدعاء الدوال، راجع وثائق API.
المزيد من الأدلة
أسئلة وأجوبة
هل هذا هو نفس مفتاح OpenAI؟
لا. يتبع نفس تنسيق الطلب، لذا تعمل مكتبات SDK الخاصة بـ OpenAI معه، لكنه صادر عن هذه الخدمة ويعمل فقط مع عنوان URL الأساسي لهذه الخدمة.
هل أحتاج إلى بطاقة ائتمان للحصول على مفتاح؟
لا. سجّل باستخدام Google أو البريد الإلكتروني، ثم احصل على رصيد تجريبي بقيمة $0.50 بنقرة واحدة في صفحة المفتاح. لا يتطلب الرصيد التجريبي بطاقة ائتمان وهو صالح لمدة 7 أيام.
ما اسم النموذج الذي يجب أن أستخدمه؟
استخدم uncensored في حقل النموذج. سيظهر استدعاء GET /v1/models ما يمكن للمفتاح الوصول إليه.
هل يمكنني استخدام نفس المفتاح من عدة خوادم؟
نعم، لكن الحدود تنطبق على المفتاح ككل: 8 طلبات متزامنة و300 طلب في الدقيقة للمفتاح الكامل، و2 و60 للمفتاح التجريبي.
هل يعمل المفتاح للصور أو الصوت؟
لا. الـ API يدعم النصوص فقط. لا يولّد أو يحول الصوت أو الصور، ولا يدعم التضمينات أو ضبط النماذج.
مفتاحك على بُعد نموذج واحد
أنشئ حساباً، وانسخ المفتاح، ثم غيّر عنوان URL الأساسي. هذه هي الإعدادات الكاملة.