رفتن به محتوا

API مج · مدل تصویر

API Chroma

وزن‌های باز، ساخته‌شده بر پایه Flux

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

در یک نگاه

API Chroma مدل Chroma را از طریق Mage در POST https://api.mage.space/v1/chroma/generate اجرا می‌کند. یک درخواست با تنظیمات پیش‌فرض 35 Gems (حدود $0.035) هزینه دارد، بدون نیاز به اشتراک. Chroma منشن @handle نمی‌پذیرد.

  • تصویرخروجی
  • 1نسخه
  • 35Gems برای هر تصویر، پیش‌فرض
  • $0.035حدود، به دلار

نگاه کلی

API Chroma چه کاری انجام می‌دهد

یک مدل تصویر عمومی با وزن‌های باز بر پایه معماری Flux. تبدیل متن به تصویر، با کنترل کامل روی steps و guidance.

یک مدل تصویر چندمنظوره با وزن‌های باز بر پایه معماری Flux.

فقط از روی پرامپت تصویر می‌سازد.

شروع سریع

فراخوانی API Chroma

مقدار 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

  • تصویر · از ۴۰ Gem

    Flux 2 API

    پرامپت‌های بلند و ویرایش با چند رفرنس

  • تصویر · از ۹ Gem

    GPT Image 2 API

    پرامپت‌های دقیق و متن خوانا

  • تصویر · از 75 Gems

    API Grok Image

    Grok Imagine در سه سطح کیفیت

  • تصویر · از ۳۷ Gem

    Guava API

    واقع‌گرایی‌ای که شبیه عکس واقعی است

  • تصویر · از 20 Gems

    API HiDream

    سریع و همه‌کاره، با پرامپت منفی

  • تصویر · از 20 Gems

    Krea 2 API

    زیبایی خیره‌کننده در چند ثانیه

سؤالات متداول

سؤالات متداول

هزینهٔ Chroma API چقدر است؟
یک درخواست Chroma با تنظیمات پیش‌فرض (Chroma) ۳۵ Gem هزینه دارد، حدود $0.035. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ هزینهٔ دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه برگردانده می‌شود، اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برگردانده نمی‌شود.
اندپوینت Chroma API چیست؟
POST https://api.mage.space/v1/chroma/generate با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل status_url است که برای دریافت نتیجه باید آن را به‌صورت دوره‌ای بررسی کنید.
کدام مدل‌های Chroma را می‌توانم فراخوانی کنم؟
chroma-v1-hd. پیش‌فرض Chroma است.
آیا Chroma از تصویر مرجع یا شخصیت پشتیبانی می‌کند؟
Chroma ورودی تصویر، ویدیو یا صدا نمی‌پذیرد. Chroma اشاره با @handle را هم نمی‌پذیرد.
آیا می‌توان از Chroma در Claude یا ChatGPT استفاده کرد؟
بله. سرور Mage MCP را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Chroma را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج Chroma تا چه مدت نگه‌داری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.