رفتن به محتوا

API مج · مدل تصویر

API مدل Guava

فوتورئالیسمی که با عکس واقعی اشتباه گرفته می‌شود

POST https://api.mage.space/v1/guava/generate

در یک نگاه

API مدل Guava، مدل Guava و ۴ نسخه دیگر را از طریق Mage در POST https://api.mage.space/v1/guava/generate اجرا می‌کند. یک درخواست با تنظیمات پیش‌فرض 37 Gems (حدود $0.037) هزینه دارد، بدون اشتراک. Guava کاراکترها و مرجع‌های ذخیره‌شده را با @handle در پرامپت دریافت می‌کند.

  • تصویرخروجی
  • 5نسخه‌ها
  • 37Gems برای هر تصویر، پیش‌فرض
  • $0.037حدود، به دلار

نگاه کلی

API مدل Guava چه کاری انجام می‌دهد

خانواده فوتورئالیسم ما برای پرتره، مد و عکس محصول، با پوست، پارچه و نور کاملاً واقعی. مرجع یا Characters را می‌پذیرد، تا 2K.

خانوادهٔ مدل‌های فوتوریالیستی Mage برای پرتره، مد و عکس محصول که شبیه عکس واقعی‌اند، با پشتیبانی از تصاویر مرجع. Guava 2 و Guava 2 Pro جدیدترین جفت این خانواده‌اند.

image و additional_images را به‌عنوان ورودی می‌پذیرد.

شروع سریع

فراخوانی API مدل Guava

MAGE_API_KEY را تنظیم کنید، درخواست را به /guava/generate بفرستید و status_url را بررسی کنید تا درخواست کامل شود.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/guava/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "guava"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('guava', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'guava',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("guava", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "guava",
})

print(request["result"]["url"])

مدل‌ها

مقادیر model_id در Guava

برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیش‌فرض را اجرا می‌کند.

model_idنامپیش‌فرض
guavaGuavaبله
guava-proGuava Pro
guava-pro-v1-5Guava Pro 1.5
guava-2Guava 2
guava-2-proGuava 2 Pro

گزینه‌ها

پارامترهای Guava

مقادیر مجاز برای همه نسخه‌ها؛ ممکن است یک نسخه گزینه‌های کمتری داشته باشد. گزینه‌های هر نسخه در مستندات آمده است.

فیلدمقادیر
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K

ورودی‌ها

ورودی‌های رسانه‌ای که Guava می‌پذیرد

هرکدام را به‌صورت URL با https، data URL یا آپلود تا 100 MB بفرستید.

فیلدنقش
imageتصویر مرجع.
additional_imagesتصاویر مرجع اضافی.

مدل‌های تصویر بیشتر

سایر API‌های تولید تصویر در Mage

  • تصویر · از 20 Gems

    API HiDream

    سریع و همه‌کاره، با پرامپت منفی

  • تصویر · از 20 Gems

    Krea 2 API

    زیبایی خیره‌کننده در چند ثانیه

  • تصویر · از ۱۳۵ Gem

    Mango API

    خانواده‌ی پرچم‌دار ما برای تصویر

  • تصویر · از ۵۱ Gem

    Nano Banana 2 API

    متن شفاف و خوانا، تا 4K

  • تصویر · از 15 Gems

    API مدل SDXL Plus

    SDXL با چهره و دست‌های اصلاح‌شده

  • تصویر · از 10 Gems

    Stable Diffusion v1.5 API

    کلاسیک، با هزینهٔ کم

سؤالات متداول

سؤالات متداول

هزینهٔ API مدل Guava چقدر است؟
یک درخواست Guava با تنظیمات پیش‌فرض (Guava) 37 Gems هزینه دارد، حدود 0.037 دلار. رزولوشن، مدت و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ هزینهٔ دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه برگردانده می‌شود؛ اما اگر سیاست محتوایی Mage آن را مسدود کند، برگردانده نمی‌شود.
endpoint در API مدل Guava چیست؟
POST https://api.mage.space/v1/guava/generate را با هدر Authorization: Bearer که کلید API شما در Mage را دارد فراخوانی کنید. پاسخ شامل status_url است تا نتیجه را با آن بررسی کنید.
کدام مدل‌های Guava را می‌توانم فراخوانی کنم؟
guava (Guava)، guava-pro (Guava Pro)، guava-pro-v1-5 (Guava Pro 1.5)، guava-2 (Guava 2)، guava-2-pro (Guava 2 Pro). پیش‌فرض Guava است.
آیا Guava از تصاویر مرجع یا شخصیت‌ها پشتیبانی می‌کند؟
Guava ورودی‌های image و additional_images را می‌پذیرد. Guava شخصیت‌ها و مرجع‌های ذخیره‌شده را با @handle در پرامپت دریافت می‌کند.
آیا می‌توانم از Guava در Claude یا ChatGPT استفاده کنم؟
بله. سرور Mage MCP را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Guava را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج Guava تا چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.