Skip to main content
POST
cURL
أنشئ صورًا آمنة للاستخدام التجاري انطلاقًا من Prompt نصي بسيط. لأول طلب على CometAPI، أرسل prompt، وأبقِ num_results على 1، وابدأ بـ aspect_ratio: "1:1" ما لم تكن تعرف بالفعل التخطيط النهائي الذي تحتاجه.

استخدم هذا المسار عندما

  • تريد صورة نهائية في استدعاء واحد
  • لا تحتاج إلى أقنعة أو مدخلات صور أو استطلاع حالة المهمة
  • تريد مسار Bria فوتوغرافيًا واقعيًا يكون أسهل في التشغيل عبر CometAPI

ابدأ بهذا الطلب

  • اجعل الـ Prompt قصيرًا ومحددًا
  • استخدم num_results: 1 في طلبك الأول
  • ابدأ بـ aspect_ratio: "1:1" ما لم يكن التخطيط المستهدف محددًا بالفعل
  • نزّل عناوين URL المعادة بسرعة إذا كنت تحتاج إلى احتفاظ طويل

سلوك الاستجابة على CometAPI

تصف الوثائق الرسمية لـ Bria مسار إنشاء أوسع وتناقش تدفقات الحالة غير المتزامنة. على CometAPI، يستخدم هذا المسار طلب JSON مبسّطًا ويعيد مصفوفة result نهائية فورًا بدلًا من request_id مع status_url.
يقوم CometAPI بتمرير قدرات Bria بدلًا من مطابقة واجهة Bria العامة حقلًا بحقل. استخدم بنيات الطلب والاستجابة المعروضة في مرجع API وPlayground في هذه الصفحة كمصدر الحقيقة لعملية التكامل.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
prompt
string
مطلوب

English text prompt for image generation.

مثال:

"A paper boat floating on calm water at sunrise."

num_results
integer
افتراضي:1

Number of images to generate. Use 1 for the simplest integration test.

aspect_ratio
enum<string>
افتراضي:1:1

Requested output aspect ratio.

الخيارات المتاحة:
1:1,
2:3,
3:2,
3:4,
4:3,
4:5,
5:4,
9:16,
16:9
seed
integer

Optional seed for reproducible results.

negative_prompt
string

Optional exclusions for the generated image.

steps_num
integer
افتراضي:30

Optional refinement step count.

text_guidance_scale
integer
افتراضي:5

Optional prompt adherence setting.

medium
enum<string>

Optional visual medium.

الخيارات المتاحة:
photography,
art
prompt_enhancement
boolean
افتراضي:false

Optional prompt enhancement switch.

enhance_image
boolean
افتراضي:false

Optional image detail enhancement switch.

prompt_content_moderation
boolean
افتراضي:false

Optional moderation switch.

ip_signal
boolean
افتراضي:false

Optional IP warning flag.

sync
boolean
افتراضي:false

Optional sync hint. CometAPI returns final results immediately without setting this field.

الاستجابة

200 - application/json

Image generation result.

result
object[]
مطلوب