الانتقال إلى المحتوى الرئيسي
POST
/
bria
/
text-to-image
Generate Bria images
curl --request POST \
  --url https://api.cometapi.com/bria/text-to-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A paper boat floating on calm water at sunrise."
}
'
{
  "result": [
    {
      "urls": [
        "https://example.com/generated.png"
      ],
      "seed": 278741175,
      "uuid": "27c39b06-1dfe-11f1-ad57-6ac2c454c04d_278741175"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

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

  • تريد صورة نهائية في استدعاء واحد
  • لا تحتاج إلى masks أو مدخلات صور أو polling للمهام
  • تريد مسار 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[]
مطلوب