Pozaya Nəzarət

Pozaya Nəzarət son nöqtəsi modelin mövcud şəklini götürməyə və modelin fərqli bədən pozası aldığı yeni variantlar yaratmağa imkan verir. Süni intellekt modelin üz cizgilərini, geyimini və fonunu diqqətlə qoruyur.

Sorğu

Model şəklinizi və istədiyiniz pozaların siyahısını universal /v1/run son nöqtəsinə göndərin:

Sorğu Nümunələri

Siz modeli istinad şəkli (şablon) və ya mətn təsviri (fərdi) istifadə edərək yenidən poza verə bilərsiniz.

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "pose-control",
           "inputs": {
             "modelImage": "https://example.com/model-standing.jpg",
             "quality": "2k",
             "poses": [
               {
                 "type": "template",
                 "cdnUrl": "https://example.com/pose-reference.jpg",
                 "title": "Hands on hips"
               },
               {
                 "type": "custom",
                 "text": "Sitting on a chair with legs crossed"
               }
             ]
           }
         }'

Cavab

Yaradılma 30 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 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 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ış şəkillərinizə işarə edən URL-lərin massivini ehtiva edəcək. Şəkillər ilkin sorğunuzda verilən poses massivi ilə eyni qaydada 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/fititon-pose-123-0.png",
    "https://cdn.fititon.app/users/123/results/fititon-pose-123-1.png"
  ]
}

Sorğu Parametrləri

Tələb Olunan Parametrlər

Rəsmi Poza Şablonları

Öz istinad şəkillərinizi cdnUrl vasitəsilə təqdim edə bilsəniz də, biz yüksək optimallaşdırılmış poza şablonlarının seçilmiş kataloqunu təklif edirik. Pozanı önizləmək üçün aşağıdakı istənilən URL-ə klikləyin.

İsteğe Bağlı Parametrlər

İş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 tələb olunan pozaları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 × PozalarınSayısı

Nümunə: 1k keyfiyyətində 3 pozadan ibarət massiv tələb etmək ümumilikdə 3 kreditə başa gəlir. Eyni 3 pozanı 4k keyfiyyətində tələb etmək ümumilikdə 15 kreditə başa gəlir.