Verhoog en verbeter de resolutie en details van uw gegenereerde modeafbeeldingen.

Kwaliteitsverbeteraar (Upscale)

Het Kwaliteitsverbeteraar-eindpunt stelt u in staat om op intelligente wijze de resolutie en fijnere details van afbeeldingen te verhogen en te verbeteren, met ondersteuning tot 4K-resolutie.

Modelnaam: upscale

Levenscyclus: stable

Verwerkingstijd: ~8s–20s

Uitvoerformaat: Auto (JPEG of PNG)

Leveringsmethoden: URL

Credits: 3 tot 4 per afbeelding (2k: 3, 4k: 4)

Verzoek

Dien uw afbeelding en gewenste resolutie 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": "upscale",
           "inputs": {
             "imageUrl": "https://example.com/1k-image.jpg",
             "targetQuality": "2k"
           }
         }'

Antwoord

Omdat upscaling 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 behulp van dit id 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 handhaaft. 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": "upscale"
}

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

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

Verzoekparameters

Vereiste parameters

imageUrlRequiredstring

De bronafbeelding die u wilt upscalen. Kan een openbaar toegankelijke URL zijn of een Base64-gecodeerde afbeeldingsreeks.

Opmaak- & Payloadvereiste Bij het indienen van een Base64-reeks moet deze het standaard data URI-voorvoegsel bevatten (bijv. data:image/jpeg;base64,...). Bovendien 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) worden overschreden.

targetQualityRequired'2k' | '4k'

De gewenste uitvoerresolutielaag. Opmerking: Afbeeldingen groter dan 4.25 megapixels kunnen geen targetQuality="2k" gebruiken en moeten 4k als doel hebben.

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 afhankelijk van de targetQuality.

Formule: Kosten = KwaliteitCredits

Parameter	Credits per afbeelding
`targetQuality="2k"`	3
`targetQuality="4k"`	4