メインコンテンツへスキップ

Mage API · 画像モデル

MOSS-Image API

長いプロンプトと2言語のテキストに対応、オープンウェイト

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

ひと目でわかる概要

MOSS-Image API は、POST https://api.mage.space/v1/moss_image/generate を通じて Mage 上で MOSS-Image を実行します。デフォルト設定のリクエストは 25 Gems(約$0.025)で、サブスクリプションは不要です。MOSS-Image は @handle のメンションには対応していません。

  • 画像出力
  • 1バリアント
  • 251枚あたりのGems(デフォルト)
  • $0.025米ドル換算の目安

概要

MOSS-Image APIでできること

長く詳細なプロンプトに忠実に従い、英語と中国語のテキストも描画できる、オープンウェイトのテキストから画像を生成するモデルです。LoRA を使えば最大 2K に対応。参照画像は使えません。

長く詳細なプロンプトや、英語・中国語のテキストに対応したオープンウェイトの画像生成モデルです。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"])

モデル

MOSS-Imageのmodel_id値

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

その他の画像モデル

MageのほかのAI画像生成API

FAQ

よくある質問

MOSS-Image APIの料金はいくらですか?
デフォルト設定(MOSS-Image)でのMOSS-Imageリクエストは25 Gem、約$0.025です。解像度、長さ、バリアントを変更すると料金も変わります。正確な料金はレスポンスに含まれます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによりブロックされた場合は返金されません。
MOSS-Image APIのエンドポイントは何ですか?
MageのAPIキーを入れた Authorization: Bearer ヘッダーを付けて、POST https://api.mage.space/v1/moss_image/generate にリクエストします。レスポンスに含まれる status_url をポーリングすると結果を取得できます。
MOSS-Imageではどのモデルを呼び出せますか?
moss-image(MOSS-Image)。デフォルトは MOSS-Image です。
MOSS-Imageは参照画像やキャラクターに対応していますか?
MOSS-Imageは画像・動画・音声の入力に対応していません。また、@handleのメンションにも対応していません。
ClaudeやChatGPTからMOSS-Imageを使えますか?
はい。Mage MCPサーバーをClaude、ChatGPT、Claude Code、Grok、Cursorに接続して、MOSS-Imageを名前で指定してください。アシスタントは get_model でオプションを読み取り、生成の前に料金を伝えます。
MOSS-Imageの結果はどのくらいの期間保存されますか?
生成結果と入力データは30日間保存されます。残したいものは自分のストレージにダウンロードしてください。

Mageで開発を始めよう

アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。