Bildkompressions-API-Tutorial

MiniPic bietet eine Bildkompressions-API, die mit der HTTP-Basic-/Bearer-Authentifizierung und der Antwortstruktur gängiger Komprimierungsdienste kompatibel ist, sodass du in den meisten Fällen von TinyPNG und ähnlichen Diensten allein durch den Austausch von API-Endpunkt und -Schlüssel migrieren kannst. Unsere selbst entwickelte Engine verkleinert PNG, JPEG und WebP im Schnitt um 60 % ohne sichtbaren Qualitätsverlust, es gibt ein kostenloses Monatskontingent, und dir werden nur erfolgreiche Komprimierungen berechnet. Die vollständige Endpunktreferenz findest du in der Entwicklerdoku (minipic.ai/docs).

Warum die MiniPic-Bildkompressions-API wählen

Kompatibel mit gängigen Komprimierungs-APIs: gleiche Authentifizierung und Antwortstruktur – in den meisten Fällen integrierst du durch Austausch von Endpunkt und Schlüssel.
Schnell, geringe Latenz: schnelle Uploads und Antworten, sodass Service-Aufrufe nicht hängen bleiben.
Kostenloses Monatskontingent: wird am ersten Tag jedes Monats zurückgesetzt – mehr als genug, um ein typisches Projekt zu starten.
Nur erfolgreiche Komprimierungen werden berechnet: Fehlschläge, zu große Dateien und blockierte Anfragen werden nie berechnet.

In 3 Schritten integrieren

Schritt 1: einen API-Schlüssel in der Konsole erstellen

Melde dich in der MiniPic-Konsole an und gehe zu API-Schlüsselverwaltung, um einen Schlüssel zu erstellen. Schlüssel haben das Präfix mp_live_ (Produktion) / mp_test_ (Sandbox); der vollständige Schlüssel wird nur einmal bei der Erstellung angezeigt, also bewahre ihn sicher auf.

Schritt 2: deine erste Komprimierungsanfrage senden

Nutze HTTP-Basic-Authentifizierung (Benutzername ist immer api, Passwort ist dein Schlüssel), um ein Bild zu komprimieren:

# Ein PNG komprimieren (Basic-Auth, Benutzer ist immer api) curl -s --user api:DEIN_API_SCHLÜSSEL \ --data-binary @input.png \ -o output.png \ https://api.minipic.ai/v1/compress

Schritt 3: das Ergebnis abrufen und herunterladen

Der Kompatibilitäts-Endpunkt /shrink gibt 201 Created zurück, wobei das Ergebnis über einen verschlüsselten privaten Link bereitgestellt wird, auf den nur du (der Schlüsselinhaber) zugreifen kannst; der native Endpunkt /v1/compress gibt die komprimierte Binärdatei direkt zurück. Das erneute Herunterladen desselben Ergebnisses wird nicht berechnet.

Node.js-Beispiel

// Node.js (>=18, eingebautes fetch): ein lokales Bild lesen und komprimieren import { readFile, writeFile } from "node:fs/promises"; const key = process.env.MINIPIC_API_KEY; const auth = "Basic " + Buffer.from("api:" + key).toString("base64"); const res = await fetch("https://api.minipic.ai/v1/compress?quality=smart&format=keep", { method: "POST", headers: { Authorization: auth }, body: await readFile("input.png"), }); await writeFile("output.png", Buffer.from(await res.arrayBuffer())); console.log("Komprimiert, gespart", res.headers.get("X-Ratio"));

Python-Beispiel

# Python (requests): ein lokales Bild lesen und komprimieren import os, requests key = os.environ["MINIPIC_API_KEY"] with open("input.jpg", "rb") as f: res = requests.post( "https://api.minipic.ai/v1/compress", params={"quality": "smart", "format": "keep"}, auth=("api", key), data=f.read(), ) with open("output.jpg", "wb") as out: out.write(res.content) print("Komprimiert, gespart", res.headers.get("X-Ratio"))

Von der TinyPNG-API migrieren

MiniPic ist mit der Authentifizierung und Antwortstruktur gängiger Komprimierungsdienste kompatibel, sodass du in den meisten Fällen von TinyPNG und ähnlichen Diensten allein durch den Austausch von API-Endpunkt und -Schlüssel migrieren kannst, ohne Änderungen an deinem Anwendungscode. Richte die Basis-URL auf MiniPic (minipic.ai), trage deinen MiniPic-API-Schlüssel ein und starte das Komprimieren.

Kontingent, Ratenbegrenzung und Abrechnung

Kostenkontingent: eine feste Anzahl Anfragen pro Monat, zurückgesetzt am ersten Tag jedes Monats.
Gestaffelte Preise: der Preis pro Bild sinkt, je größer dein monatliches Volumen wird.
Abrechnung: dir werden nur erfolgreiche Komprimierungen berechnet; Fehlschläge, zu große Dateien und blockierte Anfragen werden nie berechnet.
Ratenbegrenzung: 10 Anf./s pro Schlüssel, Burst 20; bei Überschreitung gibt es 429 + Retry-After.

Die vollständige Endpunktreferenz und die Fehlercode-Tabelle findest du in der Entwicklerdoku; die Preisstufen findest du auf der Preisseite; Abrechnungsdetails findest du unter Abrechnung.

Häufig gestellte Fragen

Wie integriere ich die MiniPic-Bildkompressions-API?

Erstelle einen API-Schlüssel in der MiniPic-Konsole und sende dann deine Anfrage an den Komprimierungs-Endpunkt mittels HTTP-Basic-Authentifizierung (Benutzername api, Passwort dein Schlüssel) oder einem Bearer-Token. Die API ist mit der Authentifizierung und Antwortstruktur gängiger Komprimierungsdienste kompatibel, sodass du in den meisten Fällen nur Endpunkt und Schlüssel austauschen musst.

Ist die MiniPic-Bildkompressions-API kostenlos?

Es gibt ein kostenloses Monatskontingent, das am ersten Tag jedes Monats zurückgesetzt wird. Darüber hinaus wird die Nutzung pro erfolgreich komprimiertem Bild zu gestaffelten Preisen abgerechnet. Dir werden nur erfolgreiche Komprimierungen berechnet – Fehlschläge, zu große Dateien und blockierte Anfragen werden nie berechnet.

Kann ich von der TinyPNG-API zu MiniPic migrieren?

Ja. Der MiniPic-Endpunkt /shrink ist mit der Authentifizierung und Antwortstruktur gängiger Komprimierungsdienste kompatibel, sodass du in den meisten Fällen durch Wechsel von API-Endpunkt und -Schlüssel migrieren kannst, ohne Änderungen an deinem Anwendungscode.

In 3 Schritten integrieren, mit kostenlosem Monatskontingent

Erstelle einen API-Schlüssel, dann tausche Endpunkt und Schlüssel aus, um mit dem Komprimieren zu beginnen.

API-Schlüssel erstellen, kostenlos starten →Vollständige API-Doku ansehen API-Preise ansehen