FLUX.1 [dev] with Controlnets and Loras Flux General

API kılavuzu ve entegrasyon referansı: uç nokta, girdi alanları, fiyatlar, webhook ve hatalar.

Mod

Bu modelin 2 modu var; alanlar, çıktı ve fiyatlar seçili moda göredir. Modu istekte category_id ile seçin (örneklerde hazır). Göndermezseniz girdinize uyan mod, o da yoksa varsayılan mod çalışır.

İstek ve yanıt

POST

https://kolayzeka.com/api/models/flux1-dev-with-controlnets-and-loras-flux-general/generate

Gövde: { "input": {…alanlar}, "category_id"?: sayı, "webhook_url"?: "https://…" }. Alanlar aşağıda; tanımlı olmayan bir alan 422 döner.

cURL · JSON

curl -X POST https://kolayzeka.com/api/models/flux1-dev-with-controlnets-and-loras-flux-general/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "Prompt",
    "num_inference_steps": 28,
    "loras": "[]",
    "control_loras": "[]",
    "controlnets": "[]",
    "controlnet_unions": "[]",
    "ip_adapters": "[]",
    "easycontrols": "[]",
    "guidance_scale": 3.5,
    "real_cfg_scale": 3.5,
    "use_real_cfg": false,
    "use_cfg_zero": false,
    "num_images": 1,
    "enable_safety_checker": true,
    "reference_strength": 0.65,
    "reference_start": 0,
    "reference_end": 1,
    "base_shift": 0.5,
    "max_shift": 1.15,
    "output_format": "png",
    "use_beta_schedule": false,
    "scheduler": "euler",
    "nag_scale": 3,
    "nag_tau": 2.5,
    "nag_alpha": 0.25,
    "nag_end": 0.25
  },
  "category_id": 15,
  "webhook_url": "https://your-server.com/hooks/kolayzeka"
}'

cURL · multipart (dosya yükleyerek)

curl -X POST https://kolayzeka.com/api/models/flux1-dev-with-controlnets-and-loras-flux-general/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F 'input[prompt]=Prompt' \
  -F 'input[num_inference_steps]=28' \
  -F 'input[loras]=[]' \
  -F 'input[control_loras]=[]' \
  -F 'input[controlnets]=[]' \
  -F 'input[controlnet_unions]=[]' \
  -F 'input[ip_adapters]=[]' \
  -F 'input[easycontrols]=[]' \
  -F 'input[guidance_scale]=3.5' \
  -F 'input[real_cfg_scale]=3.5' \
  -F 'input[use_real_cfg]=false' \
  -F 'input[use_cfg_zero]=false' \
  -F 'input[num_images]=1' \
  -F 'input[enable_safety_checker]=true' \
  -F 'input[reference_strength]=0.65' \
  -F 'input[reference_start]=0' \
  -F 'input[reference_end]=1' \
  -F 'input[base_shift]=0.5' \
  -F 'input[max_shift]=1.15' \
  -F 'input[output_format]=png' \
  -F 'input[use_beta_schedule]=false' \
  -F 'input[scheduler]=euler' \
  -F 'input[nag_scale]=3' \
  -F 'input[nag_tau]=2.5' \
  -F 'input[nag_alpha]=0.25' \
  -F 'input[nag_end]=0.25' \
  -F 'input[fill_image]=@./fill_image.jpg' \
  -F 'input[reference_image_url]=@./reference_image_url.jpg' \
  -F 'category_id=15' \
  -F 'webhook_url=https://your-server.com/hooks/kolayzeka'

Üretim asenkrondur. POST, 202 ve status: "queued" döner; sonuç henüz yoktur. Sonucu GET https://kolayzeka.com/api/generations/{id} ile sorgulayın ya da webhook_url verin (aynı nesne gelir). Durumlar: queued → processing → completed | failed. estimated_seconds bu modun geçmiş ortalama süresidir (null olabilir).

1 · POST yanıtı (202)

{
  "data": {
    "id": "9d1c…-uuid",
    "model": "flux1-dev-with-controlnets-and-loras-flux-general",
    "output_type": "image",
    "source": "api",
    "status": "queued",
    "input_data": {
      "prompt": "Prompt",
      "num_inference_steps": 28,
      "loras": "[]",
      "control_loras": "[]",
      "controlnets": "[]",
      "controlnet_unions": "[]",
      "ip_adapters": "[]",
      "easycontrols": "[]",
      "guidance_scale": 3.5,
      "real_cfg_scale": 3.5,
      "use_real_cfg": false,
      "use_cfg_zero": false,
      "num_images": 1,
      "enable_safety_checker": true,
      "reference_strength": 0.65,
      "reference_start": 0,
      "reference_end": 1,
      "base_shift": 0.5,
      "max_shift": 1.15,
      "output_format": "png",
      "use_beta_schedule": false,
      "scheduler": "euler",
      "nag_scale": 3,
      "nag_tau": 2.5,
      "nag_alpha": 0.25,
      "nag_end": 0.25
    },
    "output_data": null,
    "thumbnail_url": null,
    "credit_cost": 67216,
    "duration": null,
    "estimated_seconds": 12,
    "error_message": null,
    "webhook_url": "https://your-server.com/hooks/kolayzeka",
    "created_at": "2026-06-29T12:00:00.000000Z",
    "updated_at": "2026-06-29T12:00:00.000000Z"
  },
  "success": true
}

2 · Tamamlandı (GET /generations/{id} veya webhook)

{
  "data": {
    "id": "9d1c…-uuid",
    "model": "flux1-dev-with-controlnets-and-loras-flux-general",
    "output_type": "image",
    "source": "api",
    "status": "completed",
    "input_data": {
      "prompt": "Prompt",
      "num_inference_steps": 28,
      "loras": "[]",
      "control_loras": "[]",
      "controlnets": "[]",
      "controlnet_unions": "[]",
      "ip_adapters": "[]",
      "easycontrols": "[]",
      "guidance_scale": 3.5,
      "real_cfg_scale": 3.5,
      "use_real_cfg": false,
      "use_cfg_zero": false,
      "num_images": 1,
      "enable_safety_checker": true,
      "reference_strength": 0.65,
      "reference_start": 0,
      "reference_end": 1,
      "base_shift": 0.5,
      "max_shift": 1.15,
      "output_format": "png",
      "use_beta_schedule": false,
      "scheduler": "euler",
      "nag_scale": 3,
      "nag_tau": 2.5,
      "nag_alpha": 0.25,
      "nag_end": 0.25
    },
    "output_data": {
      "result": "https://<signed-url>/output.jpg"
    },
    "thumbnail_url": "https://<signed-url>/thumb.jpg",
    "credit_cost": 67216,
    "duration": 4.52,
    "estimated_seconds": 12,
    "error_message": null,
    "webhook_url": "https://your-server.com/hooks/kolayzeka",
    "created_at": "2026-06-29T12:00:00.000000Z",
    "updated_at": "2026-06-29T12:00:05.000000Z"
  },
  "success": true
}

3 · Başarısız

{
  "data": {
    "id": "9d1c…-uuid",
    "model": "flux1-dev-with-controlnets-and-loras-flux-general",
    "output_type": "image",
    "source": "api",
    "status": "failed",
    "input_data": {
      "prompt": "Prompt",
      "num_inference_steps": 28,
      "loras": "[]",
      "control_loras": "[]",
      "controlnets": "[]",
      "controlnet_unions": "[]",
      "ip_adapters": "[]",
      "easycontrols": "[]",
      "guidance_scale": 3.5,
      "real_cfg_scale": 3.5,
      "use_real_cfg": false,
      "use_cfg_zero": false,
      "num_images": 1,
      "enable_safety_checker": true,
      "reference_strength": 0.65,
      "reference_start": 0,
      "reference_end": 1,
      "base_shift": 0.5,
      "max_shift": 1.15,
      "output_format": "png",
      "use_beta_schedule": false,
      "scheduler": "euler",
      "nag_scale": 3,
      "nag_tau": 2.5,
      "nag_alpha": 0.25,
      "nag_end": 0.25
    },
    "output_data": null,
    "thumbnail_url": null,
    "credit_cost": 0,
    "duration": null,
    "estimated_seconds": 12,
    "error_message": "Sağlayıcı yoğun, lütfen tekrar deneyin.",
    "webhook_url": "https://your-server.com/hooks/kolayzeka",
    "created_at": "2026-06-29T12:00:00.000000Z",
    "updated_at": "2026-06-29T12:00:00.000000Z"
  },
  "success": true
}

Sonuç output_data.result alanındadır (imzalı URL, süreli: kalıcı tutmak için kendi depolamanıza indirin).
Medya URL'leri imzalıdır ve süresi dolar; eski bir URL için işi tekrar GET edin, taze URL gelir.
Geçmiş: GET https://kolayzeka.com/api/generations (en yeni önce, sayfa başına 20, ?page=).

Fiyat ve teklif

Fiyat kredi cinsindendir ve seçtiğiniz seçeneklere (kalite, boyut, süre, adet…) göre değişir. Varsayılan ayarlarla bu mod ≈ 67216 kredi.

POST

https://kolayzeka.com/api/models/flux1-dev-with-controlnets-and-loras-flux-general/quote

Çalıştırmadan, tam bu girdinin fiyatı. Token gerekmez; girdiyi üretimdeki gibi doğrular.

cURL

curl -X POST https://kolayzeka.com/api/models/flux1-dev-with-controlnets-and-loras-flux-general/quote \
  -H "Content-Type: application/json" \
  -d '{"input":{"prompt":"Prompt","num_inference_steps":28,"loras":"[]","control_loras":"[]","controlnets":"[]","controlnet_unions":"[]","ip_adapters":"[]","easycontrols":"[]","guidance_scale":3.5,"real_cfg_scale":3.5,"use_real_cfg":false,"use_cfg_zero":false,"num_images":1,"enable_safety_checker":true,"reference_strength":0.65,"reference_start":0,"reference_end":1,"base_shift":0.5,"max_shift":1.15,"output_format":"png","use_beta_schedule":false,"scheduler":"euler","nag_scale":3,"nag_tau":2.5,"nag_alpha":0.25,"nag_end":0.25},"category_id":15}'

Yanıt

{
  "success": true,
  "data": {
    "credits": 67216,
    "basis": "per_image",
    "exact": true,
    "mode": {
      "category_id": 15,
      "label": "Text to Image"
    }
  }
}

exact: false: fiyat çıktıya bağlı (ör. token, gerçek süre); teklif tipik değerle hesaplanır.
Kredi, istek kabul edilince teklif tutarı kadar ayrılır. İş bitince gerçek tutara göre fark düşülür ya da iade edilir; iş başarısız olursa tamamı iade edilir. Kesin tutar: sonuçtaki credit_cost.
Bakiye: GET https://kolayzeka.com/api/me → credit_balance. Yetmezse 402 insufficient_credits.

Girdi alanları

input içine gönderilir. Tip etiketi gönderilecek JSON değeridir (string, integer, number, boolean, url, array<url>). Aynı liste makine-okunur olarak GET https://kolayzeka.com/api/ai-models/flux1-dev-with-controlnets-and-loras-flux-general yanıtında.

prompt

zorunlu

string

Prompt · The prompt to generate an image from.

image_size

isteğe bağlı

string

Image Size · The size of the generated image.

Kabul edilen değerler:"square_hd""square""portrait_4_3""portrait_16_9""landscape_4_3""landscape_16_9"

num_inference_steps

isteğe bağlı

number

Num Inference Steps · The number of inference steps to perform.

Varsayılan: 28 (gönderilmezse bu kullanılır)

Sınırlar: en az 1 · en çok 50

seed

isteğe bağlı

number

Seed · The same seed and the same prompt given to the same version of the model will output the same image every time.

loras

isteğe bağlı

string

Loras · The LoRAs to use for the image generation. You can use any number of LoRAs and they will be merged together to generate the final image.