لمحة سريعة
يشغّل HiDream API نموذج HiDream عبر Mage على POST https://api.mage.space/v1/hidream/generate. يكلّف الطلب بالإعدادات الافتراضية 20 Gems (نحو 0.02 دولار) دون أي اشتراك. لا يدعم HiDream إشارات @handle.
صورة
المخرجات
1
النسخة
20
Gems لكل صورة، الافتراضي
$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-fast | HiDream | نعم |
الخيارات
معاملات HiDream
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
المزيد من نماذج الصور
واجهات API أخرى لإنشاء الصور على Mage
صورة · من 20 Gem
Krea 2 API
جماليات رائعة في ثوانٍ
صورة · من 135 Gems
واجهة Mango API
عائلة الصور الرائدة لدينا
صورة · من 68 Gems
واجهة Nano Banana 2 API
نصوص واضحة ومقروءة حتى 4K
صورة · ابتداءً من 15 Gems
SDXL Plus API
SDXL بوجوه وأيدٍ مصحّحة
صورة · من 10 Gems
Stable Diffusion v1.5 API
النموذج الكلاسيكي بتكلفة منخفضة
صورة · من 10 Gems
Stable Diffusion v3.5 Large API
نسخة Stable Diffusion الأكثر التزامًا بالوصف
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة 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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.