DokümantasyonDocumentation

Son güncelleme: 26 Nisan 2026 Last updated: 26 Nisan 2026

1. Başlangıç

Omorfos AI'ı WooCommerce mağazanıza entegre etmek sadece birkaç dakika sürer. Bu rehber, eklenti kurulumundan ilk sanal deneme işlemine kadar tüm adımları açıklar.

2. Hesap Oluşturma

omorfos.ai/auth/register adresine gidin.
Şirket adınızı, e-posta adresinizi ve şifrenizi girin.
E-postanıza gelen 6 haneli doğrulama kodunu girin.
Hesabınız aktif! Dashboard'a yönlendirileceksiniz.

3. Site (Domain) Ekleme

Dashboard'da Domains menüsüne gidin.
"Add New Domain" butonuna tıklayın.
WooCommerce mağazanızın domain adını girin (ör: mağazam.com).
Sistem otomatik olarak bir Site Token ve Secret Key oluşturacaktır.

Önemli: Site Token ve Secret Key bilgilerinizi güvenli bir yerde saklayın. Eklenti kurulumunda kullanacaksınız.

4. WooCommerce Eklenti Kurulumu

WordPress admin panelinize giriş yapın.
Eklentiler → Yeni Ekle bölümüne gidin.
"Omorfos AI" eklentisini arayın ve kurun. (Alternatif: Eklenti ZIP dosyasını yükleyin)
Eklentiyi aktifleştirin.
Ayarlar → Omorfos AI bölümüne gidin.
Site Token ve Secret Key bilgilerinizi girin.
Kaydet'e tıklayın. ✅

5. Eklenti Ayarları

Ayar	Açıklama
Site Token	Dashboard'dan aldığınız site kimlik anahtarı
Secret Key	API güvenlik imzalama anahtarı (HMAC)
Model Preset	Varsayılan model tipi (yetişkin erkek/kadın, çocuk, bebek...)
Buton Metni	Ürün sayfasında görünecek "Sanal Dene" buton yazısı
Buton Konumu	Sepet butonundan önce/sonra

6. Nasıl Çalışır?

Müşteriniz ürün sayfasında "Sanal Dene" butonuna tıklar.
Ürün görseli Omorfos AI'a güvenli şekilde gönderilir.
Yapay zeka, seçilen model üzerinde ürünü gerçekçi şekilde gösterir.
Sonuç müşteriye anlık olarak gösterilir.
Aynı istek tekrar geldiğinde önbellekten sunulur (kullanım hakkı harcanmaz).

7. Kota Kullanımı

Her yeni sanal deneme işlemi 1 kullanım hakkı tüketir.
Önbellekten (cache) sunulan sonuçlar kota tüketmez.
Kullanım hakkı bakiyenizi Dashboard → Overview veya Billing sayfasından takip edebilirsiniz.
Kota satın almak için Billing → Top Up Quota butonunu kullanın.

8. API Referansı

Endpoint

POST https://omorfos.ai/api/v1/try-on

Headers

Header	Değer
`X-Site-Token`	Site token'ınız
`X-Timestamp`	Unix timestamp
`X-Signature`	HMAC-SHA256 imza
`Content-Type`	application/json

İstek Gövdesi (JSON)

{ "product_images": ["https://...jpg"], "model_id": "adult_female", "skin_tone": "medium", "ethnicity": "caucasian", "eye_color": "brown" }

Model Preset'leri

ID	Açıklama
`adult_male`	Yetişkin Erkek
`adult_female`	Yetişkin Kadın
`boy_child`	Erkek Çocuk (6-8 yaş)
`girl_child`	Kız Çocuk (6-8 yaş)
`baby`	Bebek
`baby_boy`	Erkek Bebek (0-3 yaş)
`baby_girl`	Kız Bebek (0-3 yaş)
`teen_male`	Genç Erkek
`teen_female`	Genç Kız

9. Sorun Giderme

Hata	Çözüm
401 Unauthorized	Site Token veya Secret Key'inizi kontrol edin
403 Invalid Signature	HMAC imzalama algoritmanızı ve timestamp'i doğrulayın
429 Rate Limited	Kullanım limitinizi kontrol edin
500 Server Error	info@omorfos.ai ile iletişime geçin

10. Destek

Herhangi bir sorunuz veya sorununuz olursa: info@omorfos.ai

1. Getting Started

Integrating Omorfos AI into your WooCommerce store takes just a few minutes. This guide covers everything from plugin installation to your first virtual try-on.

2. Account Creation

Go to omorfos.ai/auth/register.
Enter your company name, email address, and password.
Enter the 6-digit verification code sent to your email.
Your account is active! You'll be redirected to the Dashboard.

3. Adding a Site (Domain)

In the Dashboard, go to Domains.
Click "Add New Domain".
Enter your WooCommerce store's domain (e.g., mystore.com).
The system will automatically generate a Site Token and Secret Key.

Important: Keep your Site Token and Secret Key safe. You'll need them for plugin setup.

4. WooCommerce Plugin Installation

Log in to your WordPress admin panel.
Go to Plugins → Add New.
Search for "Omorfos AI" and install it. (Alternative: Upload the plugin ZIP file)
Activate the plugin.
Go to Settings → Omorfos AI.
Enter your Site Token and Secret Key.
Click Save. ✅

5. Plugin Settings

Setting	Description
Site Token	Your site identity key from the Dashboard
Secret Key	API security signing key (HMAC)
Model Preset	Default model type (adult male/female, child, baby...)
Button Text	"Try On" button text displayed on product pages
Button Position	Before/after the Add to Cart button

6. How It Works

Your customer clicks the "Try On" button on the product page.
The product image is securely sent to Omorfos AI.
AI generates a realistic visualization on the selected model.
The result is displayed instantly to the customer.
Repeated requests are served from cache (no quota consumed).

7. Quota Usage

Each new virtual try-on consumes 1 request.
Cached results do not consume quota.
Monitor your quota balance at Dashboard → Overview or Billing.
Purchase quota via Billing → Top Up Quota.

8. API Reference

Endpoint

POST https://omorfos.ai/api/v1/try-on

Headers

Header	Value
`X-Site-Token`	Your site token
`X-Timestamp`	Unix timestamp
`X-Signature`	HMAC-SHA256 signature
`Content-Type`	application/json

Request Body (JSON)

{ "product_images": ["https://...jpg"], "model_id": "adult_female", "skin_tone": "medium", "ethnicity": "caucasian", "eye_color": "brown" }

Model Presets

ID	Description
`adult_male`	Adult Male
`adult_female`	Adult Female
`boy_child`	Boy Child (6-8 years)
`girl_child`	Girl Child (6-8 years)
`baby`	Baby
`baby_boy`	Baby Boy (0-3 years)
`baby_girl`	Baby Girl (0-3 years)
`teen_male`	Teen Male
`teen_female`	Teen Female

9. Troubleshooting

Error	Solution
401 Unauthorized	Check your Site Token or Secret Key
403 Invalid Signature	Verify your HMAC signing algorithm and timestamp
429 Rate Limited	Check your quota balance
500 Server Error	Contact info@omorfos.ai

10. Support

For any questions or issues: info@omorfos.ai