يأتي GPT-5.5 من OpenAI مع واجهة برمجة تطبيقات مدفوعة: 5 دولارات لكل مليون رمز إدخال، و30 دولارًا لكل مليون رمز إخراج. بالنسبة لمشروع جانبي، أو بناء لمسابقة هاكاثون، أو تطبيق عام مجاني، فإن هذه الفاتورة توقف العمل قبل أن يبدأ. هناك حل هيكلي واحد: Puter.js يعرض كتالوج OpenAI بأكمله (GPT-5.5، GPT-5.5 Pro، كل متغيرات GPT-5.x، GPT-Image-2، DALL-E، OpenAI TTS) بدون مفتاح OpenAI، ويحاسب المستخدم النهائي بدلاً عنك. بالنسبة للمطور، السطح مجاني وغير محدود.
ملخص سريع
- Puter.js يمنح المطورين وصولاً مجانيًا وغير محدود إلى كتالوج نماذج OpenAI الكامل بدون مفتاح API، أو حساب OpenAI، أو خادم.
- تشمل نماذج النصوص المدعومة gpt-5.5, gpt-5.5-pro, gpt-5.4, gpt-5, gpt-5-mini, o1, o3, gpt-4.1, gpt-4o، بالإضافة إلى كل متغيرات الدردشة والكودكس.
- الصور: gpt-image-2, gpt-image-1.5, dall-e-3. تحويل النص إلى كلام (TTS): gpt-4o-mini-tts, tts-1, tts-1-hd.
- علامة
<script>واحدة، واستدعاء دالة واحد (puter.ai.chat)، وأنت تتحدث إلى GPT-5.5. - تعمل جميع ميزات البث (Streaming)، واستدعاء الدوال (function calling)، وإدخال الرؤية (vision input)، وتوليد الصور (image generation)، وتحويل النص إلى كلام (text-to-speech) في المتصفح.
- يغطي المستخدم النهائي استخدامه من حساب Puter؛ أنت تدفع صفر، إلى الأبد.
- استخدم Apidog لمقارنة نفس الموجه (prompt) بين Puter وواجهة OpenAI API الرسمية لتخطيط الترحيل.
زر
كيف يعمل مفهوم "مجاني غير محدود"
Puter.js يقلب نموذج فوترة LLM. بدلاً من أن تحمل أنت مفتاح OpenAI وتتحمل تكلفة كل رمز، يقوم المستخدم النهائي بتسجيل الدخول إلى Puter (حساب مجاني) وتُخصم المكالمة من رصيده. تحصل حسابات Puter الجديدة على رصيد بدء؛ ويقوم المستخدمون بإعادة الشحن إذا أرادوا المزيد.
بالنسبة للمطور، تترتب ثلاث أمور:
- لا يوجد حساب OpenAI، ولا مفتاح في مستودعك. لا يوجد خطر تسريب، ولا حاجة للدوران، ولا إدارة مفاتيح خاصة بالمشروع.
- لا يوجد حد للاستخدام من جانبك. يعمل كل مستخدم على حسابه الخاص، لذا فإن "حدك" يتناسب طرديًا مع قاعدة المستخدمين لديك.
- لا يوجد تعرض للفواتير. لن ترى فاتورة Stripe من OpenAI أبدًا؛ لا تحتاج إلى التفاوض على شروط المؤسسات.
المقايضة: هذا يعمل في المتصفح أولاً. لا يمكن لبرنامج Node في الواجهة الخلفية استخدام Puter بدون جلسة مستخدم مسجلة الدخول. للاستخدام في الواجهة الخلفية، لا تزال واجهة OpenAI API الرسمية هي المسار الصحيح.
الخطوة 1: التثبيت
علامة CDN واحدة، لا توجد خطوة بناء:
<script src="https://js.puter.com/v2/"></script>
هذا هو التثبيت بالكامل. أو لتطبيق مجمّع:
npm install @heyputer/puter.js
import { puter } from '@heyputer/puter.js';
تعمل نسخة CDN في أي ملف HTML، أو نموذج أولي لمسابقة هاكاثون، أو موقع ثابت، أو إضافة متصفح. تمنحك نسخة NPM ميزات tree-shaking وأنواع TypeScript.
الخطوة 2: اختر نموذجًا
يعرض Puter تشكيلة GPT-5.x الكاملة بالإضافة إلى كل ما هو أقدم. القائمة المختصرة:
| معرف النموذج | متى تستخدمه |
|---|---|
gpt-5.5-pro |
الاستدلال الأعمق؛ وكلاء البرمجة، التحليل المعقد |
gpt-5.5 |
النموذج اليومي الافتراضي؛ توازن قوي بين التكلفة والجودة |
gpt-5.4-nano |
الأرخص والأسرع للنصوص؛ التصنيف بكميات كبيرة |
gpt-5.4-mini |
متوسط المستوى؛ جيد لواجهات مستخدم الدردشة |
gpt-5.3-codex |
المهام الخاصة بالكود |
o3 |
سلاسل الاستدلال المعقدة |
o1-pro |
التخطيط متعدد الخطوات القائم على الوكلاء |
gpt-4.1, gpt-4o, gpt-4o-mini |
خط أساس مستقر ومفهوم جيدًا |
توليد الصور:
gpt-image-2: الأحدث، إخراج حاد، سريع.gpt-image-1.5/gpt-image-1/dall-e-3/dall-e-2: أقدم ولكن مستقرة.
تحويل النص إلى كلام:
gpt-4o-mini-tts: الأحدث، يبدو الأكثر طبيعية.tts-1,tts-1-hd: تحويل النص إلى كلام كلاسيكي (TTS)، زمن استجابة أقل.
الخطوة 3: اجعل GPT-5.5 يتحدث
الحد الأدنى لمكالمة الدردشة:
<!DOCTYPE html>
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
puter.ai.chat(
"Explain WebSockets in three sentences",
{ model: "gpt-5.5" }
).then(response => {
puter.print(response);
});
</script>
</body>
</html>
افتح في المتصفح. يتعامل Puter مع المكالمة، ويسجل المستخدم الدخول (أو ينشئ حساب Puter مجانيًا عند التشغيل الأول)، وتُطبع الاستجابة على الصفحة. لا يوجد مفتاح API، لا متغير بيئة، لا خادم.
الخطوة 4: بث الاستجابة
بالنسبة لواجهات مستخدم الدردشة والإجابات الطويلة، يعد البث هو الإعداد الافتراضي الصحيح. مرر stream: true واستهلك المكرر (iterator):
const response = await puter.ai.chat(
"Explain the theory of relativity in detail",
{ model: "gpt-5.5", stream: true }
);
for await (const part of response) {
puter.print(part?.text);
}
كل part.text هو جزء من الرموز (token chunk). أضفه إلى فقاعة واجهة المستخدم الخاصة بك؛ يرى المستخدم النص يظهر كلمة بكلمة.
الخطوة 5: الرؤية (إدخال الصور)
مرر عنوان URL للصورة كـالوسيط الثاني؛ يقرأ النموذج الصورة ويجيب على الموجه (prompt) المتعلق بها:
puter.ai.chat(
"What do you see in this image? Describe colors, objects, and mood.",
"https://assets.puter.site/doge.jpeg",
{ model: "gpt-5.5" }
).then(response => {
puter.print(response);
});
يعمل هذا على كل نماذج GPT-5.x ومتغيرات GPT-4o. حالات الاستخدام: توليد نصوص بديلة (alt-text)، أسئلة وأجوبة بصرية، تحليل لقطات الشاشة، التعرف الضوئي على الحروف (OCR)، أدوات الوصول.
الخطوة 6: توليد الصور
تعيد دالة txt2img في Puter عنصر <img> مع الصورة المولدة المحملة بالفعل:
puter.ai.txt2img(
"A futuristic cityscape at night, cinematic, neon, rain",
{ model: "gpt-image-2" }
).then(imageElement => {
document.body.appendChild(imageElement);
});
يدفع المستخدم تكلفة توليد الصورة من حسابه في Puter (عادة بضعة سنتات لكل صورة). بالنسبة لمولد صور عام مجاني، هذا هو أنظف إعداد موجود اليوم.
الخطوة 7: تحويل النص إلى كلام
يتم عرض خط TTS من OpenAI عبر txt2speech. تُرجع الدالة عنصر <audio> بالصوت المُولَّد:
puter.ai.txt2speech(
"Welcome back. Your account balance is $1,247.50.",
{ provider: "openai", model: "gpt-4o-mini-tts" }
).then(audio => {
audio.setAttribute("controls", "");
document.body.appendChild(audio);
});
استخدمه للموجهات الصوتية، التعليقات الصوتية للتطبيقات، مقدمات البودكاست، أو السرد لغرض إمكانية الوصول.
الخطوة 8: استدعاء الدوال
شكل OpenAI القياسي. صرح بالأدوات، يصدر النموذج مصفوفة tool_calls، تقوم أنت بالتنفيذ، ثم ترد:
const tools = [{
type: "function",
function: {
name: "get_weather",
description: "Get the current weather for a city.",
parameters: {
type: "object",
properties: { city: { type: "string" } },
required: ["city"],
},
},
}];
const response = await puter.ai.chat(
"What's the weather in Tokyo right now?",
{ model: "gpt-5.5", tools }
);
const toolCalls = response.message.tool_calls;
if (toolCalls?.length) {
// Execute the function on your side, then reply with the result
console.log(toolCalls[0].function.name, toolCalls[0].function.arguments);
}
شكل استدعاء الدوال يحاكي شكل OpenAI، لذا يمكن نقل أي تعريفات أدوات لديك اليوم مباشرةً. لاختبار تدفقات تعتمد على الأدوات في إعدادات بجودة إنتاجية، راجع اختبار خادم MCP في Apidog.
الخطوة 9: ضبط درجة الحرارة وعدد الرموز القصوى
مرر معلمات OpenAI القياسية في كائن الخيارات:
const response = await puter.ai.chat(
"Tell me about Mars",
{
model: "gpt-5.5",
temperature: 0.2,
max_tokens: 200,
}
);
درجة حرارة أقل (0.0-0.3) للإجابات الواقعية، وأعلى (0.7-1.0) للكتابة الإبداعية. يحدد max_tokens التكلفة من جانب المستخدم؛ وهو مفيد للحفاظ على رسوم كل مكالمة متوقعة عند نشر تطبيق عام.
ما تحصل عليه وما لا تحصل عليه
الوصول المجاني غير المحدود لـ GPT-5.5 عبر Puter حقيقي، ولكنه يمثل مجموعة فرعية من سطح واجهة OpenAI API الرسمية. التقسيم الصريح:
ما تحصل عليه:
- كتالوج GPT-5.x الكامل بما في ذلك 5.5، 5.5 Pro، 5.4 (mini, nano, pro)، وكل متغيرات الكودكس
- جميع نماذج OpenAI الأقدم (GPT-4.1, GPT-4o, o1, o3)
- GPT-Image-2 و DALL-E لتوليد الصور مجانًا
- خط OpenAI TTS بما في ذلك gpt-4o-mini-tts
- البث (Streaming)، الرؤية (vision)، استدعاء الدوال (function calling)، التحكم في درجة الحرارة (temperature control)، عدد الرموز القصوى (max_tokens)
قد لا تحصل على:
- واجهة برمجة تطبيقات الاستجابات (Responses API) (يستخدم Puter شكل Chat Completions)
- تخفيض التكلفة من خلال التخزين المؤقت للموجهات (Prompt caching)
- واجهة برمجة تطبيقات الملفات (Files API) (سياق المستندات المحملة)
- الاستخدام من جانب الخادم بدون سياق متصفح
- رؤوس حدود المعدل المباشرة من OpenAI
- وضع الإخراج المنظم من OpenAI وفرض مخطط JSON
للتدفقات العميقة بجودة الإنتاج، واجهة OpenAI API الرسمية هي الحل الصحيح. أما لتطبيقات المتصفح، والمشاريع الجانبية، والأدوات العامة، فإن Puter كافٍ.
متى تستخدم Puter مقابل واجهة OpenAI API الرسمية
التقسيم:
استخدم Puter عندما:
- تقوم بنشر تطبيق عام مجاني ولا ترغب في التعرض للفواتير.
- تقوم بإنشاء نموذج أولي ولا ترغب في إعداد علاقة فوترة مع OpenAI.
- تريد الوصول إلى OpenAI في موقع ثابت، مشروع هاكاثون، أو إضافة متصفح بدون واجهة خلفية.
- المستخدمون راضون عن تسجيل الدخول إلى Puter (أو يستخدمونه بالفعل).
استخدم واجهة OpenAI API الرسمية عندما:
- تحتاج إلى مكالمات من جانب الخادم (مهام cron، معالجات webhook، معالجة الدفعات).
- تحتاج إلى التخزين المؤقت للموجهات (prompt caching) لتوفير التكاليف على موجهات النظام الثابتة.
- تحتاج إلى واجهة برمجة تطبيقات الاستجابات (Responses API)، أو الملفات (Files)، أو مخرجات منظمة كاملة.
- تحتاج إلى علاقة تعاقدية للامتثال (اتفاقيات الشركاء التجاريين BAA، SOC 2، الإقامة).
- لن يتسامح المستخدمون مع خطوة تسجيل الدخول إلى Puter.
تبدأ معظم المشاريع على Puter لإنشاء النماذج الأولية وتنتقل إلى واجهة API الرسمية عندما تصل إلى أحد الحدود المذكورة أعلاه. عملية الترحيل مباشرة؛ شكل الرسالة هو نفسه.
لإعداد الإنتاج المدفوع، راجع كيفية استخدام GPT-5.5 API.
اختبار الدمج في Apidog
تحدث مكالمات Puter في المتصفح، لذا لا يمكنك برمجةها مباشرة من مُشغل اختبار الواجهة الخلفية. النمط الذي يعمل هو:
- أنشئ صفحة ثابتة صغيرة باستخدام سكربت Puter ومعامل استعلام (query parameter) للموجه.
- استخدم Apidog للتحقق من سطح واجهة OpenAI API الأصلية (عند الترحيل في النهاية).
- احتفظ بالبيئتين كبيئات منفصلة في نفس مجموعة Apidog حتى تتمكن من التبديل بنقرة واحدة.

قم بتنزيل Apidog وأنشئ بيئتين: puter-prototype (عنوان URL محلي يستضيف صفحة Puter الخاصة بك) و openai-prod (https://api.openai.com/v1). تنتقل المجموعة بسلاسة عند التخرج. لأنماط اختبار API الأوسع، راجع أداة اختبار API لمهندسي ضمان الجودة.
الأسئلة الشائعة
هل هذا غير محدود حقًا، أم أن هناك سقفًا خفيًا؟ غير محدود من جانب المطور، نعم. يمتلك المستخدم النهائي أي رصيد موجود في حسابه على Puter؛ تحصل الحسابات الجديدة على رصيد بدء ويقوم المستخدمون بإعادة الشحن إذا أرادوا المزيد. لا يوجد سقف لكل مطور.
هل أحتاج إلى حساب OpenAI؟ لا. Puter يدير العلاقة مع OpenAI. لن ترى مفتاح OpenAI أبدًا.
هل يمكنني استخدام هذا في الإنتاج؟ نعم، لتطبيقات المتصفح. يدير Puter البنية التحتية للإنتاج. السؤال الصحيح هو ما إذا كان المستخدمون لديك على استعداد لتسجيل الدخول إلى Puter؛ إذا كانت الإجابة نعم، فابدأ بالنشر.
هل يؤدي GPT-5.5 عبر Puter نفس أداء واجهة API الرسمية؟ إخراج النموذج هو نفسه؛ يستدعي Puter واجهة OpenAI API الرسمية نيابة عن المستخدم. قد يكون زمن الاستجابة أعلى قليلاً بسبب الخطوة الإضافية، لكن سلوك النموذج لم يتغير.
ماذا عن توفير التخزين المؤقت للموجهات (prompt caching)؟ لا يعرض Puter ضوابط تسعير التخزين المؤقت للموجهات من OpenAI اليوم. إذا كان لديك موجه نظام ثابت بحجم 50 ألف رمز وتحتاج إلى خصم التخزين المؤقت، فاستخدم واجهة API الرسمية.
هل يمكنني استخدام هذا في خدمة خلفية؟ ليس بشكل سلس. Puter يعتمد على المتصفح أولاً ويفترض وجود جلسة مستخدم. يجب أن تستخدم الخدمات الخلفية واجهة OpenAI API الرسمية. لخيارات جانب الخادم المجانية، راجع كيفية استخدام GPT-5.5 API مجانًا.
ما هو النموذج الذي يجب أن أستخدمه افتراضيًا؟ gpt-5.5 للاستدلال اليومي. gpt-5.4-nano للتصنيف بكميات كبيرة. gpt-5.5-pro لمهام الاستدلال الصعبة. o3 عندما تحتاج إلى سلاسل استدلال طويلة.
هل سيتم فرض رسوم عالية على مستخدمي؟ تكلفة معظم الاستخدامات التي تشبه الدردشة هي بضعة سنتات لكل جلسة بأسعار OpenAI. يمكن للمستخدم العادي إجراء عشرات المحادثات على رصيد Puter الأولي قبل الحاجة إلى إعادة الشحن. توليد الصور أغلى؛ حدد max_tokens وتجنب مكالمات التوليد المهدرة.
هل يمكنني توليد الصور مجانًا باستخدام Puter؟ نعم، عبر txt2img باستخدام gpt-image-2 أو DALL-E. يدفع المستخدم تكلفة توليد الصورة من رصيده في Puter. للدليل الرسمي لواجهة API المدفوعة، راجع كيفية استخدام GPT-Image-2 API.
خلاصة القول
الوصول المجاني غير المحدود إلى GPT-5.5 عبر Puter.js هو أنظف مسار لأي تطبيق يعتمد على المتصفح ويريد مخرجات بجودة OpenAI بدون فواتير بجودة OpenAI. أضف السكربت، اختر نموذجًا، اكتب الموجه. يغطي المستخدم النهائي الاستخدام؛ وأنت تنشر بدون مفتاح.
لأعباء العمل من جانب الخادم، وتخزين الموجهات المؤقت، وواجهة برمجة تطبيقات الاستجابات (Responses API)، أو المخرجات المنظمة الكاملة، لا تزال واجهة OpenAI API الرسمية هي الحل الصحيح. أما للنماذج الأولية، وبناء الهاكاثونات، والتطبيقات العامة المجانية، والمواقع الثابتة، فإن Puter هو الحل.
أنشئ الطلب مرة واحدة في Apidog، وقارن أداء Puter مقابل واجهة API الرسمية، واختر المسار الذي يتناسب مع شكل عملك.
زر
