Mage API · نموذج صور

Chroma API

مفتوح الأوزان، مبني على Flux

احصل على مفتاح APIجرّب Chroma في ساحة التجربة
POST https://api.mage.space/v1/chroma/generate

لمحة سريعة

تشغّل Chroma API نموذج Chroma عبر Mage على POST https://api.mage.space/v1/chroma/generate. يكلّف الطلب بالإعدادات الافتراضية 35 Gem (نحو 0.035 دولار) دون اشتراك. لا يقبل Chroma الإشارات بـ @handle.

نظرة عامة

ماذا تفعل واجهة Chroma API

نموذج صور عام مفتوح الأوزان على بنية Flux. تحويل النص إلى صورة، مع تحكّم كامل في الخطوات والتوجيه.

نموذج صور عام الاستخدام مفتوح الأوزان على بنية Flux.

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

بداية سريعة

استدعاء Chroma API

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

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

النماذج

قيم model_id لنموذج Chroma

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

model_idالاسمافتراضي
chroma-v1-hdChromaنعم

الخيارات

معاملات Chroma

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

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

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

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

صورة · من 40 Gems

واجهة Flux 2 API

أوامر طويلة وتعديلات بمراجع متعددة

صورة · من 9 Gems

واجهة GPT Image 2 API

أوامر دقيقة ونصوص مقروءة

صورة · من 75 Gem

Grok Image API

Grok Imagine بثلاثة مستويات جودة

صورة · من 37 Gems

واجهة Guava API

واقعية فائقة تبدو كصورة فوتوغرافية

صورة · من 20 Gem

HiDream API

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

صورة · من 20 Gem

Krea 2 API

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

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

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

كم تبلغ تكلفة Chroma API؟

يكلّف طلب Chroma بالإعدادات الافتراضية (Chroma) ‏35 Gems، أي نحو 0.035 دولار. يتغيّر السعر باختلاف الدقة والمدة والإصدارات، وتعرض الاستجابة الرسوم الدقيقة. تُسترد تكلفة أي عملية توليد تفشل، أما العملية التي تحجبها سياسة المحتوى في Mage فلا تُسترد.

ما نقطة النهاية الخاصة بـ Chroma API؟

أرسل طلب POST إلى https://api.mage.space/v1/chroma/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url للاستعلام عنه دوريًا حتى تصلك النتيجة.

ما نماذج Chroma التي يمكنني استدعاؤها؟

chroma-v1-hd. النموذج الافتراضي هو Chroma.

هل يدعم Chroma الصور المرجعية أو الشخصيات؟

لا يقبل Chroma مدخلات من الصور أو الفيديو أو الصوت. ولا يقبل إشارات @handle.

هل يمكنني استخدام Chroma من Claude أو ChatGPT؟

نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Chroma بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل أن يبدأ التوليد.

إلى متى تُحفظ نتائج Chroma؟

يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

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

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

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

ذات صلة