Seedream چیست؟ راهنمای API سیدریم 4.5 و 5.0 از ایران

Seedream (سیدریم) خانوادهٔ مدل‌های ساخت و ویرایش تصویرِ ByteDance است که تیم Seed آن شرکت می‌سازد. با Seedream می‌توانی از یک توضیح متنی تصویر بسازی، یا عکسی را بفرستی و بگویی چه چیزی در آن عوض شود. اگر می‌خواهی این مدل را داخل سایت، اپ یا ربات خودت صدا بزنی، در یوتاپن چهار نسخه‌اش با همان SDK رسمی OpenAI در دسترس است: فقط base_url عوض می‌شود و هزینه از کیف پول تومانی کم می‌شود.

اینجا فقط دربارهٔ Seedream حرف می‌زنیم: هر نسخه برای چه کاری است، API سیدریم را چطور صدا بزنی، ویرایش با تصویر مرجع، و اینکه هزینهٔ هر تصویر از کجا می‌آید. اگر می‌خواهی Seedream را با بقیهٔ مدل‌های تصویر (FLUX، GPT Image، Recraft و...) مقایسه کنی، راهنمای کلی API ساخت عکس با هوش مصنوعی جای بهتری است.

Seedream چیست و چه فرقی با بقیه دارد

به گفتهٔ سازنده، Seedream را خود ByteDance ساخته است. ورودی‌اش متن و تصویر است و خروجی‌اش فقط تصویر. یعنی برخلاف خانوادهٔ نانو بنانای Google، کنار تصویر متنی برنمی‌گرداند. کارش یک چیز است: گرفتن پرامپت (و در صورت نیاز چند عکس مرجع) و تحویل تصویر.

دو ویژگی Seedream را برای برنامه‌نویس جذاب می‌کند:

• ساخت و ویرایش در یک مدل. همهٔ نسخه‌ها هم تصویر ورودی می‌گیرند و هم از صفر می‌سازند. لازم نیست برای «عوض کردن پس‌زمینهٔ عکس محصول» سراغ مدل جداگانه‌ای بروی.
• قیمت به‌ازای هر تصویر. هزینه به طول پرامپت یا توکن‌های استدلال بستگی ندارد، پس پیش از ساخت تقریباً می‌دانی هر تصویر چقدر تمام می‌شود. جزئیاتش پایین‌تر آمده.

در یوتاپن، حالت انتخاب خودکار (uttapen/auto-image) امروز برای تصویر عمومی، عکس واقعی‌نما، عکس محصول و تصویرسازی انیمه‌ای Seedream 4.5 را انتخاب می‌کند. نمونه‌هایی که در استودیو برای عکس غذا، معماری و محصول می‌بینی هم با همین مدل ساخته شده‌اند.

نسخه‌های Seedream: 4.5 و خانوادهٔ 5.0

چهار نسخهٔ Seedream در کاتالوگ قابل استفاده‌اند. ستون «به گفتهٔ سازنده» خلاصهٔ توضیحی است که ByteDance منتشر کرده و در کاتالوگ ما هست. رتبهٔ کیفیت یا عدد بنچمارک نمی‌دهیم، چون کیفیت تصویر به موضوع و سبک کار تو بستگی دارد.

فهرست کامل این نسخه‌ها و قیمت روز هرکدام در صفحهٔ مدل‌های تصویر آمده است.

کدام نسخهٔ Seedream را انتخاب کنم

بر اساس توضیح سازنده و قیمت‌گذاری امروز کاتالوگ:

• Seedream 4.5 برای شروع. همه‌منظوره است و حالت خودکار هم امروز همین را برمی‌دارد. اگر عکس محصول را ویرایش می‌کنی، تأکید سازنده روی «حفظ جزئیات سوژه» به کارت می‌آید.
• Seedream 5.0 Flash برای حجم بالا. پیش‌نویس، تست ایده، یا صدها تصویر برای کاتالوگ. در برآورد هر تصویر، امروز ارزان‌ترین نسخهٔ این خانواده است.
• Seedream 5.0 Lite وقتی پرامپتت پیچیده است. صحنه‌ای با چند جزء، دستور طولانی، یا موضوعی که مدل باید چیزی از دنیای واقعی بداند.
• Seedream 5.0 Pro برای خروجی نهایی تجاری. وقتی کنترل دقیق ویرایش و صحنهٔ واقعی‌نما مهم است. در برآورد هر تصویر گران‌ترین نسخه است و برای هر تصویر مرجع هم مبلغ جداگانه دارد.

روش عملی: یک پرامپت را اول با Flash یا 4.5 بساز و فقط اگر نتیجه راضی‌ات نکرد سراغ Pro برو. چون شناسهٔ مدل تنها چیزی است که عوض می‌شود، این مقایسه چند خط کد بیشتر نیست.

Seedream در کنار Nano Banana Pro

اگر بین Seedream و نانو بنانای Google مرددی، این جدول فقط واقعیت‌های کاتالوگ و مستندات را کنار هم می‌گذارد:

اگر کارت پوستر متن‌دار یا ویرایش با دستور چندمرحله‌ای است، راهنمای API نانو بنانا پرو را هم بخوان. برای عکس واقعی‌نما و تولید پرحجم، Seedream معمولاً انتخاب اقتصادی‌تری است.

API سیدریم در Python

مسیر POST /v1/images/generations همان شکل OpenAI را دارد، پس client.images.generate بدون تغییر کار می‌کند. پاسخ هم‌زمان است و درخواست تا ساخته شدن تصویر باز می‌ماند، معمولاً چند ثانیه تا یک دقیقه. فیلدهایی که SDK رسمی تعریف نکرده، مثل aspect_ratio، داخل extra_body می‌روند. کلید sk-up- را از صفحهٔ کلیدها بساز و در متغیر محیطی بگذار:

import os
import urllib.request
from openai import OpenAI

client = OpenAI(base_url="https://api.uttapen.ir/v1", api_key=os.environ["UTTAPEN_API_KEY"])

raw = client.images.with_raw_response.generate(
    model="bytedance-seed/seedream-4.5",
    prompt="سفرهٔ صبحانهٔ ایرانی با نان سنگک، پنیر، گردو و سبزی تازه، نور ملایم پنجره، عکاسی غذا",
    n=1,
    extra_body={"aspect_ratio": "16:9"},
)
img = raw.parse()

urllib.request.urlretrieve(img.data[0].url, "breakfast.png")   # لینک امضاشده، ۲۴ ساعت معتبر
print("هزینه:", raw.headers.get("X-Uttapen-Cost-Toman"), "تومان")

برای رفتن سراغ Seedream 5 فقط رشتهٔ model را عوض کن، مثلاً bytedance-seed/seedream-5-0-flash یا bytedance-seed/seedream-5-0-pro. باقی کد همان است.

همین درخواست با curl:

curl https://api.uttapen.ir/v1/images/generations \
  -H "Authorization: Bearer $UTTAPEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance-seed/seedream-4.5",
    "prompt": "Persian breakfast with flatbread, feta, walnuts and fresh herbs, soft window light, food photography",
    "n": 1,
    "aspect_ratio": "16:9"
  }'

پاسخ یک data[0].url دارد و یک بلوک uttapen با cost_toman (هزینهٔ نهایی همین ساخت) و hold_toman (مبلغی که پیش از ساخت رزرو شد و بلافاصله آزاد شد). اگر وسط کار اتصالت قطع شود، ساخت تمام می‌شود و نتیجه را با GET /v1/uttapen/media/{id} می‌گیری؛ شناسه در هدر X-Uttapen-Media-Id آمده. فایل‌ها ۳۰ روز روی سرور ما در ایران می‌مانند.

فیلدهای size، aspect_ratio، resolution، n (۱ تا ۴)، output_format و response_format همان‌هایی هستند که در مستندات ساخت تصویر آمده. مستندات صریح می‌گوید هر مدل بخشی از این فیلدها را پشتیبانی می‌کند، پس اول با یک تصویر تست کن و بعد در حلقه بگذار. ساخت ناموفق هزینه‌ای ندارد.

ویرایش عکس با Seedream و تصویر مرجع

نقطهٔ قوت Seedream 4.5، به گفتهٔ سازنده، ثبات در ویرایش است: سوژه را نگه می‌دارد و فقط چیزی را که خواسته‌ای عوض می‌کند. تصویر یا تصویرها در فیلد image یا images می‌روند، هرکدام یک آدرس https یا data:image/png|jpeg|webp;base64,...، هرکدام تا ۱۰ مگابایت. مستندات سقف ۴ تصویر مرجع در هر درخواست را می‌گوید.

img = client.images.generate(
    model="bytedance-seed/seedream-4.5",
    prompt="همین شیشهٔ عطر را روی سنگ تراورتن بگذار، نور صبح از پنجره، سایهٔ نرم، عکس تبلیغاتی",
    n=1,
    extra_body={
        "images": ["https://example.com/perfume.jpg"],
        "aspect_ratio": "1:1",
    },
)
print(img.data[0].url)

اگر عکس روی دیسک خودت است، با base64 به شکل data:image/jpeg;base64,... بفرستش. با چند تصویر مرجع می‌توانی اجزا را ترکیب کنی، مثلاً محصول و فضای مغازه، و در پرامپت بگویی هر کدام چه نقشی دارد. یادت باشد Seedream 5.0 Pro برای هر تصویر مرجع ورودی هم مبلغ جداگانه می‌گیرد.

هیچ مدلی تضمین نمی‌دهد همهٔ جزئیات دست‌نخورده بماند؛ گاهی رنگ کمی جابه‌جا می‌شود یا متن برچسب به هم می‌ریزد. اگر برای فروشگاه کار می‌کنی، چک‌لیست بررسی خروجی را در راهنمای ساخت عکس محصول فروشگاه با هوش مصنوعی نوشته‌ایم.

هزینهٔ API Seedream چطور حساب می‌شود

Seedream برخلاف نانو بنانا قیمت توکنی ورودی و خروجی ندارد. در فیلد pricing کاتالوگ (GET /v1/models) قیمت ورودی و خروجی متن صفر است و فقط یک جزء دارد: image_output، یعنی نرخ هر واحد توکن تصویر خروجی. سازنده قیمت هر تصویر را به این شکل منتشر می‌کند و هر تصویر Seedream تعداد ثابتی از این واحدها شمرده می‌شود. نتیجه در عمل همان «قیمت به‌ازای هر تصویر» است:

1. پرامپت بلندتر گران‌تر نیست. هزینهٔ متن ورودی صفر است.
2. هر تصویر تقریباً یک مبلغ دارد. در ساخت‌هایی که تا امروز با Seedream 4.5 ثبت شده، هزینهٔ یک تصویر به اندازهٔ خروجی بستگی نداشته است.
3. استثنا: تصویر مرجع در 5.0 Pro. این نسخه یک جزء image هم دارد که برای هر تصویر ورودی جداگانه حساب می‌شود. سه نسخهٔ دیگر چنین جزئی ندارند.

قیمت تومانی روز هر تصویر را روی صفحهٔ Seedream 4.5 و برای نسخه‌های 5.0 در فهرست مدل‌های تصویر ببین. این عدد با قیمت سازنده و نرخ ارز عوض می‌شود، برای همین اینجا نمی‌نویسیمش.

رزرو، بعد هزینهٔ واقعی

1. پیش از ساخت، مبلغی از کیف پول رزرو می‌شود. این رزرو از هزینهٔ معمول یک تصویر بیشتر است تا حاشیهٔ اطمینان داشته باشد. اگر موجودی کافی نباشد، خطای 402 با کد insufficient_balance می‌گیری و ساختی شروع نمی‌شود.
2. بعد از ساخت، فقط هزینهٔ واقعی‌ای که سازنده گزارش می‌کند کم می‌شود و بقیهٔ رزرو برمی‌گردد. عدد نهایی در uttapen.cost_toman و هدر X-Uttapen-Cost-Toman می‌آید.
3. ساخت ناموفق رایگان است. خطا، رد شدن درخواست به‌خاطر قوانین محتوا یا نرسیدن فایل، کل رزرو را آزاد می‌کند.

جزئیات کامل پرداخت، نگهداری فایل و خطاها در مستندات رسانه آمده.

امتحان Seedream بدون کد

اگر پیش از نوشتن کد می‌خواهی نسخه‌ها را روی پرامپت خودت مقایسه کنی، استودیوی یوتاپن همین کار را در مرورگر می‌کند: مدل را انتخاب می‌کنی، پیش از ساخت برآورد تومانی را می‌بینی، و بعد از ساخت فقط هزینهٔ واقعی کم می‌شود. اگر عکسی بفرستی، حالت خودکار امروز برای ویرایش سراغ Nano Banana 2 می‌رود؛ برای ویرایش با Seedream، مدل را خودت انتخاب کن. کیف پولش همان کیف پول API است. یک پرامپت را با 5.0 Flash و 4.5 بساز و cost_toman و کیفیت دو خروجی را کنار هم ببین.

سؤال‌های رایج

Seedream مال کدام شرکت است؟

Seedream را ByteDance می‌سازد و در کاتالوگ با نام سازندهٔ ByteDance Seed آمده است. برای همین شناسهٔ مدل‌ها در API با bytedance-seed/ شروع می‌شود.

api seedream را از ایران چطور صدا بزنم؟

کتابخانهٔ openai را نصب کن، base_url را https://api.uttapen.ir/v1 بگذار و کلید sk-up- را از متغیر محیطی بخوان. بعد client.images.generate را با model="bytedance-seed/seedream-4.5" صدا بزن. نه کارت ارزی لازم است و نه حساب جداگانه نزد سازنده؛ پرداخت از کیف پول تومانی است.

فرق Seedream 4.5 با Seedream 5 چیست؟

4.5 آخرین نسخهٔ نسل ۴ است و سازنده روی ثبات در ویرایش و حفظ جزئیات سوژه تأکید کرده. نسل 5.0 سه رده دارد: Flash سریع و کم‌هزینه برای حجم بالا، Lite برای پرامپت پیچیده و کار با دانش گسترده، و Pro برای تولید تجاری با کنترل دقیق ویرایش. جدول بالا جزئیات را دارد.

Seedream متن فارسی را داخل تصویر درست می‌نویسد؟

سازنده در توضیح هیچ‌کدام از نسخه‌ها دربارهٔ رندر متن فارسی چیزی نگفته و ما هم ادعایی نمی‌کنیم. اگر متن روی تصویر برایت مهم است، اول با یک تصویر تست کن؛ و اگر نتیجهٔ پرامپت فارسی راضی‌ات نکرد، همان را انگلیسی هم امتحان کن. حالت خودکار ما برای پوستر متن‌دار امروز سراغ Nano Banana 2 می‌رود، نه Seedream.

قیمت Seedream ثابت است؟

قیمت هر تصویر به طول پرامپت بستگی ندارد، ولی مبلغ تومانی آن با قیمت سازنده و نرخ ارز عوض می‌شود. عدد روز روی صفحهٔ هر مدل است و هزینهٔ دقیق هر ساخت در cost_toman پاسخ همان درخواست.

چند تصویر را هم‌زمان می‌شود ساخت؟

با n از ۱ تا ۴ در هر درخواست. بیش از ۳ ساخت هم‌زمان خطای 429 با کد too_many_active_jobs می‌دهد. برای حجم بالا درخواست‌ها را در صف بگذار و هدر Retry-After را رعایت کن.