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

Mage API · نموذج صور

HiDream API

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

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

لمحة سريعة

يشغّل HiDream API نموذج HiDream عبر Mage على POST https://api.mage.space/v1/hidream/generate. يكلّف الطلب بالإعدادات الافتراضية 20 Gems (نحو 0.02 دولار) دون أي اشتراك. لا يدعم HiDream إشارات @handle.

  • صورةالمخرجات
  • 1النسخة
  • 20Gems لكل صورة، الافتراضي
  • $0.02التكلفة التقريبية بالدولار

نظرة عامة

ما الذي يقدّمه HiDream API

نموذج عام سريع لتحويل النص إلى صورة مع وصف سلبي. مناسب للأوصاف اليومية، سواء بأسلوب واقعي أو مرسوم.

نموذج صور عام وسريع مع وصف سلبي، بأسلوب واقعي أو مرسوم.

يُنشئ الصورة من الوصف النصي فقط.

بداية سريعة

استدعاء HiDream API

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/hidream/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": "hidream-fast"
}' | 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('hidream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'hidream-fast',
});

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

mage = Mage()  # reads MAGE_API_KEY

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

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

النماذج

قيم model_id في HiDream

أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

model_idالاسمافتراضي
hidream-fastHiDreamنعم

الخيارات

معاملات HiDream

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

الحقلالقيم
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

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

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

  • صورة · من 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

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

    SDXL Plus API

    SDXL بوجوه وأيدٍ مصحّحة

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

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

كم تبلغ تكلفة HiDream API؟
يكلّف طلب HiDream بالإعدادات الافتراضية (HiDream) ‏20 Gems، أي نحو 0.02 دولار. يتغير السعر حسب الدقة والمدة والإصدارات الأخرى، وتعرض الاستجابة الرسوم الدقيقة. يُعاد المبلغ عند فشل التوليد، ولا يُعاد إذا حجبته سياسة المحتوى في Mage.
ما نقطة نهاية HiDream API؟
أرسل طلب POST إلى https://api.mage.space/v1/hidream/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url للاستعلام عن النتيجة.
ما نماذج HiDream التي يمكنني استدعاؤها؟
hidream-fast. النموذج الافتراضي هو HiDream.
هل يدعم HiDream الصور المرجعية أو الشخصيات؟
لا يقبل HiDream مدخلات الصور أو الفيديو أو الصوت، ولا يدعم إشارات @handle.
هل يمكنني استخدام HiDream من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب HiDream بالاسم. يقرأ المساعد خياراته عبر get_model ويذكر السعر قبل التوليد.
ما مدة الاحتفاظ بنتائج HiDream؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

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

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

Charactersالمجتمع