Bucaq Yaratma
Bucaq Yaratma son nöqtəsi mövcud bir şəkli götürməyə və modeli, geyimi, teksturaları və işıqlandırmanı qoruyaraq yeni baxış bucaqları (məsələn, ön, arxa, yan profillər) yaratmaq üçün virtual kameranı yenidən yerləşdirməyə imkan verir.
Model Adı: angle-generation
Həyat Dövrü: stable
Emal Vaxtı: ~10s–20s
Çıxış Formatı: Avtomatik (JPEG və ya PNG)
Çatdırılma Metodları: URL, Base64 (önizləmə)
Kreditlər: yaradılan hər bucaq üçün 1-dən 5-ə qədər (keyfiyyətdən asılıdır)
Sorğu
Şəklinizi və istədiyiniz bucaqları 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": "angle-generation",
"inputs": {
"imageUrl": "https://example.com/front-view.jpg",
"angleIds": ["back", "leftSide"],
"quality": "2k"
}
}'Cavab
Bucaq yaratma 20 saniyəyə qədər çəkə biləcəyi üçün, /v1/run son nöqtəsi dərhal 201 Created statusu ilə asinxron iş id qaytarır. Yekun nəticələri əldə etmək üçün GET /v1/status/{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 15 saniyə ərzində 2xx status kodu ilə veb-hooku təsdiq etmə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": "2026-07-18T17:30:00.000Z",
"error": null,
"output": null
}status "succeeded" olaraq dəyişdikdən sonra, output sahəsi yaradılmış şəkillərin URL-lərini göstərən bir massiv ehtiva edəcək. Şəkillər ilkin sorğunuzda verilən angleIds massivi ilə eyni ardıcıllıqla qaytarılır:
{
"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"
]
}Sorğu Parametrləri
Tələb Olunan Parametrlər
imageUrlRequiredstringFırladılacaq mənbə şəkli. Ümumi əlçatan URL və ya Base64 ilə kodlanmış şəkil sətiri ola bilər.
Peşəkar İpucu: Ön tərəfə baxan fotolar ən ardıcıl çoxbucaq nəticələr verir. Bucaq altında və ya yan tərəfə baxan mənbə şəkillərindən çəkinin — ön görünüşlər süni intellektə işləmək üçün ən çox məlumatı verir, bucaqlı çəkilişlər isə süni intellekti çatışmayan struktur detallarını xəyal etməyə məcbur edir.
Formatlaşdırma 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.
angleIdsRequiredarray of stringsYaratmaq istədiyiniz bucaq identifikatorlarının massivi. Mövcud seçimlər bunlardır:
"front": Ön Görünüş"back": Arxa Görünüş"leftSide": Sol Tərəf (90°)"rightSide": Sağ Tərəf (90°)"left45": Sol 45°"right45": Sağ 45°
İsteğe Bağlı Parametrlər
quality'1k' | '2k' | '4k'Çıxış çözünürlük səviyyəsi.
Defolt: 1k
ratiostringAspekt nisbəti ləğvi (məsələn, 16:9, 3:4). Boş olarsa, sistem orijinal şəklin aspekt nisbətini defolt olaraq qəbul edir.
Dəstəklənən dəyərlər: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.
İşləmə Zamanı Səhvləri
Bu funksiya üçün işləmə zamanı səhvləri Səhv İdarəetməsi sənədlərində qeyd olunan ümumi dəstdən istifadə edir. Emal zamanı səhv 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 tələb olunan bucaqların sayına əsasən xətti şəkildə artır və seçilmiş çıxış quality səviyyəsindən asılıdır.
Formula: Dəyər = KeyfiyyətKreditləri × BucaqlarınSayısı
| Keyfiyyət Səviyyəsi | Hər Bucaq Üçün Kredit |
|---|---|
| 1k (Defolt) | 1 |
| 2k | 3 |
| 4k | 5 |
Nümunə: 1k keyfiyyətində ["back", "leftSide", "rightSide"] tələb etmək ümumilikdə 3 kreditə başa gəlir. Eyni 3 bucağı 4k keyfiyyətində tələb etmək ümumilikdə 15 kreditə başa gəlir.
