انتقل إلى المحتوى

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الاسمافتراضي
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

أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.

الحقلالدور
imageالصورة المرجعية.
additional_imagesصور مرجعية إضافية.

المزيد من نماذج الصور

واجهات API أخرى لإنشاء الصور على Mage

  • صورة · من 20 Gem

    HiDream API

    سريع ومتعدد الاستخدامات، مع أوصاف سلبية

  • صورة · من 20 Gem

    Krea 2 API

    جماليات رائعة في ثوانٍ

  • صورة · من 42 Gems

    واجهة Mango API

    عائلة الصور الرائدة لدينا

  • صورة · ابتداءً من 15 Gems

    MiniMax H3 Image API

    صور أصلية بدقة 16 ميغابكسل، بأوزان مفتوحة

  • صورة · من 25 Gems

    MOSS-Image API

    أوصاف طويلة ونصوص ثنائية اللغة، بأوزان مفتوحة

  • صورة · من 51 Gems

    واجهة Nano Banana 2 API

    نصوص واضحة ومقروءة حتى 4K

الأسئلة الشائعة

الأسئلة الشائعة

كم تبلغ تكلفة Guava API؟
يكلّف طلب Guava بالإعدادات الافتراضية (Guava) ‏37 Gems، أي نحو 0.037 دولار. يتغير السعر حسب الدقة والمدة والإصدارات الأخرى، وتعرض الاستجابة الرسوم الدقيقة. يُعاد المبلغ عند فشل التوليد، ولا يُعاد إذا حجبته سياسة المحتوى في Mage.
ما نقطة نهاية Guava API؟
أرسل طلب POST إلى https://api.mage.space/v1/guava/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة 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. كما يقبل الشخصيات والمراجع المحفوظة عبر @handle في الوصف النصي.
هل يمكنني استخدام Guava من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Guava بالاسم. يقرأ المساعد خياراته عبر get_model ويذكر السعر قبل التوليد.
ما مدة الاحتفاظ بنتائج Guava؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

Charactersالمجتمع