واجهة API لتوليد الصور بالذكاء الاصطناعي لكل النماذج

لمحة سريعة

واجهة Mage لتوليد الصور هي واجهة REST API على https://api.mage.space/v1 تشغّل 15 نموذجًا لتحويل النص إلى صورة وتعديل الصور، منها Mango 3 وGuava 2 Pro وGPT Image 2.5 وNano Banana 2 وFlux 2 وKrea 2. ترسل prompt عبر POST إلى /{model}/generate، ثم تتابع الطلب وتنزّل الصورة. يُدفع ثمن كل صورة بـ Gems، دون اشتراك.

• 15

  نماذج صور

• $0.009

  أرخص سعر افتراضي لكل صورة

• 20

  عمليات توليد متزامنة

• $0

  الرسوم الشهرية

النماذج

كل نماذج الصور في Mage API

الأسعار لكل عملية توليد، بـ Gems. يكلّف 1,000 Gems دولارًا واحدًا في الباقة القياسية، وتضيف الباقات الأكبر Gems إضافية. يعتمد السعر على النموذج والدقة والمدة؛ ويظهر السعر بالإعدادات الافتراضية، وتوضح كل استجابة الرسوم الدقيقة في billing.gems_charged. تُسترد تكلفة عملية التوليد الفاشلة، أما التي تحظرها سياسة المحتوى في Mage فلا تُسترد.

بداية سريعة

ولّد صورة باستخدام Anima v1

عيّن MAGE_API_KEY، وأرسل الطلب، ثم تابعه حتى يكتمل. استبدل anima في الرابط بأي نموذج من النماذج أعلاه.

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

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

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

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

كيف يعمل

من مفتاح API إلى وسائط جاهزة في ثلاث طلبات

تشترك جميع النماذج في نظام مصادقة واحد، ودورة طلب غير متزامنة واحدة، وأسماء الحقول نفسها.

1. 01

   أنشئ مفتاح API

   سجّل الدخول إلى Mage، وافتح API ← API Keys، وأنشئ مفتاحًا. يبدأ بـ mage_sk_ ويظهر مرة واحدة فقط. يمكن للحساب الواحد الاحتفاظ بـ 10 مفاتيح نشطة.

2. 02

   أرسل طلب توليد

   أرسل طلب POST بجسم JSON إلى https://api.mage.space/v1/{model}/generate مع ترويسة Authorization: Bearer. تعود الاستجابة فورًا مع request_id وstatus وstatus_url. أضف ترويسة Idempotency-Key حتى لا تدفع مرتين عند إعادة المحاولة.

3. 03

   تحقّق ثم نزّل

   استعلم عن status_url إلى أن تصبح الحالة completed أو failed أو cancelled. يحتوي الطلب المكتمل على result.url الذي يشير إلى ملف الصورة أو الفيديو أو الصوت، ويُحفظ لمدة 30 يومًا.

جاهزة للإنتاج

ما يحصل عليه كل طلب إلى Mage API

حالات الاستخدام

ما يبنيه المطورون باستخدام واجهة الصور

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

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

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

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

ذات صلة

• واجهة API لتوليد الفيديو بالذكاء الاصطناعي
• واجهة API لتوليد الصوت بالذكاء الاصطناعي
• خادم Mage MCP
• حزم Mage SDK
• Mage لـ ComfyUI
• جميع نماذج API
• ساحة تجربة API
• وثائق API