رفتن به محتوا

Ideogram V4.0q LoRA Trainer

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

شناسه مدل ideogram/v4/trainer
# 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/ideogram/v4/trainer?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images_data_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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
Ideogram · فایل

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

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

ساخت درخواست

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

•الزامی

URL فایل ZIP داده‌های آموزش شامل تصاویر و کپشن‌ها؛ هر کپشن در فایل .txt با همان نام پایه فایل تصویر ذخیره شده است. آموزش‌دهنده از مجموعه‌داده فقط هدف استفاده می‌کند که prepare_dataset_dir آماده می‌کند.

پیش‌فرض auto

ابعاد تصاویر آموزشی، به‌صورت پیش‌تنظیم، auto یا رشته سفارشی WIDTHxHEIGHT با ابعادی بخش‌پذیر بر 16. برش مرکزی هرگز تصاویر را بزرگ نمی‌کند؛ auto بزرگ‌ترین برش مشترک مجموعه‌داده را که به بزرگ‌نمایی نیاز ندارد انتخاب می‌کند. پیش‌تنظیم‌ها عبارت‌اند از 1024x1024 (مربع)، 1536x1024 (افقی)، 1024x1536 (عمودی)، 1920x1088 (عریض)، 2048x768 (فوق‌عریض)، 1024x1792 (phone_wallpaper) و 1584x400 (social_banner).

پیش‌فرض 1000

تعداد گام‌های آموزش LoRA.

پیشرفته default_caption · learning_rate

کپشنی که وقتی force_default_caption برابر true است روی همه تصاویر اعمال می‌شود و فایل‌های کپشن را نادیده می‌گیرد؛ در غیر این صورت فقط برای تصاویر فاقد فایل کپشن استفاده می‌شود.

پیش‌فرض 0.0001
POST /run/ideogram/v4/trainer?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/ideogram/v4/trainer?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images_data_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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

درباره Ideogram V4.0q LoRA Trainer

یک LoRA را با مجموعه‌داده خودتان برای شخصی‌سازی یا سبک خاص آموزش می‌دهد. `images_data_url` به zip تصاویر اشاره می‌کند؛ کپشن‌ها از فایل‌های .txt هم‌نام خوانده می‌شوند و `default_caption` موارد فاقد کپشن را پر می‌کند. `steps` از 100 تا 40000 (پیش‌فرض 1000) است و `learning_rate` و `resolution` قابل تنظیم‌اند. فایل وزن‌های LoRA و فایل پیکربندی را برمی‌گرداند.

پارامترها

نامنوع پیش‌فرضمجاز توضیحات
images_data_urlالزامی
نوعstring
URL فایل ZIP داده‌های آموزش شامل تصاویر و کپشن‌ها؛ هر کپشن در فایل .txt با همان نام پایه فایل تصویر ذخیره شده است. آموزش‌دهنده از مجموعه‌داده فقط هدف استفاده می‌کند که prepare_dataset_dir آماده می‌کند.
stepsاختیاری
نوعinteger
پیش‌فرض1000
۱۰۰ – ۴۰٬۰۰۰
تعداد گام‌های آموزش LoRA.
default_captionاختیاری
نوعstring | null
کپشنی که وقتی force_default_caption برابر true است روی همه تصاویر اعمال می‌شود و فایل‌های کپشن را نادیده می‌گیرد؛ در غیر این صورت فقط برای تصاویر فاقد فایل کپشن استفاده می‌شود.
resolutionاختیاری
نوعstring
پیش‌فرضauto
ابعاد تصاویر آموزشی، به‌صورت پیش‌تنظیم، auto یا رشته سفارشی WIDTHxHEIGHT با ابعادی بخش‌پذیر بر 16. برش مرکزی هرگز تصاویر را بزرگ نمی‌کند؛ auto بزرگ‌ترین برش مشترک مجموعه‌داده را که به بزرگ‌نمایی نیاز ندارد انتخاب می‌کند. پیش‌تنظیم‌ها عبارت‌اند از 1024x1024 (مربع)، 1536x1024 (افقی)، 1024x1536 (عمودی)، 1920x1088 (عریض)، 2048x768 (فوق‌عریض)، 1024x1792 (phone_wallpaper) و 1584x400 (social_banner).
learning_rateاختیاری
نوعnumber
پیش‌فرض0.0001
۰٫۰۰۰۰۰۱ – ۰٫۰۱
الزامی

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v4/trainer",
  "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": 6750,
    "usd": "6.75",
    "charged": 6750,
    "refunded": 0
  },
  "input": {
    "images_data_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "diffusers_lora_file": {
      "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
    },
    "config_file": {
      "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
    }
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "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 شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
diffusers_lora_file
object {url, content_type, file_name, file_size}URL وزن‌های LoRA برای Ideogram V4 که از آموزش تولید شده‌اند.
config_file
object {url, content_type, file_name, file_size}URL پیکربندی آموزش عمومی.

مدل‌های بیشتر: آموزش

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/ideogram/v4/trainer.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt