واجهة برمجة تطبيقات تصيير Graydient AI
إذا كنت تبني تطبيقًا، أداة داخلية أو خط أنابيب تصيير، يوفر لك Graydient نماذج صور وفيديو وLLM مفتوحة على GPUs مخصصة، خلف API واحد، بسعر شهري ثابت.
أي خطة تشملها
API الشخصي يأتي فقط مع Video Max. صور و Video Plus لا تشمل الوصول إلى API. يمكنك الترقية، التخفيض أو الإلغاء في أي وقت في بوابة الفواتير، مع رسوم محسوبة تناسبيًا. أسعار خطة الأعمال وAPI على business.graydient.ai.
API الشخصي هو مفتاح لمستخدم بشري واحد، ولا يُسمح بحركة المرور الآلية على أي خطة شخصية. هذا يعني لا بوتات، سكريبتات، مجدولات، مهام مجمعة، أدوات تجريف، تطبيقات متعددة المستخدمين أو إعادة بيع الوصول. وهو محدود بمعدل: حافظ على حوالي استدعاء واحد كل 10 ثوانٍ. يتم إلغاء المفاتيح التي ترسل حركة مرور آلية أو مفرطة دون إشعار.
بناء منتج متعدد المستخدمين أو بعلامة تجارية بيضاء
المستخدمون الافتراضيون وتسجيل الدخول بعلامة بيضاء هي ميزات على مستوى الأعمال للتطبيقات المنشورة، أي المنتجات التي بها العديد من المستخدمين. تعمل على API الشخصي، لذا يمكنك بناء واختبار تدفقات متعددة المستخدمين وعلامة بيضاء على Video Max أثناء التطوير.
التشغيل الحي مع منتج متعدد المستخدمين، حركة مرور آلية أو إعادة بيع الوصول يحتاج إلى خطة الأعمال: خادم GPU مخصص. business.graydient.ai يشرح ما هو متضمن، يسرد الأسعار ويبيعه.
| API الشخصي (Video Max) | نشر الأعمال | |
|---|---|---|
| المستخدمون | مستخدم واحد (أنت) | مستخدمي منتجك |
| إعادة البيع | غير مسموح | مسموح |
| المستخدمون الافتراضيون وتسجيل الدخول بعلامة بيضاء | بناء واختبار | تشغيل مباشر |
| كيفية الحصول عليه | اشترك في Video Max | خادم GPU مخصص أو اتفاقية عمل |
كيف تعمل API
الإصدار الحالي هو V3، على https://cloud.graydient.ai/api/v3/. يتبع مواصفة JSON:API: أرسل واستقبل application/vnd.api+json، وقم بالمصادقة باستخدام رمز HTTP Bearer القياسي من صفحة رموز API الخاصة بك، واقرأ النتائج من كائن بيانات يحتوي على عضو attributes.
التصيير غير متزامن. ترسل POST إلى POST /api/v3/render/ مع موجه ورابط رد الاتصال callback_url المطلوب. يرد Graydient فوراً بـ render_hash بالإضافة إلى أوقات الانتظار والتصيير المقدرة. عند انتهاء المهمة، يرسل POST بالنتائج إلى webhook الخاص بك. الحقول الاختيارية تشمل:
- error_url: webhook للأخطاء
- init_image و mask_image: للصورة إلى صورة والرسم فوق الصور
- placeholders: عناوين URL للصور المسماة لوضعيات ControlNet أو محولات IP
- progressive_return: رد اتصال واحد لكل صورة
- session_id: لربط التصييرات بمستخدميك
تُشغّل سير العمل من خلال نفس نقطة النهاية مع أمر سير العمل في الموجه.
الحالة بدون استدعاء متكرر: GET GET /api/v3/render/{render_hash} يعيد حالة التصيير، لكن الوثائق تطلب عدم الاستدعاء المتكرر. استخدم webhook، أو تدفق WebSocket على wss://cloud.graydient.ai/render-events/{render_hash}، الذي يرسل أحداث started و image_done و done و error.
عائلات نقاط النهاية الأخرى
- الدردشة: دردشة LLM مع شخصية. الردود تذهب إلى رد اتصال أو تعود مباشرة مع sync: true، ونماذج الرؤية تقبل image_url.
- المفاهيم: قائمة النماذج و LoRAs المتاحة.
- سير العمل: قائمة سير العمل وما يدعمه كل منها، مثل txt2img و img2img و txt2vid و img2vid.
- قاعدة المعرفة: أنشئ مجالاً، أضف حقائق، زحف عناوين URL، ثم ابحث أو دردش.
- المهارات: تحويل الطلبات بلغة طبيعية إلى أوامر سير عمل.
- المستخدمون الافتراضيون: اربط مستخدميك النهائيين بسجلات على حسابك. ابني واختبر باستخدامه على API الشخصي، ثم ابدأ مباشرة على نشر تجاري.
المرجع الكامل: توثيق API. الوثائق تقول إنها لا تزال قيد التطوير.
حالات الاستخدام النموذجية
- تشغيل تطبيقك الخاص: استخدم Graydient كخلفية تصيير لميزة صورة أو فيديو أو دردشة. طور على API الشخصي، ثم انتقل إلى نشر تجاري عند وصول المستخدمين الحقيقيين.
- استخدام نماذجك المستضافة: قم بالتصيير باستخدام LoRAs ونقاط التحقق التي قمت بتثبيتها. انظر استضف نماذج الذكاء الاصطناعي الخاصة بك.
- تشغيل سير عمل بأسلوب ComfyAPI عن بُعد: استدعاء سير العمل المعين من كودك الخاص.
- صور المنتجات والكتالوج: تكبير، تعديل أو إعادة تصميم الصور من خط أنابيب، ضمن حد معدل API الشخصي.
- التصيير بالجملة: للدفعات الكبيرة والمستمرة، استخدم خادم GPU مخصص بدلاً من API الشخصي.
- دردشة قاعدة المعرفة: أنشئ مساعد دعم أو توثيق على نقاط نهاية قاعدة المعرفة والدردشة.
خوادم GPU المخصصة
إذا كنت تخطط لتشغيل حركة مرور آلية، منتج متعدد المستخدمين، إعادة بيع وصول API أو عمليات عرض مجمعة طوال اليوم، تحتاج إلى خطة الأعمال: خادم GPU مخصص، مع جهازك الخاص وبدون قائمة انتظار مشتركة. التسعير، ما هو متضمن ونموذج الطلب على business.graydient.ai.
التسعير لكل عرض لخادم مخصص، الفيديو مشمول، مذكور في business.graydient.ai. هذا السعر لكل عرض ينطبق فقط على خطة الأعمال. الصور، Video Plus و Video Max تبقى بخطط ذات سعر ثابت بدون رسوم لكل عرض.
لا يُسمح بحركة المرور الآلية على الخطط الشخصية. الصور، Video Plus و Video Max هي خطط بسعر ثابت لمستخدم بشري واحد، ويتم إلغاء المفاتيح التي ترسل حركة مرور آلية.
البدء
- اشترك في Video Max. يمكنك تغيير أو إلغاء خطتك في أي وقت في بوابة الفواتير.
- أنشئ رمزاً في صفحة رموز API الخاصة بك.
- اقرأ توثيق API وابحث على GitHub عن أمثلة استخدام API Graydient.
- أعد إعداد نقطة نهاية webhook، ثم أرسل طلب التصيير الأول.
- قم بعكس وصنع صورة مصغرة للنتائج قبل تقديمها لمستخدميك، كما توصي الوثائق.
الدعم متاح عبر البريد الإلكتروني على info@graydient.ai. كل الاستخدام يخضع لـ سياسة الاستخدام المقبول و شروط الاستخدام.