Social Studio API | Fit It On Entwicklerdokumentation

Wenden Sie hochstilisierte kreative Effekte und Vorlagen auf Modebilder für soziale Medien an.

Der Social Studio Endpunkt wendet hochstilisierte, kreative ästhetische Vorlagen auf Ihre Modebilder an und verwandelt sie in auffällige Inhalte, die perfekt für Social-Media-Marketing geeignet sind.

Modellname: social-studio

Lebenszyklus: stable

Verarbeitungszeit: ~15s–30s

Ausgabeformat: Auto (JPEG oder PNG)

Liefermethoden: URL

Credits: 2 bis 5 pro Generierung (abhängig von der Qualität)

Anfrage

Senden Sie Ihr Bild und die ausgewählte Stil-ID an den universellen /v1/run Endpunkt:

POSThttps://fititon.app/api/v1/run

Anfragebeispiele

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "social-studio",
           "inputs": {
             "personImage": "https://example.com/model-shot.jpg",
             "styleId": "action-figure",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

Antwort

Da die Bilderzeugung bis zu 30 Sekunden dauern kann, gibt der /v1/run Endpunkt sofort einen 201 Created Status mit einer asynchronen Job-id zurück. Sie müssen die Status-API mit dieser id abfragen, um das endgültige Bild abzurufen. Alternativ können Sie Webhooks konfigurieren, um Benachrichtigungen automatisch zu erhalten. Bitte beachten Sie, dass unser Webhook-Dispatcher ein striktes 15-Sekunden-Timeout erzwingt. Ihr Server muss den Webhook innerhalb von 15 Sekunden mit einem 2xx Statuscode bestätigen, andernfalls wird er als fehlgeschlagen betrachtet und später erneut versucht.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "social-studio"
}

Wenn der Job abgeschlossen ist (status: "success"), enthält das output-Feld ein Array der resultierenden URLs:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/social-studio-123-0.png"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

Anfrageparameter

Erforderliche Parameter

personImageRequiredstring

Das Quellbild, das stilisiert werden soll. Kann eine öffentlich zugängliche URL oder ein Base64-kodierter Bildstring sein.

Profi-Tipp: Ganzkörperfotos, auf denen die ganze Person sichtbar ist, liefern die besten stilisierten Ergebnisse. Eine klare Sichtbarkeit des Gesichts ist wichtig – die KI verwendet Gesichtsmerkmale, um Ihre stilisierte Version zu erstellen. Vermeiden Sie Gruppenfotos oder Bilder, auf denen Sie teilweise hinter Objekten versteckt sind.

Formatierungsanforderung Beim Übermitteln eines Base64-Strings muss dieser das Standard-Daten-URI-Präfix enthalten (z.B. data:image/jpeg;base64,...). Obwohl personImage Base64-Strings akzeptiert, empfehlen wir dringend, Standard-HTTP-URLs für Bilder zu verwenden, die größer als 3 MB sind, um zu vermeiden, dass globale JSON-Payload-Größenbeschränkungen (HTTP 413) bei Ihrer Anfrage erreicht werden.

styleIdRequiredstring

Die ID des fotografischen Stils, der auf das generierte Bild angewendet werden soll. Dies bestimmt Beleuchtung, Ästhetik und Stimmung.

Verfügbare Stile:

Style Name	Style ID (`styleId`)

Optionale Parameter

quality'1k' | '2k' | '4k'

Ausgabeauflösungsstufe. Standard: 1k

sampleCountinteger

Anzahl der zu generierenden Bildvariationen pro Anfrage. Muss zwischen 1 und 4 liegen. Standard: 1

ratiostring

Überschreibung des Seitenverhältnisses. Wenn leer, verwendet das System standardmäßig 1:1 (ideal für Instagram/Social Feeds).

Unterstützte Werte: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

Laufzeitfehler

Laufzeitfehler für diese Funktion verwenden den gemeinsamen Satz, der unter Fehlerbehandlung dokumentiert ist. Tritt während der Verarbeitung ein Fehler auf, wird der status auf "error" aktualisiert und das error-Feld enthält den spezifischen Fehlergrund.

Credit-Kosten

Für Developer API-Anfragen hängen die Kosten von der gewählten quality-Stufe multipliziert mit dem sampleCount ab.

Formel: Kosten = QualityCredits × sampleCount

Qualitätsstufe	Credits pro Bild
1k (Standard)	2
2k	3
4k	5