Image Generation

تولید تصویر از توصیف متنی. سازگار با OpenAI Images API.

اندپوینت

POSThttps://api.hooshgar.ir/v1/images/generations

پارامترها

پارامتر	نوع	اجباری	توضیح
model	string	بله	مثل gpt-image-1 یا dall-e-3.
prompt	string	بله	توصیف تصویر (تا چند هزار کاراکتر بسته به مدل).
n	integer	—	تعداد تصاویر خروجی.
size	string	—	‏1024x1024, 1024x1792, 1792x1024 (وابسته به مدل).
quality	string	—	standard یا hd.
style	string	—	vivid یا natural.
response_format	string	—	url یا b64_json.
user	string	—	شناسۀ کاربر نهایی.

نمونۀ درخواست

curl -X POST https://api.hooshgar.ir/v1/images/generations \
  -H "Authorization: Bearer YOUR_HOOSHGAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "یک قهوه‌خانۀ سنتی ایرانی در شب، نور گرم، سبک نقاشی آبرنگ",
    "size": "1024x1024",
    "n": 1
  }'

نمونۀ پاسخ

{
  "created": 1717000000,
  "data": [
    { "url": "https://cdn.example/1.png" }
  ]
}

نمونۀ Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.HOOSHGAR_API_KEY,
  baseURL: "https://api.hooshgar.ir/v1",
});

const r = await client.images.generate({
  model: "gpt-image-1",
  prompt: "یک بازار سنتی اصفهان از نمای بالا",
  size: "1024x1024",
});
console.log(r.data[0].url);

قابلیت‌ها در مدل‌های مختلف متفاوت است و نام مدل در نمونه‌ها فقط برای مثال است. پیش از استفاده، شناسهٔ دقیق مدل و قابلیت‌های آن را در کاتالوگ مدل‌های هوشگر بررسی کنید.