رفتن به محتوا

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

API مدل Anima

ساخته‌شده مخصوص انیمه

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

در یک نگاه

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

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

نگاه کلی

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

یک مدل انیمه و تصویرسازی با خطوط تمیز و رنگ‌های تخت. تبدیل متن به تصویر تا 2K، با تگ‌هایی به سبک Danbooru و وزن‌دهی به پرامپت.

یک مدل انیمه و تصویرسازی با خطوط تمیز و رنگ‌های تخت، با تگ‌هایی به سبک Danbooru و وزن‌دهی به پرامپت.

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

شروع سریع

فراخوانی API Anima

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

cURL
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"
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('anima', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'anima-v1',
});

console.log(request.result.url);
Python
# 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"])

مدل‌ها

مقادیر model_id در Anima

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

model_idنامپیش‌فرض
anima-v1Anima v1بله

گزینه‌ها

پارامترهای Anima

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

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

قوانین

API Anima چه چیزهایی را اعمال می‌کند

  • پرانتزهای واقعی در پرامپت را به شکل `\(` و `\)` بنویسید؛ پرانتزهای بدون escape به‌عنوان وزن‌دهی به پرامپت خوانده می‌شوند.

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

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

  • تصویر · از 35 Gems

    API Chroma

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

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

    Flux 2 API

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

  • تصویر · از ۹ Gem

    GPT Image 2 API

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

  • تصویر · از 75 Gems

    API Grok Image

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

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

    Guava API

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

  • تصویر · از 20 Gems

    API HiDream

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

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

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

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

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

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