Mage API · نموذج صور
Guava API
واقعية فائقة تُشبه الصور الفوتوغرافية
POST https://api.mage.space/v1/guava/generateلمحة سريعة
تشغّل Guava API نموذج Guava و4 نسخ أخرى عبر Mage على POST https://api.mage.space/v1/guava/generate. يكلّف الطلب بالإعدادات الافتراضية 37 Gems (نحو $0.037) دون اشتراك. يستخدم Guava الشخصيات والمراجع المحفوظة عبر @handle في الوصف.
- صورةالمخرجات
- 5الإصدارات
- 37Gems لكل صورة، الافتراضي
- $0.037التكلفة التقريبية بالدولار
نظرة عامة
ما الذي تقدّمه Guava API
عائلة نماذجنا للواقعية الفائقة، للبورتريه والأزياء وصور المنتجات بملمس بشرة وقماش وإضاءة مطابقة للواقع. تقبل المراجع أو Characters، بدقة تصل إلى 2K.
عائلة نماذج Mage للواقعية الفوتوغرافية، مخصصة للبورتريه والأزياء وصور المنتجات التي تبدو كأنها صور حقيقية، مع دعم الصور المرجعية. Guava 2 وGuava 2 Pro هما الإصداران الحاليان.
يقبل الحقلين image وadditional_images كمدخلات.
بداية سريعة
استدعاء Guava API
اضبط 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
أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.
| الحقل | الدور |
|---|---|
| image | الصورة المرجعية. |
| additional_images | صور مرجعية إضافية. |
المزيد من نماذج الصور
واجهات API أخرى لإنشاء الصور على Mage
HiDream API
سريع ومتعدد الاستخدامات، مع أوصاف سلبية
Krea 2 API
جماليات رائعة في ثوانٍ
واجهة Mango API
عائلة الصور الرائدة لدينا
MiniMax H3 Image API
صور أصلية بدقة 16 ميغابكسل، بأوزان مفتوحة
MOSS-Image API
أوصاف طويلة ونصوص ثنائية اللغة، بأوزان مفتوحة
واجهة Nano Banana 2 API
نصوص واضحة ومقروءة حتى 4K
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Guava API؟
ما نقطة نهاية Guava API؟
ما نماذج Guava التي يمكنني استدعاؤها؟
هل يدعم Guava الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام Guava من Claude أو ChatGPT؟
ما مدة الاحتفاظ بنتائج Guava؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.