با POST /images/generations از روی توصیف متنی تصویر میسازید: تصویر شاخص مقاله، بنر، طرح محصول، آیکون.
مدلهای ساخت تصویر گیسو از خانوادهٔ GPT Image هستند؛ فهرست کامل با GET /models?type=image میآید.
نمونه#
curl https://gisoo.pro/api/v1/images/generations \
-H "Authorization: Bearer $GISOO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-1-mini",
"prompt": "Flat illustration of a Persian tea glass on a wooden table, warm morning light, no text",
"size": "1024x1024",
"quality": "medium"
}' | jq -r '.data[0].b64_json' | base64 --decode > tea.png
import base64
from openai import OpenAI
client = OpenAI(base_url="https://gisoo.pro/api/v1", api_key="sk-gisoo-v1-...")
result = client.images.generate(
model="gpt-image-1-mini",
prompt="Flat illustration of a Persian tea glass on a wooden table, warm morning light, no text",
size="1024x1024",
quality="medium",
)
with open("tea.png", "wb") as f:
f.write(base64.b64decode(result.data[0].b64_json))
print(result.usage) # input / output tokens this image was billed for
import fs from "node:fs";
const result = await client.images.generate({
model: "gpt-image-1-mini",
prompt: "Flat illustration of a Persian tea glass on a wooden table, warm morning light, no text",
size: "1024x1024",
quality: "medium",
});
fs.writeFileSync("tea.png", Buffer.from(result.data[0].b64_json, "base64"));
<?php
$result = $client->images()->create([
'model' => 'gpt-image-1-mini',
'prompt' => 'Flat illustration of a Persian tea glass on a wooden table, warm morning light, no text',
'size' => '1024x1024',
'quality' => 'medium',
]);
file_put_contents('tea.png', base64_decode($result->data[0]->b64_json));
خروجی همیشه به شکل base64 در data[].b64_json میآید و نشانی اینترنتی (URL) برنمیگردد؛ فایل را همان لحظه ذخیره کنید. گیسو تصویرهای ساختهشده با API را نگه نمیدارد.
پارامترها#
gpt-image-1-mini.capabilities.sizes آن آمده است. رایج: 1024x1024، 1024x1536 (عمودی)، 1536x1024 (افقی).low، medium یا high؛ مدلهای تازهتر سطحهای بالاتر هم دارند (capabilities.quality). کیفیت بالاتر توکن خروجی بیشتری میبرد.transparent برای پسزمینهٔ شفاف (با خروجی png یا webp).png، jpeg یا webp.پسزمینهٔ شفاف#
result = client.images.generate(
model="gpt-image-1-mini",
prompt="A minimal gold coffee-cup icon, centered",
size="1024x1024",
quality="high",
background="transparent", # PNG with alpha — for logos and stickers
output_format="png",
)
هزینه#
مدلهای GPT Image توکنی قیمت دارند: توکنهای متن توصیف (ورودی) و توکنهای خود تصویر (خروجی). اندازه و کیفیت بزرگتر یعنی توکن خروجی بیشتر.
تعداد دقیق در usage پاسخ میآید و هزینه از همان حساب میشود. پیش از درخواست، برای هر تصویر مبلغی بهاندازهٔ یک تصویر کیفیت بالا کنار گذاشته میشود و بعد از پاسخ، فقط هزینهٔ واقعی کم میشود.
ایدهها را با quality: "low" امتحان کنید و فقط برای نسخهٔ نهایی کیفیت را بالا ببرید. تصویر پیشنویس کسری از هزینهٔ تصویر نهایی را دارد.
نوشتن توصیف خوب#
- موضوع، سبک، نور، قاب: «a flat illustration»، «soft studio light»، «top-down view».
- چیزی که نمیخواهید را بگویید: «no text»، «no watermark».
- متن فارسی داخل تصویر هنوز برای مدلها سخت است و ممکن است حروف بههمریخته شوند. متن را بعداً با ابزار طراحی روی تصویر بگذارید.
- برای تصویری که باید در چند اندازه تکرار شود، همان توصیف را نگه دارید و فقط
sizeرا عوض کنید.
سازندهٔ مدل درخواستهایی را که با سیاست محتواییاش جور نیست رد میکند (خطای 400 upstream_rejected). درخواست ردشده هزینهای ندارد.
پاسخ پرسشتان را پیدا نکردید؟
شناسهٔ درخواست (هدر X-Request-Id) را با پرسشتان در تیکت بفرستید تا دقیق بررسی کنیم.