Model Yarat
Model Yarat sadə, intuitiv təlimatlar və ya istinad şəkilləri ilə realistik moda modelləri yaratmağa, yaxud mövcud model şəkillərini iş sahənizə yükləməyə imkan verir.
Model Adı: model-create
Həyat dövrü: stable
Emal vaxtı: ~10s–30s (üz/poza kimi qabaqcıl istinadlardan istifadə edərkən artır)
Çıxış Formatı: Auto (JPEG or PNG)
Çatdırılma Metodları: URL
Kreditlər: 1 to 5 per model (1k: 1, 2k: 3, 4k: 5)
Sorğu
Konfiqurasiyanızı universal /v1/run son nöqtəsinə göndərərək moda modelləri yaradın və ya yükləyin:
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": "model-create",
"inputs": {
"type": "generate",
"name": "Summer Collection Model",
"prompt": "Full body shot, woman wearing a white t-shirt and dark blue biker shorts, studio lighting",
"gender": "female",
"quality": "2k",
"sampleCount": 1
}
}'Cavab
Modelin yaradılması 30 saniyəyə qədər çəkə biləcəyi üçün, /v1/run son nöqtəsi dərhal asinxron iş id ilə 201 Created statusunu 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ı tətbiq edir. Serveriniz veb-hooku 15 saniyə ərzində 2xx status kodu ilə təsdiq etməlidir, əks halda biz onu uğursuz hesab edib 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ış modelinizin URL-ni göstərən bir massiv ehtiva edəcək:
{
"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/model-123.png"
]
}Sorğu Parametrləri
Tələb Olunan Parametrlər
typeRequired'generate' | 'upload'Süni intellekt vasitəsilə yeni model yaratmaq (generate) və ya mövcud şəkli yükləmək (upload) üçün istifadə olunur.
nameRequiredstringModeliniz üçün təsviredici ad. Bu, studiyanızda modeli müəyyən etmək üçün istifadə olunur.
promptstringYaradılma üçün tələb olunur Yaradılacaq modelin mətn təsviri. İstənilən moda modelini, geyimi, pozanı və fon səhnəsini təsvir edir.
Peşəkar İpucu: Əgər faceModelId kimi bir istinad istifadə edirsinizsə, Sİ istinadın şəxsiyyətinə üstünlük verəcək, lakin parametrləri, geyimi və bədən xüsusiyyətlərini müəyyən etmək üçün sizin təlimatınızdan istifadə edəcək. Yalnız faceModelId təmin edildiyi halda isteğe bağlıdır.
imageBase64stringYükləmə üçün tələb olunur
Base64 ilə kodlanmış şəkil sətiri. type upload olaraq təyin edildikdə tələb olunur.
Formatlaşdırma Tələbi
Sizin Base64 sətiriniz standart data URI prefiksini (məsələn, data:image/jpeg;base64,... və ya data:image/png;base64,...) ehtiva etməlidir. Yalnız xam kodlanmış sətir təmin edilərsə, yükləmə uğursuz olacaq.
İsteğe Bağlı Yaradılma Parametrləri
Bu parametrlər type generate olaraq təyin edildikdə tətbiq olunur.
genderstringModelin cinsi. Fiziksel xüsusiyyətləri müəyyən etməkdə yaratma modelinə kömək edir.
bodyTypestringModelin bədən tipi (məsələn, "atletik", "plus size", "incə").
clothingstringYaradılma zamanı tətbiq ediləcək xüsusi geyim detalları, əsas promptu gücləndirir.
posestringPozanın mətn təsviri (məsələn, "əlləri cibində dayanan", "yeriyən").
faceModelIdstringNəsillər boyu müəyyən bir şəxsiyyəti qorumaq üçün mövcud üz modelinin UUID-si. Çıxış, istinad üzünü qoruyaraq hədəf təlimata uyğunlaşacaq.
Qeyd: Üz istinadı təmin etmək, Sİ şəxsiyyəti uyğunlaşdırdığı üçün ümumi emal müddətinə bir neçə saniyə əlavə edir.
poseModelIdstringMövcud poza modelinin UUID-si. Yaradılmanı bədən pozası və duruşu üçün istinada ciddi şəkildə uyğunlaşmağa məcbur edir.
Qeyd: Poza istinadı təmin etmək emal müddətini artırır.
poseImageBase64stringSaxlanmış poseModelId təmin etmək əvəzinə, ad-hoc poza istinadı kimi istifadə ediləcək Base64 ilə kodlanmış şəkil sətiri.
quality'1k' | '2k' | '4k'Çıxış çözünürlük səviyyəsi. 1k ~1 meqapiksel, 2k ~4 meqapiksel və 4k ~16 meqapiksel çıxış verir. Daha yüksək çözünürlüklər daha çox kredit sərf edir.
Varsayılan: 1k
aspectRatiostringYaradılan şəklin en-hündürlük nisbətini müəyyən 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'.
Varsayılan: 3:4
sampleCountintegerHər sorğu üçün yaradılacaq şəkil variantlarının sayı. Əlavə şəkillər daha çox kredit sərf edir və emal müddətini xətti şəkildə artırır.
Varsayılan: 1
İşləmə Zamanı Səhvlər
Bu funksiya üçün işləmə zamanı səhvlər 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 seçilmiş çıxış quality səviyyəsindən asılıdır.
| Keyfiyyət Səviyyəsi | Model Başına Kreditlər |
|---|---|
| 1k (Varsayılan) | 1 |
| 2k | 3 |
| 4k | 5 |
