Mage API · 圖片模型
Mango API
我們的旗艦圖片系列
POST https://api.mage.space/v1/mango/generate重點速覽
Mango API 透過 Mage 的 POST https://api.mage.space/v1/mango/generate 執行 Mango 4 及其他 5 個版本。使用預設設定的請求費用為 42 Gems(約 $0.042),無需訂閱。Mango 支援已儲存的角色,也可在提示詞中以 @handle 引用參考圖。
- 圖片輸出
- 6版本
- 42每張圖片所需 Gems(預設)
- $0.042約合美元
總覽
Mango API 能做什麼
我們的圖片模型系列,專為保持角色一致、精準編輯,以及整合多張參考圖或 Characters 的場景而打造。Mango 4 是系列中的首選,光線與肌膚最逼真,小字也最清晰;Mango 3 Turbo 以固定價格快速出草稿,參考圖也包含在內;Mango 3S 最高可達 3K。
Mage 的旗艦圖片模型系列,專為保持角色一致、精準編輯,以及整合多張參考圖的場景而打造。Mango 4(`mango-v4`)是預設且最新的版本,光線與肌膚最逼真,小字也最清晰;Mango 3(`mango-v3`)是上一代旗艦;Mango 3 Turbo(`mango-v3-turbo`)以固定價格快速出草稿,參考圖也包含在內;Mango 3S(`mango-v3s`)最高可達 3K。
支援 image、additional_images 作為輸入。
快速開始
呼叫 Mango API
設定 MAGE_API_KEY,提交至 /mango/generate,然後輪詢 status_url,直到請求完成。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/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": "mango-v4"
}' | 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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v4',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4",
})
print(request["result"]["url"])模型
Mango 的 model_id 值
傳入 model_id 即可選擇版本。未指定時,請求會使用預設版本。
| model_id | 名稱 | 預設 |
|---|---|---|
| mango | Mango | |
| mango-v2 | Mango 2 | |
| mango-v3s | Mango 3S | |
| mango-v3 | Mango 3 | |
| mango-v3-turbo | Mango 3 Turbo | |
| mango-v4 | Mango 4 | 是 |
選項
Mango 參數
以下為所有版本可接受的值;個別版本可能提供較少選項。各版本的選項請參閱文件。
| 欄位 | 可用值 |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K, 3K, 4K |
輸入
Mango 接受的媒體輸入
每個輸入可使用 https URL、data URL,或上傳最大 100 MB 的檔案。
| 欄位 | 用途 |
|---|---|
| image | 參考圖片。 |
| additional_images | 其他參考圖片。 |
更多圖片模型
Mage 上的其他圖片生成 API
MiniMax H3 Image API
原生 1,600 萬像素圖片,開放權重
MOSS-Image API
支援長提示詞與雙語文字,開放權重
Nano Banana 2 API
文字銳利清晰,最高支援 4K
SDXL Plus API
修正臉部與手部的 SDXL
Seedream API
Seedream,內建嚴格過濾
Stable Diffusion v1.5 API
經典之作,經濟實惠
常見問題
常見問題
Mango API 的費用是多少?
Mango API 的端點是什麼?
可以呼叫哪些 Mango 模型?
Mango 支援參考圖片或角色嗎?
可以在 Claude 或 ChatGPT 中使用 Mango 嗎?
Mango 的結果會保存多久?
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。