Mage API · 画像モデル

Z-Image API

Mageで最速の画像生成モデル

APIキーを取得プレイグラウンドでZ-Imageを試す
POST https://api.mage.space/v1/z_image/generate

ひと目でわかる概要

Z-Image APIは、POST https://api.mage.space/v1/z_image/generate からMage経由でZ-Imageを実行します。デフォルト設定のリクエストは10 Gems(約$0.01)で、サブスクリプションは不要です。Z-Imageは@handleメンションには対応していません。

概要

Z-Image APIでできること

圧倒的な速さで、Gemsも節約。しっかりした人体表現ときれいな文字描写のフォトリアルなテキストから画像への生成に対応し、最大2Kまで。参照画像は使えません。

Mageで最速の画像生成モデル。しっかりした人体表現と文字描写のフォトリアルなテキストから画像への生成を、1Kまたは2Kで行えます。

プロンプトだけで生成します。

クイックスタート

Z-Image APIを呼び出す

MAGE_API_KEYを設定して/z_image/generateにリクエストを送信し、完了するまでstatus_urlをポーリングします。

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

モデル

Z-Imageのmodel_idの値

model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。

model_id名前デフォルト
z-image-turboZ-Imageはい

オプション

Z-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

画像 · 20 Gemから

Anima API

アニメ特化

画像 · 35 Gemから

Chroma API

Fluxベースのオープンウェイトモデル

画像 · 40 Gems から

Flux 2 API

長いプロンプトや複数参照での編集に対応

画像 · 9 Gems から

GPT Image 2 API

的確なプロンプト反映と読みやすい文字

画像 · 75 Gemから

Grok Image API

Grok Imagine、3段階の品質

画像 · 37 Gems から

Guava API

写真と見間違えるほどのフォトリアリズム

FAQ

よくある質問

Z-Image APIの料金はいくらですか?

デフォルト設定のZ-Imageリクエスト(Z-Image)は10 Gems、約$0.01です。解像度、長さ、バリエーションによって料金は変わり、正確な請求額はレスポンスで確認できます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによってブロックされた場合は返金されません。

Z-Image APIのエンドポイントは何ですか?

MageのAPIキーを指定したAuthorization: Bearerヘッダーを付けて、POST https://api.mage.space/v1/z_image/generate にリクエストします。レスポンスに含まれるstatus_urlをポーリングして結果を取得します。

呼び出せるZ-Imageモデルは?

z-image-turbo(Z-Image)。デフォルトはZ-Imageです。

Z-Imageは参照画像やキャラクターに対応していますか?

Z-Imageは画像・動画・音声の入力を受け付けません。@handleメンションにも対応していません。

Z-ImageをClaudeやChatGPTから使えますか?

はい。Mage MCPサーバーをClaude、ChatGPT、Claude Code、Grok、Cursorに接続し、Z-Imageを名前で指定してください。アシスタントはget_modelでオプションを読み取り、生成前に料金を伝えます。

Z-Imageの生成結果はどのくらい保存されますか?

生成結果と入力データは30日間保存されます。残したいものは自分のストレージにダウンロードしてください。

Mageで開発を始めよう

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

APIキーを取得プレイグラウンドでZ-Imageを試す

関連情報