Houdingscontrole

Het Houdingscontrole-eindpunt stelt u in staat om een bestaande afbeelding van een model te nemen en nieuwe variaties te genereren waarbij het model een andere lichaamshouding aanneemt. De AI behoudt nauwgezet de gelaatstrekken, kleding en achtergrond van het model.

Verzoek

Dien uw modelafbeelding en een lijst met gewenste houdingen in bij het universele /v1/run-eindpunt:

Voorbeelden van verzoeken

U kunt een model in een andere houding plaatsen met behulp van een referentieafbeelding (sjabloon) of een tekstbeschrijving (aangepast).

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "pose-control",
           "inputs": {
             "modelImage": "https://example.com/model-standing.jpg",
             "quality": "2k",
             "poses": [
               {
                 "type": "template",
                 "cdnUrl": "https://example.com/pose-reference.jpg",
                 "title": "Handen in de zij"
               },
               {
                 "type": "custom",
                 "text": "Zittend op een stoel met gekruiste benen"
               }
             ]
           }
         }'

Antwoord

Omdat het genereren 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 bevragen met GET /v1/status/{id} om de uiteindelijke resultaten op te halen. U kunt ook 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": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Zodra de status verandert naar "succeeded", zal het output-veld een array van URL's bevatten die verwijzen naar uw gegenereerde afbeeldingen. De afbeeldingen worden geretourneerd in exact dezelfde volgorde als de poses-array die in uw oorspronkelijke verzoek is opgegeven:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/fititon-pose-123-0.png",
    "https://cdn.fititon.app/users/123/results/fititon-pose-123-1.png"
  ]
}

Verzoekparameters

Vereiste parameters

Officiële houdingssjablonen

Hoewel u uw eigen referentieafbeeldingen kunt aanleveren via cdnUrl, bieden wij een samengestelde directory van sterk geoptimaliseerde houdingssjablonen. Klik op een van de onderstaande URL's om de houding te bekijken.

Optionele parameters

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 schalen de kosten lineair op basis van het aantal aangevraagde houdingen, en zijn afhankelijk van het gekozen uitvoer quality-niveau.

Formule: Kosten = KwaliteitCredits × AantalHoudingen

Voorbeeld: Het aanvragen van een array van 3 houdingen met 1k kwaliteit kost in totaal 3 credits. Het aanvragen van dezelfde 3 houdingen met 4k kwaliteit kost in totaal 15 credits.