Keyfiyyət Artırıcı (Upscale)
Keyfiyyət Artırıcı son nöqtəsi, şəkillərin təsvir ölçüsünü və incə detallarını ağıllı şəkildə artırmağa və təkmilləşdirməyə imkan verir, 4K təsvir ölçüsünə qədər dəstəkləyir.
Model Adı: upscale
Həyat Dövrü: stable
Emal Vaxtı: ~8s–20s
Çıxış Formatı: Auto (JPEG or PNG)
Çatdırılma Metodları: URL
Kreditlər: 3 to 4 per image (2k: 3, 4k: 4)
Sorğu
Şəklinizi və hədəf təsvir ölçüsünü universal /v1/run son nöqtəsinə göndərin:
https://fititon.app/api/v1/runSorğu Nümunələri
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"
}
}'Cavab
Upscaling 20 saniyəyə qədər çəkə bildiyi üçün, /v1/run son nöqtəsi dərhal asinxron iş id ilə 201 Created statusunu qaytarır. Son şəkli əldə etmək üçün bu id istifadə edərək Status API-ni sorğulamalısınız. Alternativ olaraq, bildirişləri avtomatik almaq üçün veb-hookları konfiqurasiya edə bilərsiniz. Nəzərə alın ki, veb-hook göndəricimiz ciddi 15 saniyəlik vaxt aşımını tətbiq edir. Serveriniz veb-hooku 15 saniyə ərzində 2xx status kodu ilə təsdiqləməlidir, əks halda biz onu uğursuz hesab edəcəyik və daha sonra yenidən cəhd edəcəyik.
{
"id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
"status": "starting",
"created_at": "2024-03-10T12:00:00Z",
"model_name": "upscale"
}İş tamamlandıqda (status: "success"), output sahəsi nəticələnən URL-lərin massivini ehtiva edəcək:
{
"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"
}Sorğu Parametrləri
Tələb Olunan Parametrlər
imageUrlRequiredstringBöyütmək istədiyiniz mənbə şəkli. Ümumi əlçatan URL və ya Base64 ilə kodlanmış şəkil sətiri ola bilər.
Formatlaşdırma və Yük Tələbi
Base64 sətiri göndərərkən, o, standart məlumat URI prefiksini (məsələn, data:image/jpeg;base64,...) ehtiva etməlidir. Bundan əlavə, qlobal JSON yük ölçüsü limitlərinə (HTTP 413) çatmaması üçün 3MB-dan böyük şəkillər üçün standart HTTP URL-lərindən istifadə etməyi şiddətlə tövsiyə edirik.
targetQualityRequired'2k' | '4k'İstənilən çıxış təsvir ölçüsü səviyyəsi.
Qeyd: 4.25 meqapikseldən böyük şəkillər targetQuality="2k" istifadə edə bilməz və 4k hədəfləməlidir.
İşləmə Xətaları
Bu funksiya üçün işləmə xətaları Xəta İdarəetməsi sənədlərində qeyd olunan ümumi dəstdən istifadə edir. Emal zamanı xəta baş verərsə, status "error" olaraq yenilənəcək və error sahəsi xüsusi uğursuzluq səbəbini ehtiva edəcək.
Kredit Dəyəri
Tərtibatçı API sorğuları üçün dəyər targetQuality-dən asılı olaraq dəyişir.
Formula: Dəyər = KeyfiyyətKreditləri
| Parametr | Şəkil Başına Kreditlər |
|---|---|
targetQuality="2k" | 3 |
targetQuality="4k" | 4 |
