Mage API · 影片模型
Cherry API
我們的旗艦影片系列
POST https://api.mage.space/v1/cherry/generate重點速覽
Cherry API 透過 Mage 執行 Cherry 2 Pro 及其他 4 個版本,端點為 POST https://api.mage.space/v1/cherry/generate。使用預設設定發送一次請求需要 618 Gems(約 $0.618),無需訂閱。Cherry 可在提示詞中以 @handle 引用已儲存的角色、參考圖和音訊參考。
- 影片輸出
- 5版本
- 618預設每段影片所需 Gems
- $0.618約合美元
總覽
Cherry API 的功能
生成帶有音訊的電影感影片,從適合打草稿的 Cherry Mini,到我們最強大的模型 Cherry 2 Pro,支援最長 30 秒的影片、多個參考或 Characters,以及來源影片編輯。
Mage 的旗艦影片系列,具備電影級動態與音訊:Cherry Mini、Cherry、Cherry Pro、Cherry 2 和最強大的 Cherry 2 Pro。Cherry 2 系列模型最長可生成 30 秒的影片。
支援 image、additional_images、videos 作為輸入。
快速開始
呼叫 Cherry API
設定 MAGE_API_KEY,將請求送到 /cherry/generate,然後輪詢 status_url,直到請求完成。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/cherry/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": "4",
"model_id": "cherry-2-pro"
}' | 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('cherry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'cherry-2-pro',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("cherry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "cherry-2-pro",
})
print(request["result"]["url"])模型
Cherry 的 model_id 值
傳入 model_id 即可選擇版本。未指定時,請求會使用預設版本。
| model_id | 名稱 | 預設 |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2 | Cherry 2 | |
| cherry-2-pro | Cherry 2 Pro | 是 |
選項
Cherry 參數
以下為所有版本可接受的值;個別版本可能提供較少選項。各版本的選項請參閱文件。
| 欄位 | 可用值 |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
輸入
Cherry 支援的媒體輸入
每個輸入可使用 https URL、data URL,或上傳最大 100 MB 的檔案。
| 欄位 | 用途 |
|---|---|
| image | 參考圖片。 |
| additional_images | 其他參考圖片。 |
| videos | 來源影片。 |
規則
Cherry API 的限制
- 影片編輯只接受一支來源影片,`cherry-2` 和 `cherry-2-pro` 支援 4 到 30 秒,其他模型支援 2 到 15 秒。
- 在 `cherry-2` 和 `cherry-2-pro` 上,編輯後的影片會保留來源影片的長度和長寬比:`duration` 和 `aspect_ratio` 會被忽略,價格依影片長度計算。
更多影片模型
Mage 上的其他影片生成 API
Grok Video API
讓 Grok Imagine 動起來
Kiwi API
日常影片,免設定
Lemon API
完整影片功能,價格更親民
LTX Video API
快速的開放權重影片模型,適合反覆調整
Magejutsu API
重新演繹任何影片,並保留原有動態
Melon API
讓動漫動起來,可選配音訊
常見問題
常見問題
Cherry API 的費用是多少?
Cherry API 的端點是什麼?
我可以呼叫哪些 Cherry 模型?
Cherry 支援參考圖片或角色嗎?
我可以在 Claude 或 ChatGPT 中使用 Cherry 嗎?
Cherry 的生成結果會保存多久?
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。