Mage API · نموذج صور

HiDream API

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

احصل على مفتاح APIجرّب HiDream في مساحة التجربة
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.

نظرة عامة

ما الذي يقدّمه 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

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

صورة · من 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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

احصل على مفتاح APIجرّب HiDream في مساحة التجربة

ذات صلة