Sprache: DE
Kostenlos starten

Das Produktfoto-Studio als API.

Die Herofab-API nimmt ein Produktfoto und einen Tool-Namen entgegen und verarbeitet den Auftrag im Hintergrund; Statusabfragen oder ein signierter Webhook melden, sobald das fertige Bild zum Download bereitsteht.

  • Bearer-API-Schlüssel
  • Signierte Webhooks
  • Bis zu 100 Aufträge pro Batch
  • OpenAPI 3.1 und llms.txt

MCP https://app.herofab.app/mcpOpenAPI · GPT Actions https://app.herofab.app/api/agent/openapi.jsonMCP · API key https://app.herofab.app/mcp/studio

{
  "mcpServers": {
    "herofab-studio": {
      "type": "http",
      "url": "https://app.herofab.app/mcp/studio",
      "headers": {
        "Authorization": "Bearer hf_sk_live_..."
      }
    }
  }
}
curl https://app.herofab.app/api/v1/jobs -H "Authorization: Bearer $HEROFAB_API_KEY" -H "Idempotency-Key: $(uuidgen)" --json '{"tool": "ghost_mannequin", "inputs": {"garment": "ASSET_ID"}}'
So funktioniert es

Vom Foto zum fertigen Bild.

01

Senden

Produktfoto hochladen und einen Auftrag mit Tool und Einstellungen anlegen; der Auftrag reserviert seine Credits.

POST /api/v1/assetsPOST /api/v1/jobs

02

Abfragen

Den Auftrag abfragen, bis er abgeschlossen ist, oder beim Abschluss einen signierten Webhook empfangen.

GET /api/v1/jobs/{id}

03

Herunterladen

Das fertige Bild über die Asset-ID der Auftragsausgabe abrufen.

GET /api/v1/assets/{id}/content

Vollständiges Beispiel: Foto hochladen, Auftrag anlegen, warten, herunterladen
API=https://app.herofab.app/api/v1
AUTH="Authorization: Bearer $HEROFAB_API_KEY"

# 1 · Upload the product photo
ASSET_ID=$(curl -s "$API/assets" \
  -H "$AUTH" \
  -F file=@shirt.jpg | jq -r .id)

# 2 · Create the job
BODY=$(jq -n --arg garment "$ASSET_ID" '{tool: "ghost_mannequin",
  inputs: {garment: $garment}, params: {style: "3d", backdrop: "white"}}')
JOB_ID=$(curl -s "$API/jobs" \
  -H "$AUTH" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "$BODY" | jq -r .id)

# 3 · Poll until the job is finished
while :; do
  JOB=$(curl -s "$API/jobs/$JOB_ID" -H "$AUTH")
  STATE=$(jq -r .state <<<"$JOB")
  [ "$STATE" = queued ] || [ "$STATE" = running ] || break
  sleep 2
done
[ "$STATE" = succeeded ] || { jq -r .failure.code <<<"$JOB"; exit 1; }

# 4 · Download the image
OUTPUT_ID=$(jq -r '.outputs[0].asset_id' <<<"$JOB")
EXT=$(jq -r '.outputs[0].content_type | ltrimstr("image/")' <<<"$JOB")
curl -sL "$API/assets/$OUTPUT_ID/content" -H "$AUTH" -o "result.$EXT"
Loslegen

Ihre nächste Kollektion, noch diese Woche fotografiert.

20 Credits bei der Registrierung, keine Kreditkarte erforderlich. Mit kostenlosen Credits erstellte Bilder tragen ein Wasserzeichen. Herofab entfernt das Wasserzeichen auch von diesen Bildern, sobald Credits gekauft werden.