Guava API

لمحة سريعة

تشغّل Guava API نموذج Guava و4 نسخ أخرى عبر Mage على POST https://api.mage.space/v1/guava/generate. يكلّف الطلب بالإعدادات الافتراضية 37 Gems (نحو $0.037) دون اشتراك. يستخدم Guava الشخصيات والمراجع المحفوظة عبر @handle في الوصف.

• صورة

  المخرجات

• 5

  الإصدارات

• 37

  Gems لكل صورة، الافتراضي

• $0.037

  التكلفة التقريبية بالدولار

نظرة عامة

ما الذي تقدّمه Guava API

عائلة نماذجنا للواقعية الفائقة، للبورتريه والأزياء وصور المنتجات بملمس بشرة وقماش وإضاءة مطابقة للواقع. تقبل المراجع أو Characters، بدقة تصل إلى 2K.

عائلة نماذج Mage للواقعية الفوتوغرافية، مخصصة للبورتريه والأزياء وصور المنتجات التي تبدو كأنها صور حقيقية، مع دعم الصور المرجعية. Guava 2 وGuava 2 Pro هما الإصداران الحاليان.

يقبل الحقلين image وadditional_images كمدخلات.

بداية سريعة

استدعاء Guava API

اضبط MAGE_API_KEY، وأرسل الطلب إلى /guava/generate، ثم كرّر الاستعلام عن status_url إلى أن يكتمل الطلب.

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"

// 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);

# 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 لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

الخيارات

معاملات Guava

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

المدخلات

المدخلات الوسائطية التي يقبلها Guava

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

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

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

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

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

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

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

ذات صلة

• واجهة API لتوليد الصور بالذكاء الاصطناعي
• مرجع Guava API
• مساحة تجربة Guava
• جميع نماذج API
• خادم Mage MCP