Hoekgeneratie

Het Hoekgeneratie-eindpunt stelt u in staat om een bestaande afbeelding te nemen en de virtuele camera te herpositioneren om nieuwe kijkhoeken (bijv. voor-, achter-, zijprofielen) te genereren, terwijl het model, de kleding, texturen en belichting behouden blijven.

Verzoek

Dien uw afbeelding en de gewenste hoeken in bij het universele /v1/run eindpunt:

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": "angle-generation",
           "inputs": {
             "imageUrl": "https://example.com/front-view.jpg",
             "angleIds": ["back", "leftSide"],
             "quality": "2k"
           }
         }'

Antwoord

Omdat hoekgeneratie tot 20 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. 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": "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 angleIds 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/angle-123-0.png",
    "https://cdn.fititon.app/users/123/results/angle-123-1.png"
  ]
}

Verzoekparameters

Vereiste parameters

Optionele parameters

Runtimefouten

Runtimefouten voor deze functie gebruiken 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 hoeken, en zijn afhankelijk van het gekozen uitvoer quality niveau.

Formule: Kosten = KwaliteitCredits × AantalHoeken

Voorbeeld: Het aanvragen van ["back", "leftSide", "rightSide"] met 1k kwaliteit kost in totaal 3 credits. Het aanvragen van dezelfde 3 hoeken met 4k kwaliteit kost in totaal 15 credits.