Düz səthdə və ya maneken üzərində çəkilmiş məhsul şəkillərini peşəkar model üzərində çəkilmiş fotolara çevirin.

Məhsuldan Modelə

Məhsuldan Modelə son nöqtəsi düz səthdə və ya maneken üzərində çəkilmiş məhsul şəkillərini peşəkar model üzərində çəkilmiş fotolara çevirir, modelin görünüşünü və ya fotoqrafiya tərzini müəyyən etməyə imkan verir.

Model Adı: product-to-model

Həyat Dövrü: stable

Emal Vaxtı: ~10s–30s (stil və ya model referanslarından istifadə edildikdə artır)

Çıxış Formatı: Avtomatik (JPEG və ya PNG)

Çatdırılma Metodları: URL

Kreditlər: hər nəsil üçün 1-dən 5-ə qədər (keyfiyyətdən asılıdır)

Sorğu

Məhsul şəklinizi universal /v1/run son nöqtəsinə göndərin:

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

Sorğ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": "product-to-model",
           "inputs": {
             "productImage": "https://example.com/ghost-mannequin-shirt.jpg",
             "styleId": "editorial",
             "customPrompt": "Asian female model, outdoor city street, natural lighting",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "3:4"
           }
         }'

Cavab

Şəkil generasiyası 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. 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 dispetçerimiz ciddi 15 saniyəlik vaxt məhdudiyyəti 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ış şəklinizə işarə edən URL ilə 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/product-model-123.png"
  ]
}

Sorğu Parametrləri

Tələb Olunan Parametrlər

productImageRequiredstring

Məhsulun model üzərində yerləşdiriləcək şəkli (düz səthdə və ya maneken üzərində). Ümumi əlçatan URL və ya Base64-kodlanmış şəkil sətiri ola bilər. Maksimum ölçü: 25MB.

Peşəkar Məsləhət: Ağ fon üzərində çəkilmiş düz səth fotoları model üzərində ən ardıcıl nəticələr verir. Maneken fotoları da yaxşı işləyir. Çəkilişdən əvvəl geyimin bir hissəsi olmayan etiketləri, qiymət stikerlərini və ya aksesuarları çıxarın. Bütün geyimin görünən və açılmış olduğundan əmin olun — kəsilmiş qollar olmasın.

Formatlaşdırma Tələbi Base64 sətiri göndərərkən, o, standart data URI prefiksini (məsələn, data:image/jpeg;base64,...) ehtiva etməlidir.

Könüllü Parametrlər

customPromptstring

İstənilən modeli (məsələn, cins, etnik mənsubiyyət, poza) və ya səhnəni təsvir edən mətn təlimatları. Maksimum uzunluq: 500 simvol.

modelImageUrlstring

Generasiya üçün istifadə ediləcək insan referans modelinin URL-i. Buraxılarsa, təsadüfi müxtəlif model yaradılacaq.

Əvvəlcədən Təyin Edilmiş Modellər Mövcuddur:

Qeyd: Referans modelin təmin edilməsi ümumi emal müddətini artırır.

styleIdstring

Tətbiq ediləcək fotoqrafiya stilinin ID-si (məsələn, "studio", "iphone", "editorial"). Buraxılarsa, neytral studiya təqdimatına standart olaraq təyin edilir.

Mövcud Stiller:

Style Name	Style ID (`styleId`)

Qeyd: Mürəkkəb stillər generasiya müddətini artıra bilər.

quality'1k' | '2k' | '4k'

Çıxış keyfiyyət səviyyəsi. 1k ~1 meqapiksel, 2k ~4 meqapiksel və 4k ~16 meqapiksel çıxış verir. Defolt: 1k

sampleCountinteger

Hər sorğu üçün yaradılacaq şəkil variantlarının sayı. 1 ilə 4 arasında olmalıdır. Defolt: 1

ratiostring

Yaradılmış şəklin en-hündürlük nisbətini müəyyən edir. Boş olarsa, sistem moda çəkilişləri üçün standart olaraq 3:4 nisbətini təyin 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ə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əsinin sampleCount ilə vurulmasından asılıdır.

Formula: Dəyər = KeyfiyyətKreditləri × nümunəSayısı

Keyfiyyət Səviyyəsi	Hər Şəkilə Kredit
1k (Defolt)	1
2k	3
4k	5