الانتقال إلى المحتوى الرئيسي
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"
    }
  ]
}
أنشئ صورًا آمنة للاستخدام التجاري من Prompt نصي بسيط. في أول طلب لك على CometAPI، أرسل prompt، وأبقِ num_results على 1، وابدأ بـ aspect_ratio: "1:1" ما لم تكن تعرف بالفعل التخطيط النهائي الذي تحتاجه.

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

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

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

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

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

تصف الوثائق الرسمية لـ Bria مسار إنشاء أوسع وتناقش تدفقات الحالة غير المتزامنة. على CometAPI، يستخدم هذا المسار طلب JSON مبسطًا، وفي اختبارات smoke test الحالية أعاد مصفوفة result نهائية مباشرةً بدلًا من request_id مع status_url.
يقوم CometAPI بتمرير إمكانات Bria بدلًا من مطابقة API العامة الخاصة بـ 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. Current CometAPI smoke tests returned final results immediately without setting this field.

الاستجابة

200 - application/json

Image generation result.

​
result
object[]
مطلوب