الواجهة البرمجية، بأسعار مكتوبة
كل منافس في هذه الفئة يخفي سعر واجهته خلف مكالمة مبيعات. هذا سعرنا، ومعه نقطة نهاية الدفعات التي لا يملكها أي منهم.
تُصدَر مفاتيح الواجهة في باقات Pro وStudio وAgency.
المصادقة
رمز Bearer لكل مفتاح. تُعرض المفاتيح مرة واحدة عند الإنشاء، وتُخزَّن كبصمة تجزئة فقط، ويمكن إبطالها من حسابك.
POST https://api.miradora.ai/v1/generate
Authorization: Bearer mk_live_…
Content-Type: application/json
{
"kind": "redesign",
"image_url": "https://…",
"style": "japandi",
"room_type": "living-room",
"structure_lock": true,
"creativity": 40,
"variations": 4,
"resolution": "2k",
"idempotency_key": "5f0c1c0e-2c1a-4f5e-9c3a-0d1b2e3f4a5b",
"webhook_url": "https://…"
}
202 Accepted
{ "job_id": "…", "credits_charged": 4, "eta_seconds": 18 }نقاط النهاية
| HTTP | نقاط النهاية | ما معناه |
|---|---|---|
| POST | /v1/generate | Enqueue a generation. Returns 202 with a job id, the credits charged and an ETA. |
| POST | /v1/batch | Enqueue many generations in one call. One idempotency key per item. |
| GET | /v1/jobs/{id} | Poll a job: status, progress, honest queue position and ETA. |
| POST | /v1/jobs/{id}/cancel | Cancel a job. Always a full credit refund. |
| GET | /v1/generations/{id} | The finished render, with the model, seed and prompt that produced it. |
| GET | /v1/generations/{id}/items | Detected objects in a render, for Shop the Look. |
| POST | /v1/segment | Point, box or text prompt to a mask. Costs 0 credits. |
| GET | /v1/catalog | Styles, room types and materials. Heavily cached. |
| GET | /v1/credits | Current balance, and the ledger behind it. |
حدود المعدّل
لكل مفتاح، محسوبة على دقيقة متحركة. تجاوزها يعيد 429 مع retry-after.
| الباقة | طلبات / دقيقة | عناصر لكل دفعة |
|---|---|---|
| Pro | 60 | 25 |
| Studio | 150 | 100 |
| Agency | 600 | 250 |
تكلفة الاستدعاء
تستهلك استدعاءات الواجهة الأرصدة نفسها التي يستهلكها التطبيق، من الرصيد نفسه، وبالتكاليف المنشورة نفسها. لا توجد قائمة أسعار منفصلة للواجهة.
لا يكلّف شيئًا أبدًا
- محادثة مستشار التصميم٠
- نقد التصميم٠
- التصفح والاستكشاف٠
- معاينة النمط٠
- البحث عن المنتجات٠
- إعادة تنزيل ما أنشأته سابقًا٠
- رفع صورة ووسمها٠
- لمس عنصر لتحديده٠
- تصفّح دليل الأنماط والغرف٠
التصفح، ومحادثة التصميم، والنقد المكتوب، ومعاينات الأنماط، والبحث عن المنتجات، وإعادة تنزيل ما أنشأته سابقًا — كلها مجانية إلى الأبد. أدرجناها هنا كي يكون الوعد قابلًا للتحقق.
العمليات المحتسَبة
| العملية | الأرصدة | لكل نسخة؟ |
|---|---|---|
| إخراج متعدد الزوايا — لكل زاوية إضافية | 1 | نعم — 4 نسخ تكلّف 4× |
| إعادة تصميم | 1 | نعم — 4 نسخ تكلّف 4× |
| إفراغ الغرفة | 1 | لا — نتيجة واحدة مهما كان |
| الألوان والملامس | 1 | نعم — 4 نسخ تكلّف 4× |
| التعديل باللمس — عنصر واحد | 1 | لا — نتيجة واحدة مهما كان |
| السماء والطقس | 1 | نعم — 4 نسخ تكلّف 4× |
| تأثيث افتراضي | 1 | نعم — 4 نسخ تكلّف 4× |
| تبديل الأرضيات والخامات | 1 | نعم — 4 نسخ تكلّف 4× |
| تصميم خارجي | 1 | نعم — 4 نسخ تكلّف 4× |
| تكبير وتحسين | 1 | لا — نتيجة واحدة مهما كان |
| تنسيق حدائق | 1 | نعم — 4 نسخ تكلّف 4× |
| تنظيف — إزالة عنصر واحد | 1 | لا — نتيجة واحدة مهما كان |
| مؤلّف الغرفة | 1 | نعم — 4 نسخ تكلّف 4× |
| معاينة الطلاء | 1 | نعم — 4 نسخ تكلّف 4× |
| من رسم تخطيطي إلى صورة | 1 | نعم — 4 نسخ تكلّف 4× |
| من نص إلى تصميم | 1 | نعم — 4 نسخ تكلّف 4× |
| مولّد أثاث | 1 | نعم — 4 نسخ تكلّف 4× |
| نقل النمط | 1 | نعم — 4 نسخ تكلّف 4× |
| إعادة تصميم ذكية — لغة طبيعية وصور مرجعية | 2 | نعم — 4 نسخ تكلّف 4× |
| المؤلّف الذكي — رتّب أثاثك أنت | 2 | نعم — 4 نسخ تكلّف 4× |
| مخطط ثنائي → ثلاثي الأبعاد | 2 | لا — نتيجة واحدة مهما كان |
| صورة → مجسّم ثلاثي الأبعاد للواقع المعزز | 3 | لا — نتيجة واحدة مهما كان |
| فيديو جولة | 3 | لا — نتيجة واحدة مهما كان |
| رسم إضافي لإخراج 4K | +1 | لا — نتيجة واحدة مهما كان |
تضاعف النسخُ تكلفةَ الأوضاع الموسومة بـ«لكل نسخة». أربع نسخ من إعادة التصميم تكلّف أربعة أرصدة، ويظهر المجموع الدقيق قبل الضغط على «توليد».
إخراج 4K يضيف رصيدًا واحدًا. نولّد النسخ بدقة 1K ونكبّر ما تختاره فقط: توليد أربع نسخ أصلًا بدقة 4K يكلّفنا ٢٫٢ ضعفًا مقابل ثلاث صور كنت ستتجاهلها.
الأخطاء
| الرمز | HTTP | ما معناه |
|---|---|---|
| insufficient_credits | 402 | You need {required} credits. You have {available}. |
| image_too_small | 400 | This photo is {width}×{height}. We need at least {min}px on the short side — try retaking it, or pick the full-size original rather than a screenshot. |
| unsupported_format | 400 | We can’t read {format} images. JPEG, PNG, HEIC and WebP all work. |
| room_not_found | 404 | That room no longer exists. |
| idempotency_key_required | 400 | Something went wrong on our side. Please try again. |
| content_policy | 422 | We couldn’t render this one: {policy}. If that looks wrong to you, appeal and a human will look. |
| rate_limited | 429 | Slow down a moment — try again in {retry_after}s. |
| vendor_unavailable | 503 | Our image service is having a moment. Your credits are safe — we’ve refunded this render. |
| job_timeout | 504 | This render took too long, so we stopped it and refunded your credits. |
الويب هوك
التوليد غير متزامن. زوّدنا بـ webhook_url ونرسل الحالة النهائية إليه عبر POST موقّعًا. أو استعلم عن نقطة نهاية المهام إن لم ترغب بتشغيل مستقبِل.
لمن تعود المخرجات
لك. ما يُولَّد عبر مفتاحك يُنسب إليك، للاستخدام التجاري، من باقة Pro فأعلى. ولا ندرّب على أي شيء يُرسل إلى الواجهة.