Virtueel Passen (Afbeelding Passen)
Het Passen-eindpunt stelt u in staat om een kledingstuk naadloos op een persoon te passen met behulp van een afbeeldingsreferentie.
Modelnaam: tryon
Levenscyclus: stabiel
Verwerkingstijd: ~15s–30s
Uitvoerformaat: Auto (JPEG of PNG)
Leveringsmethoden: URL (via Polling)
Credits: 1 × sampleCount
Verzoek
Dien uw pasconfiguratie in bij het universele /v1/run-eindpunt met behulp van een JSON-payload.
https://fititon.app/api/v1/runVoorbeelden 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": "tryon",
"inputs": {
"personImage": "https://example.com/person.jpg",
"garmentImage": "https://example.com/garment.jpg",
"accuracy": "high",
"sampleCount": 1
}
}'Antwoord
De generatie van het Passen gebeurt asynchroon op de achtergrond. Uw verzoek zal onmiddellijk een 200 OK-status retourneren met een trackingobject.
{
"id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
"status": "starting",
"created_at": "2026-07-17T11:00:00Z",
"error": null,
"output": null
}Polling voor resultaten
U moet de geretourneerde id gebruiken om het status-eindpunt (GET https://fititon.app/api/v1/status/{id}) te pollen om uw gegenereerde afbeeldings-URL's op te halen. Zie de API Setup-gids voor gedetailleerde instructies.
Verzoekparameters
Vereiste parameters
personImageRequiredstringDe basisafbeelding van het model dat u wilt aankleden. Kan een openbaar toegankelijke URL zijn of een Base64-gecodeerde afbeeldingsreeks. Ondersteunde formaten: JPEG, PNG, WEBP. Max. grootte: 25MB.
Pro Tip: Poses van voren met zichtbare armen leveren de meest realistische drapering op. Verwijder tassen, sjaals of jassen die het lichaam bedekken voordat u fotografeert.
Opmaakvereiste
Bij het indienen van een Base64-reeks moet deze het standaard data URI-voorvoegsel bevatten (bijv. data:image/jpeg;base64,...). Het /v1/run-eindpunt accepteert alleen JSON-payloads, dus multipart/form-data-uploads worden niet ondersteund.
garmentImageRequiredstringDe afbeelding van het kledingstuk om te passen. Kan een openbaar toegankelijke URL zijn of een Base64-gecodeerde afbeeldingsreeks.
Pro Tip: Platte kledingfoto's op een witte achtergrond werken merkbaar beter dan foto's aan een hanger of verkreukelde kleding.
Optionele parameters
accuracy'standard' | 'high' | 'hyper'Definieert de getrouwheid van de pasvorm. Hogere nauwkeurigheid verhoogt de generatieprecisie, maar kan iets langer duren.
Standaard: standard
sampleCountintegerAantal afbeeldingsvariaties dat per verzoek moet worden gegenereerd. Moet tussen 1 en 4 liggen. Extra afbeeldingen verbruiken meer credits en verhogen de verwerkingstijd lineair.
Standaard: 1
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 bevat het error-veld de specifieke reden van de storing.
Creditkosten
Voor Developer API-verzoeken werkt het Virtueel Passen-eindpunt met een vast tarief van 1 credit per gegenereerde afbeelding, ongeacht de aangevraagde quality-tier.
Formule: Kosten = 1 × sampleCount
| Parameter | Credits per afbeelding |
|---|---|
| Vast tarief | 1 |
