Social Studio API | Fit It On Ontwikkelaarsdocumentatie

Pas zeer gestileerde creatieve effecten en sjablonen toe op modeafbeeldingen voor sociale media.

Het Social Studio-eindpunt past zeer gestileerde, creatieve esthetische sjablonen toe op uw modeafbeeldingen, waardoor ze worden omgezet in opvallende inhoud die perfect geschikt is voor sociale mediamarketing.

Modelnaam: social-studio

Levenscyclus: stable

Verwerkingstijd: ~15s–30s

Uitvoerformaat: Auto (JPEG of PNG)

Leveringsmethoden: URL

Credits: 2 to 5 per generation (depends on quality)

Verzoek

Dien uw afbeelding en geselecteerde stijl-ID in bij het universele /v1/run-eindpunt:

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

Voorbeelden van verzoeken

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
           }
         }'

Antwoord

Omdat het genereren van afbeeldingen tot 30 seconden kan duren, retourneert het /v1/run-eindpunt onmiddellijk een 201 Created-status met een asynchrone taak-id. U moet de Status API met deze id bevragen om de uiteindelijke afbeelding op te halen. Als alternatief kunt u webhooks configureren om automatisch meldingen te ontvangen. Houd er rekening mee dat onze webhook-dispatcher een strikte time-out van 15 seconden hanteert. Uw server moet de webhook binnen 15 seconden bevestigen met een 2xx-statuscode, anders beschouwen we het als mislukt en proberen we het later opnieuw.

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

Wanneer de taak is voltooid (status: "success"), zal het output-veld een array van de resulterende URL's bevatten:

{
  "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"
}

Verzoekparameters

Vereiste parameters

personImageRequiredstring

De bronafbeelding om te stylen. Kan een openbaar toegankelijke URL zijn of een Base64-gecodeerde afbeeldingsreeks.

Pro Tip: Foto's van het hele lichaam waarop de hele persoon zichtbaar is, leveren de beste gestileerde resultaten op. Duidelijke gezichtsherkenning is belangrijk — de AI gebruikt gelaatstrekken om uw gestileerde versie te creëren. Vermijd groepsfoto's of afbeeldingen waarop u gedeeltelijk verborgen bent achter objecten.

Opmaakvereiste Bij het indienen van een Base64-reeks moet deze het standaard data URI-voorvoegsel bevatten (bijv. data:image/jpeg;base64,...). Hoewel personImage Base64-reeksen accepteert, raden we ten zeerste aan om standaard HTTP-URL's te gebruiken voor afbeeldingen groter dan 3MB om te voorkomen dat de wereldwijde JSON-payloadgroottebeperkingen (HTTP 413) voor uw verzoek worden overschreden.

styleIdRequiredstring

De fotografische stijl-ID die moet worden toegepast op de gegenereerde afbeelding. Dit bepaalt de belichting, esthetiek en sfeer.

Beschikbare stijlen:

Style Name	Style ID (`styleId`)

Optionele parameters

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

Uitvoerresolutieniveau. Standaard: 1k

sampleCountinteger

Aantal afbeeldingsvariaties dat per verzoek moet worden gegenereerd. Moet tussen 1 en 4 liggen. Standaard: 1

ratiostring

Overschrijving van de beeldverhouding. Indien leeg, stelt het systeem standaard in op 1:1 (ideaal voor Instagram/sociale feeds).

Ondersteunde waarden: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

Runtimefouten

Runtimefouten voor deze functie maken gebruik van de gedeelde set die is gedocumenteerd in Foutafhandeling. Als er een fout optreedt tijdens de verwerking, wordt de status bijgewerkt naar "error" en zal het error-veld de specifieke reden van de storing bevatten.

Creditkosten

Voor Developer API-verzoeken zijn de kosten afhankelijk van het gekozen uitvoer-quality-niveau vermenigvuldigd met de sampleCount.

Formule: Cost = QualityCredits × sampleCount

Kwaliteitsniveau	Credits per afbeelding
1k (Standaard)	2
2k	3
4k	5