Görsel Modeller (Anında)

Parel BYOM Anında görsel modelleri, GPU sağlamadan public bir Hugging Face görsel üretim modelini kendi tm_* model ID’nle /v1/images/generations üzerinden çağırmana imkan tanır. Fiyatlandırma görsel başına; Parel %80 (1.8x) marj uygular.

Desteklenen Modeller

Model	HF ID	Lisans	Not
FLUX.1 schnell	black-forest-labs/FLUX.1-schnell	apache-2.0	4 adım, en hızlı Flux
FLUX.1 dev	black-forest-labs/FLUX.1-dev	non-commercial	Lisans kabulü zorunlu
FLUX.1 pro	black-forest-labs/FLUX.1-pro	ticari	Kapalı ağırlık
Stable Diffusion 3.5 large	stabilityai/stable-diffusion-3.5-large	community	Çok bileşenli
SDXL base 1.0	stabilityai/stable-diffusion-xl-base-1.0	openrail++	Hafif
Qwen-Image	Qwen/Qwen-Image	apache-2.0	Çok dilli prompt’larda güçlü
PixArt-Sigma	PixArt-alpha/PixArt-Sigma-XL-2-1024-MS	openrail++	Hafif, hızlı

Diğer Hugging Face modelleri dinamik doğrulanır: inferenceProviderMapping canlı bir text-to-image sağlayıcı (öncelik Fal AI) listeliyorsa import başarılı olur.

Akış

1. Doğrula. Modelin erişilebilir olduğunu ve fiyatlandırmayı kontrol et.
2. İçe aktar. Tenant’ına özel tm_* model ID oluştur. Non-commercial lisansa sahip model ise (örn. FLUX.1-dev) accepted_license: true gönder.
3. Üret. /v1/images/generations çağrılır. Endpoint asenkron kuyruk üzerinden çalıştığı için 202 Accepted + task_id döner. /v1/tasks/{id} ile sonucu yokla.

import time
import httpx

API = "https://api.parel.cloud/v1"
HEADERS = {"Authorization": "Bearer pk-dev-YOUR_KEY"}

# 1. Doğrula
val = httpx.post(
    f"{API}/my-models/validate-hf",
    headers=HEADERS,
    json={"hf_model_id": "black-forest-labs/FLUX.1-schnell"},
).json()
assert val["supported"], val["errors"]

# 2. İçe aktar
imported = httpx.post(
    f"{API}/my-models/import-hf",
    headers=HEADERS,
    json={
        "validation_id": val["validation_id"],
        "execution_mode": "instant",
        "accepted_license": val.get("requires_license_acceptance", False),
    },
).json()
model_id = imported["parel_model_id"]   # tm_flux_1_schnell_xxxx

# 3. Üret (async)
queued = httpx.post(
    f"{API}/images/generations",
    headers=HEADERS,
    json={
        "model": model_id,
        "prompt": "günbatımında huzurlu bir dağ gölü, fotoğrafgerçekçi",
        "n": 1,
        "size": "1024x1024",
    },
).json()
task_id = queued["task_id"]

# 4. Yokla
for _ in range(30):
    time.sleep(2)
    state = httpx.get(f"{API}/tasks/{task_id}", headers=HEADERS).json()
    if state["status"] == "completed":
        print(state["result"]["data"][0]["url"])
        break
    if state["status"] == "failed":
        raise RuntimeError(state["error"])

Endpoint’ler

Endpoint	Açıklama
POST /v1/my-models/validate-hf	Pipeline tag, fiyat, lisans bayrağı döner
POST /v1/my-models/import-hf	tm_* model ID kaydeder
POST /v1/images/generations	Async; task_id döner
GET /v1/tasks/{id}	Sonuç için status=completed ve result.data[].url

Fiyatlandırma

Görsel başına ücretlendirme; Parel %80 (1.8x) marj uygular. Örnekler (USD):

Aile	Upstream	Parel
FLUX.1 schnell	$0.003	$0.0054
FLUX.1 dev / SD 3.5	$0.025	$0.045
FLUX.1 pro	$0.04	$0.072
SDXL / PixArt	$0.005	$0.009
Qwen-Image	$0.018	$0.0324

Fiili oran validate yanıtında pricing.per_image alanında döner.

Lisans Kabulü

Bazı modeller (örn. FLUX.1-dev) non-commercial lisansla dağıtılır. Doğrulayıcı requires_license_acceptance: true ve uyarı döner. Ticari kullanım sorumluluğunu kabul ettiğini bildirmek için import gövdesinde accepted_license: true geçir. Kabul olmadan import 400 license_acceptance_required döner.

Cold Start ve Latency

Anında görsel üretimi Hugging Face Inference Providers (varsayılan Fal AI) üzerinden yönlendirilir. Uçtan uca latency sağlayıcıya bağlıdır:

• FLUX.1 schnell: 4-7 saniye warm
• FLUX.1 dev: 9-14 saniye warm
• SD 3.5 large: 6-9 saniye
• Qwen-Image: 5-8 saniye

Dedicated GPU yok, idle ücreti yok. Deterministik latency veya LoRA desteği için Dedicated GPU — image dedicated yolu BYOM Image Faz 2’de gelir.

Kapsam Dışı (Faz 2)

• Video modeller (Wan2.2, HunyuanVideo)
• Görsel düzenle / inpaint endpoint’leri
• LoRA upload
• ControlNet koşullandırma

Bu özellikler BYOM Image Faz 2 (PAR-44) ile gelir.