Améliorez et augmentez la résolution et les détails de vos images de mode générées.

Améliorateur de Qualité (Upscale)

Le point de terminaison Améliorateur de Qualité vous permet d'augmenter intelligemment la résolution et d'améliorer les détails plus fins des images, supportant jusqu'à la résolution 4K.

Nom du Modèle: upscale

Cycle de vie: stable

Temps de Traitement: ~8s–20s

Format de Sortie: Auto (JPEG ou PNG)

Méthodes de Livraison: URL

Crédits: 3 à 4 par image (2k: 3, 4k: 4)

Requête

Soumettez votre image et la résolution cible au point de terminaison universel /v1/run:

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

Exemples de Requête

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

Réponse

Étant donné que l'upscaling peut prendre jusqu'à 20 secondes, le point de terminaison /v1/run renvoie immédiatement un statut 201 Created avec un id de tâche asynchrone. Vous devez interroger l'API de Statut en utilisant cet id pour récupérer l'image finale. Alternativement, vous pouvez configurer des webhooks pour recevoir des notifications automatiquement. Veuillez noter que notre répartiteur de webhooks applique un délai d'attente strict de 15 secondes. Votre serveur doit accuser réception du webhook avec un code de statut 2xx dans les 15 secondes, sinon nous le considérerons comme échoué et le réessaierons plus tard.

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

Lorsque la tâche est terminée (status: "success"), le champ output contiendra le tableau des URL résultantes:

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

Paramètres de Requête

Paramètres Obligatoires

imageUrlRequiredstring

L'image source que vous souhaitez upscaler. Il peut s'agir d'une URL accessible publiquement ou d'une chaîne d'image encodée en Base64.

Exigence de Formatage et de Charge Utile Lors de la soumission d'une chaîne Base64, elle doit inclure le préfixe URI de données standard (par exemple, data:image/jpeg;base64,...). De plus, nous recommandons fortement d'utiliser des URL HTTP standard pour les images de plus de 3 Mo afin d'éviter d'atteindre les limites de taille de charge utile JSON globales (HTTP 413).

targetQualityRequired'2k' | '4k'

Le niveau de résolution de sortie souhaité. Remarque : Les images de plus de 4,25 mégapixels ne peuvent pas utiliser targetQuality="2k" et doivent cibler 4k.

Erreurs d'Exécution

Les erreurs d'exécution pour cette fonctionnalité utilisent l'ensemble partagé documenté dans Gestion des Erreurs. Si une erreur survient pendant le traitement, le status sera mis à jour à "error" et le champ error contiendra la raison spécifique de l'échec.

Coût en Crédits

Pour les requêtes API Développeur, le coût varie en fonction de la targetQuality.

Formule : Coût = CréditsQualité

Paramètre	Crédits par Image
`targetQuality="2k"`	3
`targetQuality="4k"`	4