API رندر AI Graydient
اگر برنامه، ابزار داخلی یا خط لوله رندر می‌سازید، Graydient مدل‌های باز تصویر، ویدیو و LLM را روی GPUهای اختصاصی، پشت یک API و با قیمت ماهانه ثابت به شما می‌دهد.
کدام طرح شامل آن است
API شخصی فقط با Video Max ارائه می‌شود. تصاویر و Video Plus شامل دسترسی API نیستند. می‌توانید هر زمان در پرتال صورتحساب ارتقا، کاهش یا لغو کنید، با هزینه‌های متناسب. قیمت طرح تجاری و API در business.graydient.ai است.
API شخصی کلیدی برای یک کاربر انسانی است و ترافیک خودکار در هیچ طرح شخصی مجاز نیست. یعنی هیچ ربات، اسکریپت، زمان‌بندی، کار دسته‌ای، خزنده، برنامه چندکاربره یا دسترسی فروشی مجاز نیست. محدود به نرخ است: حدود یک تماس هر ۱۰ ثانیه. کلیدهایی که ترافیک خودکار یا بیش از حد ارسال کنند بدون اطلاع لغو می‌شوند.
ساخت محصول چندکاربره یا برند سفید
کاربران مجازی و ورود برند سفید ویژگی‌های سطح کسب‌وکار برای برنامه‌های مستقر با کاربران زیاد هستند. این‌ها روی 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 /api/v3/render/ با یک پرامپت و callback_url الزامی POST می‌کنید. Graydient بلافاصله با render_hash به همراه زمان‌های تخمینی انتظار و رندر پاسخ می‌دهد. وقتی کار تمام شد، نتایج را به وبهوک شما POST می‌کند. فیلدهای اختیاری شامل:
- error_url: وبهوکی برای خطاها
- init_image و mask_image: برای تصویر به تصویر و نقاشی درون‌تصویری
- placeholders: URLهای تصویر نام‌گذاری شده برای حالت‌های ControlNet یا IP adapters
- progressive_return: یک callback برای هر تصویر
- session_id: مرتبط کردن رندرها با کاربران خودتان
جریان‌های کاری از همان نقطه پایانی با دستور workflow در پرامپت اجرا می‌شوند.
وضعیت بدون نظرسنجی: GET GET /api/v3/render/{render_hash} وضعیت رندر را برمی‌گرداند، اما مستندات توصیه می‌کنند آن را نظرسنجی نکنید. از وبهوک استفاده کنید، یا جریان WebSocket در wss://cloud.graydient.ai/render-events/{render_hash} که رویدادهای started، image_done، done و error را ارسال می‌کند.
خانواده‌های دیگر نقطه پایانی
- چت: چت LLM با یک شخصیت. پاسخ‌ها به callback می‌روند یا با sync: true به صورت درون‌خطی بازمی‌گردند، و مدل‌های بینایی یک image_url می‌پذیرند.
- مفاهیم: فهرست مدل‌ها و LoRAهای موجود.
- جریان‌های کاری: فهرست جریان‌های کاری و آنچه هر کدام پشتیبانی می‌کنند، مانند txt2img، img2img، txt2vid و img2vid.
- پایگاه دانش: ایجاد دامنه، افزودن حقایق، خزیدن URLها، سپس جستجو یا چت.
- مهارت‌ها: تبدیل درخواست‌های زبان طبیعی به دستورات جریان کاری.
- کاربران مجازی: نگاشت کاربران نهایی شما به رکوردهای حساب شما. ساخت و تست با آن در API شخصی، سپس راه‌اندازی زنده در استقرار تجاری.
مرجع کامل: مستندات API. مستندات می‌گویند هنوز در حال توسعه هستند.
موارد استفاده معمول
- قدرت دادن به اپ خودتان: استفاده از Graydient به عنوان بک‌اند رندر برای ویژگی تصویر، ویدیو یا چت. توسعه روی API شخصی، سپس انتقال به استقرار تجاری وقتی کاربران واقعی آمدند.
- استفاده از مدل‌های میزبانی شده خودتان: رندر با LoRAها و checkpoints نصب شده خودتان. ببینید مدل‌های هوش مصنوعی خود را میزبانی کنید.
- اجرای جریان‌های کاری سبک 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 را ببینید.
- یک نقطه پایانی وبهوک راه‌اندازی کنید، سپس اولین درخواست رندر خود را ارسال کنید.
- تصاویر نتیجه را قبل از ارائه به کاربران خود، آینه و بندانگشتی کنید، همانطور که مستندات توصیه می‌کنند.
پشتیبانی API از طریق ایمیل در info@graydient.ai در دسترس است. تمام استفاده‌ها تابع سیاست استفاده قابل قبول و شرایط استفاده است.