Cherry API

Xem nhanh

Cherry API chạy Cherry 2 Pro và 3 biến thể khác qua Mage tại POST https://api.mage.space/v1/cherry/generate. Một yêu cầu với cài đặt mặc định tốn 618 Gems (khoảng $0.618), không cần đăng ký gói. Cherry dùng các nhân vật, tham chiếu và tham chiếu âm thanh đã lưu qua @handle trong prompt.

• Video

  Đầu ra

• 4

  Biến thể

• 618

  Gems mỗi clip, mặc định

• $0.618

  Khoảng, tính bằng USD

Tổng quan

Cherry API làm được gì

Video điện ảnh có âm thanh, từ Cherry Mini để làm bản nháp đến Cherry 2 Pro, model mạnh nhất của chúng tôi, với clip dài tới 30 giây, nhiều tham chiếu hoặc Characters, và chỉnh sửa từ video nguồn.

Dòng video hàng đầu của Mage, với chuyển động điện ảnh và âm thanh: Cherry Mini, Cherry, Cherry Pro và Cherry 2 Pro, model mạnh nhất, với clip dài tới 30 giây.

Đầu vào gồm image, additional_images, videos.

Bắt đầu nhanh

Gọi Cherry API

Đặt MAGE_API_KEY, gửi yêu cầu tới /cherry/generate và thăm dò status_url cho đến khi yêu cầu hoàn tất.

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"

// 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);

# 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"])

Mô hình

Giá trị model_id của Cherry

Gửi model_id để chọn phiên bản. Yêu cầu không có model_id sẽ chạy phiên bản mặc định.

Tùy chọn

Tham số của Cherry

Các giá trị được phép trên tất cả phiên bản; mỗi phiên bản có thể hỗ trợ ít hơn. Tài liệu liệt kê các tùy chọn theo từng phiên bản.

Đầu vào

Đầu vào media mà Cherry nhận

Gửi mỗi tệp dưới dạng URL https, data URL hoặc tải lên tối đa 100 MB.

Quy tắc

Các quy tắc Cherry API áp dụng

• Chỉnh sửa video cần đúng một video nguồn, dài 4 đến 30 giây với `cherry-2-pro` và 2 đến 15 giây với các model khác.
• Trên `cherry-2-pro`, khi chỉnh sửa, video giữ nguyên độ dài và tỷ lệ khung hình của video gốc: `duration` và `aspect_ratio` sẽ bị bỏ qua, và giá được tính theo độ dài video.

Thêm mô hình video

Các API tạo video khác trên Mage

FAQ

Câu hỏi thường gặp

Bắt đầu xây dựng với Mage

Một tài khoản, một số dư Gems, mọi mô hình. Bạn chỉ trả tiền cho những gì mình tạo.

Liên quan

• API tạo video AI
• Tài liệu tham khảo API Cherry
• Playground Cherry
• Tất cả mô hình API
• Máy chủ MCP của Mage