رفتن به محتوا

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

MOSS-Image API

پرامپت‌های بلند و متن دوزبانه، وزن‌های باز

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

در یک نگاه

API مدل MOSS-Image، مدل MOSS-Image را از طریق Mage روی POST https://api.mage.space/v1/moss_image/generate اجرا می‌کند. یک درخواست با تنظیمات پیش‌فرض ۲۵ Gems (حدود ۰٫۰۲۵ دلار) هزینه دارد و اشتراک لازم نیست. MOSS-Image از منشن کردن @handle پشتیبانی نمی‌کند.

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

نگاه کلی

MOSS-Image API چه کاری انجام می‌دهد

یک مدل متن‌به‌تصویر با وزن‌های باز که پرامپت‌های بلند و دقیق را خوب دنبال می‌کند و متن انگلیسی و چینی را در تصویر می‌نویسد. تا 2K با LoRAها؛ بدون تصویر مرجع.

یک مدل تصویر با وزن‌های باز برای پرامپت‌های بلند و دقیق و متن انگلیسی یا چینی، با کیفیت 1K یا 2K.

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

شروع سریع

فراخوانی MOSS-Image API

MAGE_API_KEY را تنظیم کنید، درخواست را به /moss_image/generate بفرستید و status_url را بررسی کنید تا درخواست کامل شود.

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

مدل‌ها

مقادیر model_id برای MOSS-Image

برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیش‌فرض را اجرا می‌کند.

model_idنامپیش‌فرض
moss-imageMOSS-Imageبله

گزینه‌ها

پارامترهای MOSS-Image

مقادیر مجاز برای همه نسخه‌ها؛ ممکن است یک نسخه گزینه‌های کمتری داشته باشد. گزینه‌های هر نسخه در مستندات آمده است.

فیلدمقادیر
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1k, 2k

مدل‌های تصویر بیشتر

سایر API‌های تولید تصویر در Mage

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

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

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

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

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