REST · HTTP

BlocCut API

Server in Deutschland

Entferne Bild-Hintergründe per HTTP. Auth über deinen API-Key, Abrechnung über das zentrale Bloc-Apps-Guthaben (2 ct / Bild). Verarbeitung in Deutschland, in-memory, keine Speicherung.

Endpoint

POSThttps://cut.bloc-apps.com/api/v1/remove

Authentifizierung

Erstelle hier einen API-Key (verwalten kannst du ihn im Dashboard) und sende ihn als Bearer-Token:

Authorization: Bearer blk_live_…

KI-Anbindung (MCP)

BlocCut lässt sich auch als KI-Werkzeug nutzen (Claude & Co.). Die Einrichtung machst du zentral im Dashboard unter „API & KI".

Request

Body: rohe Bild-Bytes (PNG, JPG, WebP), max. 15 MB
Content-Type: image/png | image/jpeg | image/webp
Idempotency-Key (optional, empfohlen): verhindert Doppelabbuchung bei Retries

Response

200: image/png mit transparentem Hintergrund
X-Bloc-Charged-Cents / X-Bloc-Balance-Cents im Header
401 ungültiger Key · 402 Guthaben leer · 413 zu groß

Beispiel — cURL

bash

curl -X POST https://cut.bloc-apps.com/api/v1/remove \
  -H "Authorization: Bearer blk_live_DEIN_KEY" \
  -H "Content-Type: image/png" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data-binary "@portrait.png" \
  --output ohne-hintergrund.png

Beispiel — JavaScript

const res = await fetch("https://cut.bloc-apps.com/api/v1/remove", {
  method: "POST",
  headers: {
    Authorization: "Bearer blk_live_DEIN_KEY",
    "Content-Type": file.type,
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: file, // Blob / Buffer mit Bild-Bytes
});

if (res.status === 402) throw new Error("Guthaben aufgebraucht");
const pngBlob = await res.blob(); // transparentes PNG

Datenschutz

Bilder werden ausschließlich im Arbeitsspeicher verarbeitet und sofort verworfen. Keine Speicherung, kein Training. AVV für B2B verfügbar.

API-Key erstellen