یک جملهٔ انگلیسی بفرست — یک تصویر PNG بگیر.
جمله را بنویس؛ کد زیر همان لحظه عوض میشود.
پاسخ موفق بدنهٔ PNG است (نه JSON) — مستقیم در فایل ذخیره کن. رندر حدود ۲۰ تا ۶۰ ثانیه طول می‌کشد؛ اگر GPU شلوغ باشد 503 با Retry-After می‌گیری.
| فیلد | الزام | توضیح |
|---|---|---|
prompt | الزامی (JSON) | جملهٔ انگلیسی، ۱ تا ۲۰۰۰ حرف |
seed | اختیاری (JSON) | عدد ۰ تا ۹۹۹۹۹۹ — نفرستی هر بار تصادفی میشود (تکرار همان جمله = تصویر تازه)؛ بفرستی همان seed همیشه همان تصویر را می‌دهد (سربرگ X-Seed در پاسخ) |
| چی | چقدر |
|---|---|
| طول جمله | ۲۰۰۰ حرف — بیشتر → 413 |
| تعداد تصویر روزانهٔ هر کلید | ۳۰ — ریست با UTC، بعدش 429 + Retry-After |
| سرعت هر کلید | ۲ تصویر در دقیقه |
| تعداد تصویر در هر درخواست | فقط یک تصویر |
| کد | detail | معنی / راه‌حل |
|---|---|---|
| 401 | key_required | کلید نفرستادی — Bearer + کلید |
| 401 | bad_key / revoked_key | کلید نامعتبر یا باطل — کلید تازه بساز |
| 401 | bad_auth_scheme | قالب سربرگ درست نیست (باید Bearer <key> باشد) |
| 403 | key_owner_mismatch | این کلید به حساب دیگری تعلق دارد — با کلید حساب خودت ادامه بده (کلاینت‌های بدون نشست مرورگر تحت تأثیر نیستند) |
| 413 | prompt_too_long | جمله بیش از ۲۰۰۰ حرف — کوتاه کن |
| 422 | prompt_required / invalid_body | جمله نفرستادی یا بدنه JSON نیست |
| 422 | bad_seed | seed باید عدد صحیح ۰ تا ۹۹۹۹۹۹ باشد |
| 429 | img_key_burst / img_key_daily | سقف سرعت یا سهمیهٔ روزانه — Retry-After را بخوان |
| 429 | almas_empty | موجودی الماس حساب برای مدل هزینه‌دار صفر است — یا برای همین درخواست کافی نیست (X-Almas-Needed = قیمت لازم، X-Almas-Left = موجودی)؛ خرید بسته این موجودی را شارژ نمی‌کند؛ شارژ حساب از /upgrade#شارژ-حساب (۱۰۰٬۰۰۰ تومان → ۱۰۰٬۰۰۰ الماس · ۱٬۰۰۰٬۰۰۰ تومان → ۱٬۰۰۰٬۰۰۰ الماس) |
| 502 | img_unreachable / img_failed | موتور تصویر موقتاً در دسترس نیست — بعداً تلاش کن |
| 503 | (freeze / شلوغ) | GPU شلوغ است — Retry-After (حدود ۴۵ ثانیه صبر کن) |
برای ساخت تصویر دموی رایگان وجود ندارد — هر تصویر حدود ۴۵ ثانیه GPU را مشغول می‌کند، پس همهٔ درخواست‌ها کلید می‌خواهند. کلید را از تب «کلید API» بالای صفحه بگیر.