API

طلب واحد. بطاقة جاهزة.

أرسلوا صورة وخلفية — تستلمون صورة معالجة. وحقولكم الخاصة، مثل معرّف الإعلان، تعود معها.

لا حاجة إلى أن تتدبروا الأمر بأنفسكم. لديكم مطوّرون؟ يمكنهم ربط كل شيء من هذه الصفحة. ليس لديكم مطوّرون؟ نتولى الربط عنكم: أرسلوا لنا صلاحية الوصول إلى موقعكم أو نظام إدارة علاقات العملاء (CRM)، ونتكفل بالباقي ونعرض عليكم النتيجة على صوركم أنتم.

تحكم مرنالخلفية ولوحة الأرقام وحجم السيارة — تُحدَّد لكل دفعة
10,000صورة في الدفعة، والأحجام الأكبر عند الطلب
دون إعادة رسميبقى الهيكل كما في الصورة
curl -X POST https://auto.happyin.app/v1/frames \
  -H "Authorization: Bearer $AUTO_API_KEY" \
  -F "image=@IMG_4412.jpg" \
  -F "background=white-showroom" \
  -F 'metadata={"listing":"A-4412"}'
from happyin_auto import Client

client = Client()             # key from AUTO_API_KEY
frame = client.process_frame(
    "IMG_4412.jpg",
    background="white-showroom",
    download_to="IMG_4412_showroom.png",
)
print(frame["status"])        # done, or failed + reason
import { writeFile } from "node:fs/promises";
import { Client } from "@happyin/auto";

const client = new Client();  // key from AUTO_API_KEY
const frame = await client.processFrame("IMG_4412.jpg", {
  background: "white-showroom",
});
if (frame.status === "done") {
  const png = await client.download(frame.image_url!);
  await writeFile("IMG_4412_showroom.png", png);
}
تصل الاستجابة عادةً ضمن الطلب نفسه. وإذا استغرقت المعالجة وقتًا أطول تستلمون الرمز 202 ثم النتيجة عبر الاستعلام الدوري أو webhook. وللدفعات استخدموا /v1/batches.مكتبات SDK لـ Python وNode: الدفعات والاستعلام الدوري وwebhooks في عميل واحد. حاليًا نسلّمها عند الربط معكم؛ وستتوفر قريبًا على PyPI وnpm.
// ما يعود إليكم
{
  "ok": true,
  "frame": {
    "id": "frm_6f1d0c9a2b8e4f7a9c3d5e1b0a2f4c6d",
    "status": "done",
    "image_url": "https://…/IMG_4412.png?X-Amz-Expires=600&…",
    "charged": true,
    "metadata": { "listing": "A-4412" }
  }
}

خمس طرق

POST/v1/framesصورة واحدة ← صورة معالجة. عادةً ضمن الطلب نفسه.
POST/v1/batchesحتى 10,000 صورة في مهمة واحدة، والأحجام الأكبر عند الطلب. ويُطلق webhook عند الانتهاء.
GET/v1/frames/{id}حالة الصورة ورابط الملف الجاهز.
GET/v1/backgroundsمكتبة الخلفيات. وتُرسل خلفيتكم الخاصة كملف مع طلب المعالجة.
POST/v1/webhooksالاشتراك في الأحداث: اكتمال الدفعة، اكتمال الصورة.

قريبًا: مشاهدكم الخاصة في مكتبة الخلفيات.

الربط

ثلاث طرق للبدء — مع مطوّرين أو بدونهم

ثلاث طرق للبدء. اختاروا ما يناسبكم — وأول 30 صورة مجانية في أي منها.

تعملون عبر وكيل ذكاء اصطناعي؟ يرتبط ChatGPT وClaude Code وCursor وعملاء MCP الآخرون بواجهة API نفسها عبر MCP. كيف تربطون وكيل ذكاء اصطناعي

01 · دون حاجة إلى مطوّرين

نحن نتولى الربط

اتركوا طلبًا، فنتصل بكم، ونأخذ صلاحية الوصول إلى موقعكم أو نظام إدارة علاقات العملاء (CRM)، ونُعدّ التصدير بأنفسنا. وما عليكم إلا مراجعة النتيجة وإخبارنا بالخلفية التي تعجبكم.

نحن نُعدّه
02 · دون حاجة إلى مطوّرين

لوحة التحكم فقط

لا شيء يلزم ربطه: ارفعوا مجلد صور، واختاروا خلفية، ونزّلوا الصور الجاهزة. تعمل مباشرة في المتصفح — ويستطيع أي شخص في فريقكم استخدامها.

دون تكامل
03 · لديكم مطوّرون

API ومفتاح

طلب POST واحد وثلاثة معاملات، والاستجابة عادةً ضمن الاتصال نفسه. مكتبات SDK لـ Python وNode. يصلكم مفتاح البيئة التجريبية (مجاني، والنتائج عليها علامة مائية) عبر البريد الإلكتروني بعد إرسال طلبكم وتأكيد عنوانكم.

من هذه الصفحة
الاستجابة

ليست مجرد صورة. بيانات أيضًا.

مع الصورة نعيد حالتها، وإذا تعذّرت معالجتها نعيد السبب؛ ولا تُحتسب مثل هذه الصورة. وحقولكم الخاصة من metadata، مثل معرّف الإعلان أو رقم الهيكل (VIN)، تعود في الاستجابة وفي webhook.

كيف تتم المعالجة ←
{
  "ok": true,
  "frame": {
    "id": "frm_6f1d0c9a2b8e4f7a9c3d5e1b0a2f4c6d",
    "idx": 0,
    "name": "IMG_4412.jpg",
    "status": "done",
    "outcome": "accepted",
    "reason": null,
    "step": null,
    "kind": "exterior",
    "options": null,
    "mode": "full_blend",
    "shot_kind": null,
    "effective_view": null,
    "view_level": null,
    "refits_left": null,
    "brand": null,
    "attempts": 1,
    "charged": true,
    "result": true,
    "redo_in_progress": false,
    "sent": true,
    "finished_at": "2026-10-14T09:12:41.000Z",
    "vehicle": {
      "status": "unconfirmed",
      "make": { "code": "skoda", "text": "Škoda", "source": "estimate", "confidence": 0.93 },
      "model": null,
      "body": { "code": "liftback", "source": "estimate", "confidence": 0.97 },
      "dimensions_mm": { "length": 4690, "width": 1830, "height": 1470, "source": "estimate", "typical_error_pct": 4 },
      "ref": null,
      "vin": null,
      "estimate": { "model_version": "carid-2026-10", "make": [["skoda", 0.93]], "body": [["liftback", 0.97]], "mismatch": [] },
      "confirmed_at": null
    },
    "batch_id": "bat_0b7e2d4c9a1f4e6b8d3c5a7f9e1b2d40",
    "image_url": "https://…/IMG_4412.png?X-Amz-Expires=600&…",
    "image_expires_at": "2026-10-14T09:22:41.000Z",
    "metadata": { "listing": "A-4412" }
  }
}