Mage API · 影片模型

Lemon API

完整影片功能,價格更親民

取得 API 金鑰在體驗區試用 Lemon
POST https://api.mage.space/v1/lemon/generate

重點速覽

Lemon API 讓你透過 Mage 在 POST https://api.mage.space/v1/lemon/generate 執行 Lemon。以預設設定發送請求費用為 245 Gems(約 $0.245),無需訂閱。Lemon 可在提示詞中以 @handle 使用已儲存的角色、參考素材和音訊參考。

總覽

Lemon API 的功能

我們的全能影片模型。支援起始與結束影格、最多 10 個參考素材或 Characters、聲音與音訊,影片長度 2 至 30 秒,最高 1080p。

Mage 的全能影片模型,價格更親民:支援影格、參考素材、聲音、生成音訊,影片長度 2 至 30 秒。

接受 first_image、last_image、image、additional_images、videos 作為輸入。

快速開始

呼叫 Lemon API

設定 MAGE_API_KEY,送出請求到 /lemon/generate,然後輪詢 status_url,直到請求完成。

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/lemon/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "lemon"
}' | 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('lemon', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'lemon',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("lemon", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "lemon",
})

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

模型

Lemon 的 model_id 值

傳入 model_id 即可選擇版本。未指定時,請求會使用預設版本。

model_id名稱預設
lemonLemon是

選項

Lemon 參數

以下為所有版本可接受的值;個別版本可能提供較少選項。各版本的選項請參閱文件。

欄位可用值
aspect_ratio16:9, 4:3, 1:1, 3:4, 9:16
resolution480p, 720p, 1080p
duration2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30

輸入

Lemon 接受的媒體輸入

每個輸入可使用 https URL、data URL,或上傳最大 100 MB 的檔案。

欄位用途
first_image第一格畫面的圖片。
last_image尾幀圖片。
image參考圖片。
additional_images其他參考圖片。
videos來源影片。

規則

Lemon API 的限制規則

更多影片模型

Mage 上的其他影片生成 API

影片 · 20 Gems 起

LTX Video API

快速的開放權重影片模型,適合反覆調整

影片 · 147 Gems 起

Melon API

讓動漫動起來,可選配音訊

影片 · 30 Gems 起

MiniMax-H3 API

快速的開放影片模型,支援立體聲

影片 · 每次 338 Gems 起

Plum API

每個片段都有聲音,最高支援 2K

影片 · 360 Gems 起

Raspberry API

從第一個影格讓角色動起來

影片 · 40 Gems 起

Wan Video v2.2 API

開放權重影片模型,提供 Lightning 版本

常見問題

常見問題

Lemon API 的費用是多少?

以預設設定(Lemon)發出一次 Lemon 請求需要 245 Gems,約 $0.245。其他解析度、時長和版本會改變價格,實際扣款金額會顯示在回應中。生成失敗會退還 Gems;若因違反 Mage 的內容政策而被攔截,則不會退還。

Lemon API 的端點是什麼?

使用 POST 請求 https://api.mage.space/v1/lemon/generate,並在 Authorization: Bearer 標頭中帶入你的 Mage API 金鑰。回應會包含 status_url,可用來輪詢取得結果。

我可以呼叫哪些 Lemon 模型?

lemon。預設為 Lemon。

Lemon 支援參考圖片或角色嗎?

Lemon 接受 first_image、last_image、image、additional_images、videos。Lemon 可在提示詞中透過 @handle 使用已儲存的角色、參考素材和音訊參考。

我可以在 Claude 或 ChatGPT 中使用 Lemon 嗎?

可以。將 Mage MCP 伺服器連接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然後直接指名要使用 Lemon。你的助理會透過 get_model 讀取可用選項,並在生成前告知價格。

Lemon 的生成結果會保留多久?

結果與輸入內容會保存 30 天。想留存的內容,請自行下載到你的儲存空間。

開始使用 Mage 打造你的作品

一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。

取得 API 金鑰在體驗區試用 Lemon

相關內容