FLUX.1 [dev] with Controlnets and Loras Flux General Inpainting
API kılavuzu ve entegrasyon referansı: uç nokta, girdi alanları, fiyatlar, webhook ve hatalar.
İstek ve yanıt
https://kolayzeka.com/api/models/flux1-dev-with-controlnets-and-loras-flux-general-inpainting/generateGö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-inpainting/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,
"image_url": "https://cdn.example.com/input.jpg",
"strength": 0.85,
"mask_url": "Mask Url"
},
"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-inpainting/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[strength]=0.85' \ -F 'input[mask_url]=Mask Url' \ -F 'input[fill_image]=@./fill_image.jpg' \ -F 'input[reference_image_url]=@./reference_image_url.jpg' \ -F 'input[image_url]=@./image_url.jpg' \ -F 'webhook_url=https://your-server.com/hooks/kolayzeka'
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-inpainting",
"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,
"image_url": "https://cdn.example.com/input.jpg",
"strength": 0.85,
"mask_url": "Mask Url"
},
"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-inpainting",
"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,
"image_url": "https://cdn.example.com/input.jpg",
"strength": 0.85,
"mask_url": "Mask Url"
},
"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-inpainting",
"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,
"image_url": "https://cdn.example.com/input.jpg",
"strength": 0.85,
"mask_url": "Mask Url"
},
"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.resultalanı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
GETedin, 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.
https://kolayzeka.com/api/models/flux1-dev-with-controlnets-and-loras-flux-general-inpainting/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-inpainting/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,"image_url":"https://cdn.example.com/input.jpg","strength":0.85,"mask_url":"Mask Url"}}'Yanıt
{
"success": true,
"data": {
"credits": 67216,
"basis": "per_image",
"exact": true,
"mode": {
"category_id": null,
"label": "Mod"
}
}
}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 402insufficient_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-inpainting yanıtında.
promptPrompt · The prompt to generate an image from.
image_sizeImage 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_stepsNum 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
seedSeed · The same seed and the same prompt given to the same version of the model will output the same image every time.
lorasLoras · 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.
Varsayılan: "[]" (gönderilmezse bu kullanılır)
control_lorasControl Loras · The LoRAs to use for the image generation which use a control image. You can use any number of LoRAs and they will be merged together to generate the final image.
Varsayılan: "[]" (gönderilmezse bu kullanılır)
controlnetsControlnets · The controlnets to use for the image generation. Only one controlnet is supported at the moment.
Varsayılan: "[]" (gönderilmezse bu kullanılır)
controlnet_unionsControlnet Unions · The controlnet unions to use for the image generation. Only one controlnet is supported at the moment.
Varsayılan: "[]" (gönderilmezse bu kullanılır)
ip_adaptersIp Adapters · IP-Adapter to use for image generation.
Varsayılan: "[]" (gönderilmezse bu kullanılır)
easycontrolsEasycontrols · EasyControl Inputs to use for image generation.
Varsayılan: "[]" (gönderilmezse bu kullanılır)
fill_imageFill image · Use an image input to influence the generation. Can be used to fill images in masked areas.
JSON'da herkese açık bir https URL gönderin, ya da dosyayı multipart ile yükleyin: -F 'input[fill_image]=@./dosya.jpg'
guidance_scaleGuidance scale (CFG) · The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you.
Varsayılan: 3.5 (gönderilmezse bu kullanılır)
Sınırlar: en az 0 · en çok 20
real_cfg_scaleReal CFG scale · The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you.
Varsayılan: 3.5 (gönderilmezse bu kullanılır)
Sınırlar: en az 0 · en çok 5
use_real_cfgUse Real CFG · Uses classical CFG as in SD1.5, SDXL, etc. Increases generation times and price when set to be true. If using XLabs IP-Adapter v1, this will be turned on!.
Varsayılan: false (gönderilmezse bu kullanılır)
use_cfg_zeroUse CFG-Zero-Init · Uses CFG-zero init sampling as in https://arxiv.org/abs/2503.18886.
Varsayılan: false (gönderilmezse bu kullanılır)
num_imagesNum Images · The number of images to generate. This is always set to 1 for streaming output.
Varsayılan: 1 (gönderilmezse bu kullanılır)
Sınırlar: en az 1 · en çok 10
enable_safety_checkerEnable Safety Checker · If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked, and images flagged as unsafe are returned as black images.
Varsayılan: true (gönderilmezse bu kullanılır)
reference_image_urlReference Image Url · URL of Image for Reference-Only
JSON'da herkese açık bir https URL gönderin, ya da dosyayı multipart ile yükleyin: -F 'input[reference_image_url]=@./dosya.jpg'
reference_strengthReference Strength · Strength of reference_only generation. Only used if a reference image is provided.
Varsayılan: 0.65 (gönderilmezse bu kullanılır)
Sınırlar: en az -3 · en çok 3
reference_startReference Start · The percentage of the total timesteps when the reference guidance is to bestarted.
Varsayılan: 0 (gönderilmezse bu kullanılır)
Sınırlar: en az 0 · en çok 1
reference_endReference End · The percentage of the total timesteps when the reference guidance is to be ended.
Varsayılan: 1 (gönderilmezse bu kullanılır)
Sınırlar: en az 0 · en çok 1
base_shiftBase Shift · Base shift for the scheduled timesteps
Varsayılan: 0.5 (gönderilmezse bu kullanılır)
Sınırlar: en az 0.01 · en çok 5
max_shiftMax Shift · Max shift for the scheduled timesteps
Varsayılan: 1.15 (gönderilmezse bu kullanılır)
Sınırlar: en az 0.01 · en çok 5
output_formatOutput Format · The format of the generated image.
Kabul edilen değerler:"jpeg""png"
Varsayılan: "png" (gönderilmezse bu kullanılır)
use_beta_scheduleUse Beta Schedule · Specifies whether beta sigmas ought to be used.
Varsayılan: false (gönderilmezse bu kullanılır)
sigma_scheduleSigma Schedule · Sigmas schedule for the denoising process.
schedulerScheduler · Scheduler for the denoising process.
Kabul edilen değerler:"euler""dpmpp_2m"
Varsayılan: "euler" (gönderilmezse bu kullanılır)
negative_promptNegative Prompt · Negative prompt to steer the image generation away from unwanted features. By default, we will be using NAG for processing the negative prompt.
nag_scaleNAG scale · The scale for NAG. Higher values will result in a image that is more distant to the negative prompt.
Varsayılan: 3 (gönderilmezse bu kullanılır)
Sınırlar: en çok 10
nag_tauNAG Tau · The tau for NAG. Controls the normalization of the hidden state. Higher values will result in a less aggressive normalization, but may also lead to unexpected changes with respect to the original image. Not recommended to change this value.
Varsayılan: 2.5 (gönderilmezse bu kullanılır)
nag_alphaNAG alpha · The alpha value for NAG. This value is used as a final weighting factor for steering the normalized guidance (positive and negative prompts) in the direction of the positive prompt. Higher values will result in less steering on the normalized guidance where lower values will result in considering the positive prompt guidance more.
Varsayılan: 0.25 (gönderilmezse bu kullanılır)
Sınırlar: en çok 1
nag_endProportion of steps to apply NAG · The proportion of steps to apply NAG. After the specified proportion of steps has been iterated, the remaining steps will use original attention processors in FLUX.
Varsayılan: 0.25 (gönderilmezse bu kullanılır)
Sınırlar: en çok 1
image_urlImage Url · URL of image to use for inpainting. or img2img
JSON'da herkese açık bir https URL gönderin, ya da dosyayı multipart ile yükleyin: -F 'input[image_url]=@./dosya.jpg'
strengthStrength · The strength to use for inpainting/image-to-image. Only used if the image_url is provided. 1.0 is completely remakes the image while 0.0 preserves the original.
Varsayılan: 0.85 (gönderilmezse bu kullanılır)
Sınırlar: en az 0.01 · en çok 1
mask_urlMask Url · The mask to area to Inpaint in.
Kimlik doğrulama
Her istekte Authorization: Bearer YOUR_API_TOKEN. Token'ı Profil sayfasında oluşturun. Katalog ve teklif (/ai-models, /quote) token istemez. Ayrıntılar: geliştirici rehberi.
Webhook
İsteğe bir webhook_url (https) ekleyin; iş bitince oraya imzalı bir POST gelir. Gövde { event, success, data }: data, durum endpoint'inin döndüğü nesnenin aynısıdır. Sorgulamaya gerek kalmaz; uzun işler (video, çok adımlı uygulamalar) için önerilir.
Gelen başlıklar
X-KolayZeka-Event: generation.completed // veya generation.failed
X-KolayZeka-Signature: sha256=<hex>
User-Agent: KolayZeka-Webhook/1.0
İmza = ham gövdenin, hesabınızın webhook imzalama anahtarı ile HMAC-SHA256'sı. Anahtarı Profil sayfasında oluşturun (bir kez gösterilir). Anahtar yoksa webhook gönderilmez.
Doğrulama · Node.js
import crypto from 'node:crypto';
// rawBody: the request body exactly as received (before JSON.parse).
const expected = 'sha256=' + crypto
.createHmac('sha256', process.env.KOLAYZEKA_WEBHOOK_SECRET)
.update(rawBody)
.digest('hex');
const given = req.headers['x-kolayzeka-signature'] ?? '';
if (given.length !== expected.length ||
!crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(given))) {
return res.status(401).end();
}Doğrulama · PHP / Laravel
$expected = 'sha256='.hash_hmac('sha256', $request->getContent(), config('services.kolayzeka.webhook_secret'));
abort_unless(hash_equals($expected, (string) $request->header('X-KolayZeka-Signature')), 401);- 2xx dönün. Diğer yanıtlar ve ağ hataları 30 sn arayla en çok 5 kez yeniden denenir.
- Aynı iş için birden fazla gelebilir:
data.idile tekilleştirin. - Özel / iç ağ / bulut-metadata adresleri reddedilir (422 invalid_webhook_url).
Hatalar
Her hata aynı şekildedir: { success: false, code, error, … }. Kodunuzu code'a göre yazın; error insan için mesajdır.
| HTTP | code | Ne zaman |
|---|---|---|
400 | invalid_mode | Modelin şu an çalıştırılabilir bir modu yok (geçici; başka model deneyin). |
401 | unauthenticated | Bearer token yok, geçersiz ya da iptal edilmiş. |
402 | insufficient_credits | Bakiye yetmiyor. Yanıtta balance (bakiye) ve required (gereken) var. |
403 | forbidden | Bu kaynağa erişim yetkiniz yok. |
404 | not_found | Model / uygulama / iş yok, aktif değil ya da size ait değil. |
405 | method_not_allowed | Endpoint bu HTTP metodunu kabul etmiyor. |
422 | validation_failed | Girdi şemaya uymuyor. errors alanı: alan → mesajlar. |
422 | invalid_webhook_url | webhook_url https değil, çözümlenmiyor ya da özel / iç ağ adresi. |
429 | rate_limited | Hız sınırı aşıldı. retry_after saniye sonra tekrar deneyin. |
500 | server_error | Beklenmeyen hata. Tekrar denemeden önce listeden (GET /api/generations) işin oluşup oluşmadığına bakın. |
402 örneği
{
"success": false,
"code": "insufficient_credits",
"error": "Yetersiz kredi. Bakiye: 40, Gerekli: 55",
"balance": 40,
"required": 55
}422 örneği
{
"success": false,
"code": "validation_failed",
"error": "Doğrulama başarısız oldu.",
"errors": {
"quality": [
"`quality` alanı şunlardan biri olmalıdır: low, medium, high."
]
}
}