لقد قمت بتوصيل نقطة نهاية لصور الوجه في فترة ما بعد الظهر. استغرق التسعير وقتًا أطول.

التكامل صغير حقًا. انشر صورة مرجعية إلى رابط واحد، واستقصِ رابطًا ثانيًا حتى تتغير الحالة، واقرأ رابط الصورة من الحمولة. ساعة عمل إذا كنت قد أرسلت أي شيء غير متزامن من قبل.

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

هذه خريطة عملية لذلك القرار لأي شخص يدمج واجهة برمجة تطبيقات لصور جواز السفر بالذكاء الاصطناعي في منتج. كل سعر واسم حقل وتعداد أدناه جاء من مخططات Atlas Cloud الخاصة ونقطة تسعيرها في 18 أغسطس 2026.

الخلاصات الرئيسية

• صورة جواز السفر ليست فئة نموذج خاصة بها في طبقة API. إنها استدعاء تحرير صورة بهدف ثابت، لذا فإن نقطة النهاية التي تختارها تحدد تكلفتك لكل مستخدم أكثر بكثير مما يحدده النص التوجيهي.
• نقطة نهاية صورة جواز السفر المخصصة تقبل حقلين بالضبط وتعيد صورة واحدة. نقاط نهاية التحرير العامة تقبل عشرات الحقول وتتوقع منك وصف النتيجة بنفسك.
• ترك معامل الحجم خارج استدعاء تحرير Seedream يضعك بصمت في الطبقة الأعلى سعرًا، مما يضاعف الفاتورة دون أي خطأ يمكن اكتشافه.
• كل نموذج على المنصة يشترك في حلقة إرسال واستقصاء واحدة، لذا فإن تبديل نقاط النهاية لاحقًا هو تغيير في سلسلة النموذج وليس إعادة كتابة.
• يمكنك تأكيد نمط الإخراج قبل كتابة أي كود: مولد صور جواز السفر بالذكاء الاصطناعي المجاني يمنح كل حساب مؤهل تشغيلًا واحدًا بدقة كاملة.

لماذا يلجأ المطورون إلى واجهة برمجة تطبيقات صور جواز السفر بالذكاء الاصطناعي بدلاً من موقع صور جواز السفر

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

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

هناك ميزة ثانية أكثر هدوءًا. نقاط نهاية الأدوات تنشر مخططاتها، لذا يمكنك قراءة سطح الإدخال بالكامل قبل الالتزام بواحدة. Atlas Cloud تكشف عن مجموعة من أدوات الصور أحادية الغرض هذه، وأشكال طلباتها متطابقة تقريبًا:

إدخال صورة جواز السفر هو الأكثر صرامة من بين الثلاثة: صورة واحدة داخلة، صورة واحدة خارجة.

أين تتناسب Atlas Cloud للمطورين الذين يبنون ميزات صور جواز السفر

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

بعد هذه الجولة الأولى، يصبح نفس النموذج ملعبًا مقننًا. ملعب صور جواز السفر بالذكاء الاصطناعي يطبع سعره على زر التشغيل قبل أن ترسل، وإشعار فوق أداة التحميل يوضح أن الأصول تذهب إلى تخزين Atlas Cloud بدلاً من سحبها من رابط تلصقه. إذا كنت تفضل كتابة النص التوجيهي بنفسك والتحكم في الملابس والخلفية والتأطير، فإن عائلة Nano Banana 2 تغطي مسار التحرير العام، ويحدث نوعها Lite أن يكون أرخص لكل صورة من الأداة الثابتة. قسم التسعير يتناول ما تكلفه هذه المقايضة.

طريقتان لاستدعاء واجهة برمجة تطبيقات مولد صور جواز السفر بالذكاء الاصطناعي

كلا المسارين يشغلان نفس سلسلة النموذج. الفرق هو ما إذا كان شخص ما يراقب النتيجة وهي تعود.

الطريقة 1: اختبار واجهة برمجة تطبيقات صور جواز السفر الاحترافية في الملعب

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

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

الطريقة 2: استدعاء واجهة برمجة تطبيقات صور جواز السفر بالذكاء الاصطناعي من الكود الخاص بك

التدفق التشغيلي هو طلبا HTTP. الوصول إليه يتطلب ثلاث خطوات.

الخطوة 1: إنشاء مفتاح API. قم بتوليد واحد في وحدة تحكم Atlas Cloud، وانسخه، واحتفظ به من جانب الخادم. نقاط نهاية الأداة تأخذ نفس المفتاح مثل كل نموذج على المنصة.

الخطوة 2: التحقق من وثائق API. المصادقة، ونقطة نهاية الصورة المشتركة، وعقد الاستقصاء موجودة في وثائق API. كل نموذج ينشر أيضًا مخطط OpenAPI الخاص به، وهذا هو atlascloud-tool-headshot.json، يستحق القراءة قبل أن تخمن أسماء الحقول. صفحة النموذج تحمل أيضًا علامة تبويب API بجانب الملعب، لذا فإن شكل الطلب على بعد نقرة واحدة من حيث اختبرته. شيء كلفني وقتًا هنا: قائمة النماذج العامة للمنصة أعادت 466 إدخالًا عندما فحصت، ولم تكن أداة صور جواز السفر من بينهم، على الرغم من أن أدواتها الشقيقة للتحسين وتنظيف الصور كانت موجودة. المخطط وملف readme والتسعير كلها تعمل بشكل طبيعي، لذا فإن نقطة النهاية نشطة. البحث في الكتالوج وحده لن يظهرها.

الخطوة 3: إرسال الطلب الأول. الإرسال غير متزامن ويعيد معرف توقع.

BashCopy
1curl -X POST https://api.atlascloud.ai/api/v1/model/generateImage \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
4  -d '{
5    "model": "atlascloud/tool/headshot",
6    "image": "https://your-cdn.com/portraits/emp-4192.jpg"
7  }'

استقصِ حتى تستقر الحالة:

BashCopy
1curl -s https://api.atlascloud.ai/api/v1/model/prediction/<PREDICTION_ID> \
2  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"

الحمولة المكتملة تحمل outputs، وهي مصفوفة تظل فارغة حتى تنتهي المهمة ثم تحمل رابط الصورة المستضافة. status هو شرط الحلقة الخاص بك ويقرأ created أو processing أو completed أو failed.

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

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

تسعير واجهة برمجة تطبيقات صور جواز السفر بالذكاء الاصطناعي لكل صورة مولدة

كل رقم أدناه جاء من نقطة حساب التسعير الخاصة بالمنصة في 18 أغسطس 2026، مسعرة مقابل الطلب الدقيق الذي سأرسله. جميعها أعادت علم خصم بقيمة 100، مما يعني عدم وجود عرض ترويجي، باستثناء المتغيرين في القسم الفرعي التالي.

نقطة نهاية صور جواز السفر المخصصة تقع عند 0.045 دولار، مما يضع ألف صورة جواز سفر مولدة بسعر 45 دولارًا. Nano Banana 2 Lite Edit يقل عنها بسعر 0.04 دولار، لذا فإن نفس الحجم يكلف 40 دولارًا، وملف readme الخاص به صريح بأن عدد صور الإدخال المرجعية لا يؤثر على السعر. توفير تلك الـ5 دولارات لكل ألف يعني كتابة وصيانة النص التوجيهي الخاص لصور جواز السفر، وهو قرار حقيقي وليس واضحًا.

الإعدادات الافتراضية هي حيث يتسرب المال. Seedream v5.0 Pro Edit يتقاضى 0.045 دولار بدقة 1024×1024 أو 2048×1152، لكن معامل الحجم الخاص به الافتراضي هو 2048×2048، مما يضعه في الطبقة الأعلى بسعر 0.09 دولار. حذف الحقل يدفعك ضعف السعر دون أي خطأ يمكن اكتشافه. نفس النموذج يضيف 0.003 دولار لكل صورة إدخال بعد الأولى، وهو ما يؤكده طلب صورتين بسعر 0.048 دولار. GPT Image 2 Edit يكرر النمط من زاوية مختلفة: الجودة الافتراضية هي medium بسعر 0.071728 دولار، والانتقال إلى high يأخذ صورة واحدة بدقة 1024×1024 إلى 0.229768 دولار.

مستويات الدقة هي المتغير الأخير. Nano Banana 2 Edit يتقاضى 0.08 دولار و0.12 دولار و0.16 دولار لدقة 1k و2k و4k، بينما يقدم متغير Lite دقة 1k فقط. بالنسبة لصورة ملف شخصي تنتهي عرضها ببضع مئات من البكسل، فإن الدفع مقابل 4k هو إنفاق على بكسلات لن يراها أحد.

نقاط نهاية المطور المخفضة في تشكيلة واجهة برمجة تطبيقات صور جواز السفر بالذكاء الاصطناعي

متغيران حملا خصمًا نشطًا على اسم الحقل في يوم الكتابة:

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

ما تغيره واجهة برمجة تطبيقات صور جواز السفر بالذكاء الاصطناعي في الوجه

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

قمت بتشغيل صورة شخصية واحدة عبر كلا المسارين لرؤية أين يختلفان.

تم التشغيل في 19 أغسطس 2026. الإدخال هو شخص خيالي مولّد بالذكاء الاصطناعي، وليس صورة لأي شخص حقيقي.

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

الذهاب في مسار التحرير العام يعيد القرارات إليك، على حساب الاضطرار إلى ذكرها. قارن ما يقبله كل منهما:

شيئان يجب التخطيط لهما. ملف readme الخاص بالمنصة للطبقة Lite يقول إن النموذج قد يواجه صعوبة في الوجوه الصغيرة والتهجئة الدقيقة والتفاصيل الدقيقة جدًا. الإدخال في ذلك الاختبار بدأ كصورة كاملة الطول حيث احتل الوجه جزءًا صغيرًا من الإطار ومرت بشكل جيد، لذا فإن التحذير ليس حدًا صعبًا، لكن قص صورة جماعية هو الحالة الأصعب ويستحق الفحص. نفس ملف readme يذكر أن الصور المحررة تتضمن بيانات اعتماد محتوى C2PA وعلامة مائية SynthID غير محسوسة بشكل افتراضي. هذا التوقيع يسافر مع الملف. LinkedIn يعرض بيانات اعتماد المحتوى على أي صورة تصل مع معلومات C2PA مرفقة، لذا فإن صورة جواز سفر مولدة بهذه الطريقة يمكن أن تظهر في ملف شخصي مع أصلها معروضًا.

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

تشغيل واجهة برمجة تطبيقات صور جواز السفر بالذكاء الاصطناعي في الإنتاج

بعض الأمور التي تستحق اتخاذ قرار بشأنها قبل الشحن وليس بعده.

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

الأسئلة المتداولة

هل هناك واجهة برمجة تطبيقات صور جواز السفر بالذكاء الاصطناعي للمطورين مع طبقة مجانية؟

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

ما هي سلسلة النموذج التي يجب استخدامها لاستدعاء واجهة برمجة تطبيقات صور جواز السفر الاحترافية؟

atlascloud/tool/headshot إذا كنت تريد المعالجة التجارية الثابتة بدون نص توجيهي للصيانة. google/nano-banana-2-lite/edit إذا كنت بحاجة إلى التحكم في الملابس أو الخلفية أو نسبة العرض إلى الارتفاع وكنت على استعداد لكتابة التعليمات بنفسك. كلاهما يرسل إلى /api/v1/model/generateImage.

كم تكلفة واجهة برمجة تطبيقات صور جواز السفر بالذكاء الاصطناعي لكل صورة؟

0.045 دولار عبر نقطة النهاية المخصصة اعتبارًا من 18 أغسطس 2026، بدون خصم نشط. عبر النقاط الاثنتي عشرة التي سعّرتها على نفس المنصة، تراوحت تكلفة الصورة المحررة الواحدة من 0.028 دولار إلى 0.229768 دولار اعتمادًا على النموذج ومستوى الدقة وإعداد الجودة.

هل تحافظ واجهة برمجة تطبيقات مولد صور جواز السفر بالذكاء الاصطناعي على وجه الشخص الحقيقي؟

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

هل إخراجات واجهة برمجة تطبيقات صور جواز السفر بالذكاء الاصطناعي موقعة أو تحتوي على علامة مائية؟

تتضمن تحريرات Nano Banana 2 Lite بيانات اعتماد محتوى C2PA وعلامة مائية SynthID بشكل افتراضي، وفقًا لوثائق النموذج على المنصة. سلوك التوقيع خاص بالنموذج، لذا تحقق من ملف readme لأي نقطة نهاية تستقر عليها.

هل يمكن استخدام صور جواز السفر المولدة عبر API على LinkedIn؟

نعم، بشرط أن تعكس الصورة الشخص الفعلي. إرشادات الصور في LinkedIn تسمح بالتمثيلات الفنية لنفسك وتحظر الصور التي تتكون فقط من شبه أشخاص آخرين أو صور مخزنة أو شخصيات خيالية.

الخاتمة

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

في اللحظة التي يحتاج منتجك إلى شيء محدد، سترة معينة، خلفية علامة تجارية، قص صورة شخصية يطابق مكون البطاقة الخاص بك، تلك النقطة النهاية ليس لديها ما تقدمه وأنت تكتب نصًا توجيهيًا سواء خططت لذلك أم لا. سؤالان يحددان ذلك، وليس أي منهما هو سعر الوحدة. هل سيظل شخص ما يحافظ على هذا النص التوجيهي بعد عامين؟ وهل ستصل الفجوة بين إخراج 1k وإخراج 4k إلى شاشة المستخدم؟