رفتن به محتوا

Bria Text-to-Image HD

یکپارچه‌سازی

شناسه مدل bria/text-to-image/hd
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bria/text-to-image/hd?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

این درخواست: ⁨‎$۰٫۱۶⁩ ۱۶۰ اعتبار API اجرای آن در این صفحه

دریافت کلید API
Bria AI · تصویر

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی

پرامپت متنی برای هدایت تولید تصویر.

aspect_ratio پیش‌فرض 1:1

نسبت ابعاد خروجی برای تولید بدون راهنمایی؛ روش راهنمایی در عوض نسبت را از تصویر راهنمای خود می‌گیرد و این تنظیم را نادیده می‌گیرد.

num_images پیش‌فرض 4

تعداد تصویر درخواستی؛ هرگاه از هر روش راهنمایی استفاده شود، به 1 تغییر می‌کند.

پیشرفته negative_prompt · medium · num_inference_steps · guidance_scale · seed · prompt_enhancement · guidance
پیش‌فرض

پرامپت متنی منفی برای تولید تصویر.

medium

رسانه مورد استفاده در تصاویر تولیدشده. برای انتخاب خودکار رسانه، آن را تنظیم نکنید یا null قرار دهید.

پیش‌فرض 30

تعداد اختیاری تکرارهای مدل برای پالایش تصویر خروجی.

پیش‌فرض 5

میزان پایبندی به پرامپت برای انتخاب تصویر، بیان‌شده به‌صورت CFG (Classifier Free Guidance).

seed برای تصاویر تکرارپذیر: پرامپت و seed یکسان، در صورت ثابت‌بودن نسخه مدل، تصویر یکسانی تولید می‌کنند.

پیش‌فرض []

تصاویر راهنمای تولید، ارائه‌شده با روش‌هایی که می‌توانند در یک inference ترکیب شوند؛ حداکثر 4 روش مجاز است.

POST /run/bria/text-to-image/hd?wait=20 قیمت → ⁨‎$۰٫۱۶⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bria/text-to-image/hd?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره Bria Text-to-Image HD

مدل تبدیل متن به تصویر برای نتایج HD که نسبت به گونهٔ سریع از برنامهٔ پالایش طولانی‌تری استفاده می‌کند: `num_inference_steps` از 20 تا 50 است و مقدار پیش‌فرض آن 30 است. در هر درخواست 1 تا 4 تصویر تولید می‌کند و `negative_prompt`، `seed`، `guidance_scale` از 0 تا 20، نه نسبت تصویر و `medium` با مقدار photography یا art را می‌پذیرد. حداکثر 4 روش هدایت را می‌توان ترکیب کرد.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
پرامپت متنی برای هدایت تولید تصویر.
negative_promptاختیاری
نوعstring
پیش‌فرض
پرامپت متنی منفی برای تولید تصویر.
num_imagesاختیاری num_outputs
نوعinteger
پیش‌فرض4
۱ – ۴
تعداد تصویر درخواستی؛ هرگاه از هر روش راهنمایی استفاده شود، به 1 تغییر می‌کند.
aspect_ratioاختیاری
نوعenum
پیش‌فرض1:1
1:12:33:23:44:34:55:49:1616:9
نسبت ابعاد خروجی برای تولید بدون راهنمایی؛ روش راهنمایی در عوض نسبت را از تصویر راهنمای خود می‌گیرد و این تنظیم را نادیده می‌گیرد.
seedاختیاری
نوعinteger | null
۰ – ۲٬۱۴۷٬۴۸۳٬۶۴۷
seed برای تصاویر تکرارپذیر: پرامپت و seed یکسان، در صورت ثابت‌بودن نسخه مدل، تصویر یکسانی تولید می‌کنند.
num_inference_stepsاختیاری
نوعinteger
پیش‌فرض30
۲۰ – ۵۰
تعداد اختیاری تکرارهای مدل برای پالایش تصویر خروجی.
guidance_scaleاختیاری
نوعnumber
پیش‌فرض5
۰ – ۲۰
میزان پایبندی به پرامپت برای انتخاب تصویر، بیان‌شده به‌صورت CFG (Classifier Free Guidance).
prompt_enhancementاختیاری
نوعboolean
پیش‌فرضfalse
کلید بهبود پرامپت: true با گسترش پرامپت ارائه‌شده به گونه‌های بیشتر با توصیف‌های غنی‌تر، تصاویر متنوع‌تر و خلاقانه‌تری تولید می‌کند.
mediumاختیاری
نوعenum
photographyart
رسانه مورد استفاده در تصاویر تولیدشده. برای انتخاب خودکار رسانه، آن را تنظیم نکنید یا null قرار دهید.
guidanceاختیاری
نوعobject[]
پیش‌فرض[]
تصاویر راهنمای تولید، ارائه‌شده با روش‌هایی که می‌توانند در یک inference ترکیب شوند؛ حداکثر 4 روش مجاز است.
guidance[].image_urlالزامی
نوعurl · image
تصویر راهنمای رمزگذاری‌شده به‌صورت Base64 برای روش مشخص‌شده با guidance_method_1؛ هرگاه guidance_method_1 انتخاب شود، تصویر الزامی است. قالب‌های پشتیبانی‌شده: jpeg، jpg، png، webp؛ حداکثر اندازه 12 MB است. هنگام ترکیب روش‌های راهنمایی، همه تصاویر راهنما باید نسبت ابعاد یکسانی داشته باشند که نسبت ابعاد خروجی را نیز تعیین می‌کند.
guidance[].methodاختیاری
نوعenum
controlnet_cannycontrolnet_depthcontrolnet_recoloringcontrolnet_color_grid
نوع راهنمایی اختیاری برای تولید. یک inference می‌تواند حداکثر 4 روش راهنمایی را ترکیب کند.
guidance[].scaleاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱
شدت اثر راهنمایی.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/text-to-image/hd",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 160,
    "usd": "0.16",
    "charged": 160,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
images
array of object {url, content_type, file_name, file_size, width, height}تصاویر تولیدشده توسط مدل.
seed
integerSeed اعمال‌شده هنگام تولید.

مدل‌های بیشتر: متن به تصویر

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/bria/text-to-image/hd.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt