Flux إنشاء الصور

استدعِ POST /flux/v1/ لإنشاء صور Flux من خلال prompts وتتبع الحالة عبر get_result قبل انتهاء صلاحية الروابط.

POST /flux/v1/{model}

flux generate image

cURL

curl --request POST \
  --url https://api.cometapi.com/flux/v1/{model} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Hello"
}
'

200

{
  "id": "<string>",
  "polling_url": "<string>"
}

​

نظرة عامة

تقوم نقطة النهاية /flux/v1/\{model\} بإنشاء صور عالية الجودة من prompts النصية باستخدام عائلة نماذج Flux من Black Forest Labs. ما عليك سوى تبديل اسم النموذج في مسار URL للتنقل بين متغيرات Flux المختلفة.

نظرًا إلى وجود اختلافات كبيرة في قوائم المعلمات بين نماذج سلسلة Flux، يُرجى الرجوع إلى الوثائق الرسمية للحصول على تعليمات استخدام مفصلة. قائمة المعلمات المقدمة هنا هي للمرجع فقط.

بعد الإنشاء، استخدم نقطة النهاية /flux/v1/get_result للاستعلام عن الصور المُنشأة أو مراقبة حالة العملية.

تنتهي صلاحية روابط الصور التي تُرجعها خدمة BFL خلال حوالي 10 دقائق. احفظ النتائج المُنشأة على الفور.

التفويضات

Authorization · string · header · مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

Content-Type · string

Must be application/json.

معلمات المسار

model · string · مطلوب

Flux model variant to use, e.g. flux-pro-1.1, flux-pro, flux-dev, flux-pro-1.1-ultra.

الجسم

application/json

prompt · string · افتراضي: Hello · مطلوب

Text prompt describing the image to generate.

image_prompt · string

URL of a reference image to guide the generation style or content.

width · integer

Output image width in pixels. Must be a multiple of 32. Range varies by model.

height · integer

Output image height in pixels. Must be a multiple of 32. Range varies by model.

steps · integer

Number of diffusion steps. Higher values improve quality but increase latency.

prompt_upsampling · boolean

When true, automatically enhances the prompt for more detailed results.

seed · integer

Random seed for reproducible outputs. Omit for random generation.

guidance · number

Guidance scale controlling how closely the output follows the prompt. Higher values increase prompt adherence.

safety_tolerance · integer

Safety filter tolerance level. Higher values are more permissive. Range: 0–6.

interval · integer

Diversity interval. Higher values produce more varied outputs at the cost of prompt adherence.

output_format · string

Output image format. Supported values: jpeg, png.

webhook_url · string

URL to receive a POST notification when the task completes.

webhook_secret · string

Secret string included in webhook payloads for request verification.

الاستجابة

200 - application/json

OK

id · string

polling_url · string