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 | نام | پیشفرض |
|---|---|---|
| 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
مقادیر مجاز برای همه نسخهها؛ ممکن است یک نسخه گزینههای کمتری داشته باشد. گزینههای هر نسخه در مستندات آمده است.
| فیلد | مقادیر |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
ورودیها
ورودیهای رسانهای که Guava میپذیرد
هرکدام را بهصورت URL با https، data URL یا آپلود تا 100 MB بفرستید.
| فیلد | نقش |
|---|---|
| image | تصویر مرجع. |
| additional_images | تصاویر مرجع اضافی. |
مدلهای تصویر بیشتر
سایر APIهای تولید تصویر در Mage
API HiDream
سریع و همهکاره، با پرامپت منفی
Krea 2 API
زیبایی خیرهکننده در چند ثانیه
Mango API
خانوادهی پرچمدار ما برای تصویر
Nano Banana 2 API
متن شفاف و خوانا، تا 4K
API مدل SDXL Plus
SDXL با چهره و دستهای اصلاحشده
Stable Diffusion v1.5 API
کلاسیک، با هزینهٔ کم
سؤالات متداول
سؤالات متداول
هزینهٔ API مدل Guava چقدر است؟
endpoint در API مدل Guava چیست؟
کدام مدلهای Guava را میتوانم فراخوانی کنم؟
آیا Guava از تصاویر مرجع یا شخصیتها پشتیبانی میکند؟
آیا میتوانم از Guava در Claude یا ChatGPT استفاده کنم؟
نتایج Guava تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.