ساخت تصویر با API (images/generations)

ساخت و ویرایش تصویر با POST /v1/images/generations و SDK رسمی OpenAI: انتخاب خودکار مدل، تصویر مرجع، نسبت ابعاد، خروجی لینک یا base64 و قیمت تومانی.

به‌روزرسانی: ۱۲ مهر ۱۴۰۵

مسیر POST /v1/images/generations همان شکل OpenAI را دارد، پس client.images.generate بدون تغییر کار می‌کند. پاسخ هم‌زمان است: درخواست تا ساخته‌شدن تصویر باز می‌ماند (معمولاً چند ثانیه تا یک دقیقه).

Python

from openai import OpenAI

client = OpenAI(base_url="https://api.uttapen.ir/v1", api_key="sk-up-...")

img = client.images.generate(
    model="uttapen/auto-image",          # یا یک مدل مشخص، مثل bytedance-seed/seedream-4.5
    prompt="پوستر یک کافه با متن «قهوهٔ صبح» روی دیوار آجری، نور گرم",
    n=1,
)
print(img.data[0].url)                    # لینک امضاشده، ۲۴ ساعت

Node

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uttapen.ir/v1", apiKey: "sk-up-..." });

const img = await client.images.generate({ model: "uttapen/auto-image", prompt: "a ceramic cup on a wooden table, soft light" });
console.log(img.data[0].url);

ویرایش با تصویر مرجع

یک یا چند تصویر (حداکثر ۴، هرکدام تا ۱۰ مگابایت) را در image یا images بفرست؛ آدرس https یا data:image/…;base64. با uttapen/auto-image وقتی تصویر فرستاده باشی، مدل ویرایش انتخاب می‌شود. مدلی که ورودی تصویر نمی‌پذیرد 400 با param: "images" می‌دهد.

img = client.images.generate(
    model="uttapen/auto-image",
    prompt="پس‌زمینه را ساحل غروب کن",
    extra_body={"image": "https://example.com/product.jpg"},
)

فیلدها

فیلد	توضیح
`model`	شناسهٔ مدل؛ خالی یا `uttapen/auto-image` یعنی انتخاب خودکار
`prompt`	متن درخواست، حداکثر ۴٬۰۰۰ نویسه (فارسی و انگلیسی)
`n`	تعداد تصویر، ۱ تا ۴
`size` / `aspect_ratio` / `resolution` / `quality`	مثل `1024x1024`، `16:9`، `2K`، `high`؛ هر مدل بخشی را پشتیبانی می‌کند
`output_format`	`png`، `jpeg`، `webp`
`response_format`	`url` (پیش‌فرض) یا `b64_json`
`image` / `images`	تصویر مرجع برای ویرایش

پاسخ

{
  "created": 1791071431,
  "model": "bytedance-seed/seedream-4.5",
  "data": [{ "url": "https://api.uttapen.ir/v1/files/…/content?exp=…&sig=…", "mime_type": "image/png", "expires_at": "…" }],
  "uttapen": {
    "id": "01a1042d-…",
    "status": "completed",
    "cost_toman": "11605.000000",
    "hold_toman": "26186.439266",
    "requested_model": "uttapen/auto-image",
    "auto": { "intent": "photoreal", "reason": "تصویر عمومی و واقعی‌نما", "classifier": "llm" },
    "classifier_cost_toman": "11.227838"
  }
}

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

قیمت

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

هنوز کلید API نداری؟

با شماره موبایل ثبت‌نام کن، کیف پول را از ۱۰۰٬۰۰۰ تومان شارژ کن و کلید بساز. مدل‌های رایگان بدون شارژ هم کار می‌کنند — تا ۵۰ درخواست در روز. ساخت کلید API ←