تصویر

ساخت تصویر

از روی یک توضیح متنی یک یا چند تصویر بسازید. قالب درخواست و پاسخ مانند OpenAI است و پاسخ نشانی تصویر یا داده‌ی base64 آن را برمی‌گرداند.

POST/v1/images/generations

هزینه به ازای هر تصویر حساب می‌شود، نه توکن. قیمت یک مدل ممکن است به size و quality بستگی داشته باشد؛ قیمت‌ها در مدل‌ها آمده‌اند. اگر مدل برای کیفیت‌های مختلف قیمت جدا دارد و quality نفرستید، medium به کار می‌رود. کیفیت xhigh و max فقط برای مدلی که قیمت جدا برای آن‌ها دارد پذیرفته می‌شود، وگرنه خطای invalid_quality می‌گیرید. با response_format: "url" در هر عنصر data فیلد url می‌آید و با b64_json خود تصویر به‌صورت base64. هر عنصر فقط فیلدهایی را دارد که مدل برگردانده است: url ، b64_json و revised_prompt . اگر مدل background ، output_format ، quality یا size را گزارش کند، همان‌ها هم در سطح بالای پاسخ می‌آیند. برای ویرایش یک تصویر موجود از /v1/images/edits استفاده کنید.

نمونه‌ها

curl https://1ai.ir/v1/images/generations \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "openai/gpt-image-2",
  "prompt": "A watercolor painting of a lighthouse at sunrise",
  "size": "1024x1024",
  "response_format": "url"
}'

200پاسخ

{
  "created": 1788864000,
  "model": "openai/gpt-image-2",
  "data": [
    {
      "url": "https://example.com/files/img_example.png"
    }
  ]
}

بدنه‌ی درخواست

modelstringالزامی
$شناسه‌ی مدل تصویر.$
promptstringالزامی
$توضیح تصویر، تا ۳۲٬۰۰۰ نویسه.$
ninteger
$تعداد تصویر، از ۱ تا ۱۰. هزینه به ازای هر تصویر است.$
sizestring
$اندازه‌ی تصویر، مثل 1024x1024 . مقدارهای مجاز به مدل بستگی دارد.$
qualitystring
$کیفیت تصویر. برای مدلی که قیمت جدا برای هر کیفیت دارد، بدون این فیلد medium به کار می‌رود.$
response_formatstring
$شکل برگشت تصویر.$
مقادیر مجاز:urlb64_json
stylestring
$سبک تصویر، برای مدل‌هایی که آن را می‌شناسند.$

خطاها

invalid_request400
بدنه معتبر نیست؛ مثلاً prompt خالی یا n بیشتر از ۱۰.
invalid_quality400
کیفیت xhigh یا max برای این مدل قیمت جدا ندارد (param: quality).
model_kind_mismatch400
مدل از دسته‌ی تصویر نیست.
provider_invalid_request400
مدل یکی از پارامترها را نپذیرفت؛ پارامترها را بررسی کنید.
insufficient_credits402
اعتبار برای این درخواست کافی نیست.
model_not_found404
مدل وجود ندارد یا به آن دسترسی ندارید.

ساخت تصویر

نمونه‌ها

بدنه‌ی درخواست

خطاها

صفحه‌های مرتبط