Portrait-Stilisierer API
PixMiller REST API · v1
Senden Sie ein Portrait und einen Stil; die KI gestaltet es in Anime, Ölgemälde, 3D und mehr um und gibt ein stilisiertes Bild zurück.
Dieser Endpunkt ist in der Vorschau — die Route und Parameter werden finalisiert und können sich vor dem Start ändern. Konventionen (X-Api-Key-Auth, JSON-Antwort) entsprechen der Live-Hintergrundentfernungs-API.
POST
https://api.pixmiller.com/v1/portrait-style
1
Authentifizierung & Anfrage
Senden Sie Ihren geheimen Schlüssel im
X-Api-Key: YOUR_API_KEY Anfrage-Header. Erstellen und verwalten Sie Schlüssel auf Ihrer Kontoseite.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
image_file
|
file | erforderlich | Portraitfoto — deutlich erkennbares Gesicht empfohlen |
style
|
string | erforderlich | Stil-Voreinstellungs-ID (vollständige Liste über GET /v1/styles) |
prompt
|
string | optional | Benutzerdefinierte Stilbeschreibung, überschreibt die Stil-Voreinstellung |
2
Code-Beispiele
Wählen Sie eine Sprache und kopieren Sie — funktioniert sofort.1curl -X POST "https://api.pixmiller.com/v1/portrait-style" \2 -H "X-Api-Key: YOUR_API_KEY" \3 -F "[email protected]" \4 -F "style=anime"
1import requests23resp = requests.post(4 "https://api.pixmiller.com/v1/portrait-style",5 headers={"X-Api-Key": "YOUR_API_KEY"},6 files={"image_file": open("portrait.jpg", "rb")},7 data={"style": "anime"},8)9print(resp.json()["url"])
1import fs from "node:fs";23const form = new FormData();4form.append("image_file", new Blob([fs.readFileSync("portrait.jpg")]), "portrait.jpg");5form.append("style", "anime");6const resp = await fetch("https://api.pixmiller.com/v1/portrait-style", {7 method: "POST",8 headers: { "X-Api-Key": "YOUR_API_KEY" },9 body: form,10});11console.log((await resp.json()).url);
3
Antwort
1{2 "url": "https://cdn.pixmiller.com/result/8Kd2pQ.png"3}
url
Temporäre URL des verarbeiteten Bildes (das zugrunde liegende Bild wird nach 3 Tagen automatisch gelöscht).
4
Fehler
Fehler geben den passenden Statuscode und einen JSON-Body zurück in der Form {"errors":{"code":"…","message":"…"}}.
400
validation error
Fehlende oder ungültige image_file, Datei zu groß, oder widersprüchliche Bildquellen.
401
authentication_failed
Der X-Api-Key-Header fehlt oder ist ungültig.
402
not_enough_credit
size=full wurde angefordert, aber das Konto hat keine HD-Credits mehr.
422
invalid_image
Das Bild konnte nicht verarbeitet werden — zu klein, nicht unterstützt, oder Dekodierung fehlgeschlagen.
429
throttled
Ratenlimit überschritten. Verlangsamen und nach dem Retry-After-Header erneut versuchen.