API

Eine Anfrage. Ein fertiges Inserat.

Sie senden ein Foto und einen Hintergrund — und erhalten das bearbeitete Foto. Ihre eigenen Felder, etwa die Inserats-ID, kommen mit zurück.

Sie müssen sich damit nicht selbst befassen. Sie haben eigene Entwickler? Dann können diese alles anhand dieser Seite anbinden. Keine Entwickler? Dann übernehmen wir die Anbindung: Geben Sie uns Zugang zu Ihrer Website oder Ihrem CRM — wir erledigen den Rest und zeigen Ihnen das Ergebnis an Ihren eigenen Fotos.

Flexible SteuerungHintergrund, Kennzeichen und Autogröße — für jeden Batch
10.000Fotos pro Batch, Volumen auf Anfrage
Nichts neu gezeichnetdie Karosserie bleibt wie fotografiert
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);
}
Die Antwort kommt meist direkt auf dieselbe Anfrage zurück. Dauert die Bearbeitung länger, erhalten Sie 202 und das Ergebnis per Abfrage oder Webhook. Für Batches nutzen Sie /v1/batches.SDKs für Python und Node: Batches, Abfragen und Webhooks in einem Client. Vorerst übergeben wir sie bei der Anbindung; PyPI und npm folgen in Kürze.
// was zurückkommt
{
  "ok": true,
  "frame": {
    "id": "frm_6f1d0c9a2b8e4f7a9c3d5e1b0a2f4c6d",
    "status": "done",
    "image_url": "https://…/IMG_4412.png?X-Amz-Expires=600&…",
    "charged": true,
    "metadata": { "listing": "A-4412" }
  }
}

Fünf Methoden

POST/v1/framesEin Foto → bearbeitetes Foto. Meist in derselben Anfrage.
POST/v1/batchesBis zu 10.000 Fotos in einem Auftrag, Volumen auf Anfrage. Nach Abschluss meldet sich ein Webhook.
GET/v1/frames/{id}Status eines Fotos und der Link zur fertigen Datei.
GET/v1/backgroundsDie Hintergrundbibliothek. Ihren eigenen Hintergrund senden Sie als Datei mit der Bearbeitungsanfrage.
POST/v1/webhooksEreignisse abonnieren: Batch fertig, Foto fertig.

In Kürze: eigene Szenen in der Hintergrundbibliothek.

Anbindung

Drei Wege zum Start — mit Entwicklern oder ohne

Drei Wege zum Start. Wählen Sie den passenden — bei jedem sind die ersten 30 Fotos gratis.

Arbeiten Sie mit einem KI-Agenten? ChatGPT, Claude Code, Cursor und andere MCP-Clients verbinden sich über MCP mit derselben API. So verbinden Sie einen KI-Agenten

01 · ohne Entwickler

Wir binden an

Sie senden eine Anfrage, wir rufen Sie an, Sie geben uns Zugang zu Ihrer Website oder Ihrem CRM, und wir richten den Export selbst ein. Sie prüfen nur das Ergebnis und sagen uns, welcher Hintergrund Ihnen gefällt.

Wir richten es ein
02 · ohne Entwickler

Nur der Kundenbereich

Keine Anbindung nötig: Ordner mit Fotos hochladen, Hintergrund wählen, fertige Fotos herunterladen. Läuft direkt im Browser — jeder in Ihrem Team kommt damit zurecht.

Ohne Integration
03 · mit eigenen Entwicklern

API und Schlüssel

Eine POST-Anfrage, drei Parameter, die Antwort meist in derselben Verbindung. SDKs für Python und Node. Den Sandbox-Schlüssel (kostenlos, Ergebnisse mit Wasserzeichen) erhalten Sie nach Ihrer Anfrage und der Bestätigung Ihrer E-Mail-Adresse.

Anhand dieser Seite
Die Antwort

Nicht nur ein Bild. Auch Daten.

Zusammen mit dem Foto liefern wir seinen Status und, wenn es nicht bearbeitet werden konnte, den Grund; ein solches Foto wird nicht berechnet. Ihre eigenen Felder aus metadata, etwa Inserats-ID oder FIN, kommen in der Antwort und im Webhook zurück.

So funktioniert die Bearbeitung →
{
  "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" }
  }
}