Chuyển đến nội dung
PlaygroundTài liệuLấy khóa API

Mage API · Mô hình hình ảnh

Seedream API

Seedream, có bộ lọc nghiêm ngặt

Lấy khóa APIDùng thử Seedream trong playground
POST https://api.mage.space/v1/seedream/generate

Xem nhanh

Seedream API chạy Seedream 5.5 và 5 biến thể khác qua Mage tại POST https://api.mage.space/v1/seedream/generate. Một yêu cầu với cài đặt mặc định có giá 42 Gems (khoảng 0,042 $), không cần đăng ký gói. Seedream hỗ trợ nhân vật đã lưu và tham chiếu bằng @handle ngay trong prompt.

  • Hình ảnhĐầu ra
  • 6Biến thể
  • 42Gems mỗi hình ảnh, mặc định
  • $0.042Khoảng, tính bằng USD

Tổng quan

Seedream API làm được gì

Seedream của ByteDance, từ Seedream 5.0 Flash cho bản nháp đến Seedream 5.5, bản mới nhất và mặc định, với cảnh chi tiết, chữ dễ đọc và chỉnh sửa từ tối đa 10 ảnh tham chiếu hoặc Characters, lên đến 4K trên Seedream 4.5. Bộ lọc nghiêm ngặt: prompt và ảnh đầu tiên được kiểm tra trước mỗi lần chạy.

Dòng mô hình tạo ảnh Seedream của ByteDance, phù hợp với cảnh chi tiết, chữ dễ đọc và chỉnh sửa từ tối đa 10 ảnh tham chiếu hoặc Characters: Seedream 5.5 (`seedream-5.5`), bản mới nhất và là mặc định, cho ảnh chân thực hơn, chữ nhỏ rõ hơn và các lần chỉnh sửa lặp lại ổn định hơn; Seedream 5.0 Pro (`seedream-5.0-pro`), bản cao cấp nhất trước đó; Seedream 5.0 Flash (`seedream-5.0-flash`), một mức giá cố định đã bao gồm ảnh đầu vào, rẻ nhất ở 2K hoặc khi có ảnh đầu vào (Seedream 5.5 rẻ hơn nếu chỉ dùng prompt ở 1K); Seedream 5.0 Lite (`seedream-5.0-lite`), lên đến 3K; Seedream 4.5 (`seedream-4.5`), lên đến 4K; và Seedream 4.0 (`seedream-4.0`). Bộ lọc nghiêm ngặt: Mage kiểm tra prompt và ảnh đầu tiên trước khi chạy; yêu cầu bị từ chối sẽ thất bại với `content_blocked` kèm lý do và được hoàn lại.

Model nhận image, additional_images làm đầu vào.

Bắt đầu nhanh

Gọi Seedream API

Đặt MAGE_API_KEY, gửi yêu cầu tới /seedream/generate và kiểm tra status_url cho đến khi yêu cầu hoàn tất.

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Mô hình

Giá trị model_id của Seedream

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.

model_idTênMặc định
seedream-4.0Seedream 4.0
seedream-4.5Seedream 4.5
seedream-5.0-liteSeedream 5.0 Lite
seedream-5.0-proSeedream 5.0 Pro
seedream-5.0-flashSeedream 5.0 Flash
seedream-5.5Seedream 5.5Có

Tùy chọn

Tham số của Seedream

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.

TrườngGiá trị
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Đầu vào

Đầu vào media mà Seedream chấp 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.

TrườngVai trò
imageẢnh tham chiếu.
additional_imagesCác ảnh tham chiếu bổ sung.

Thêm mô hình ảnh

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

FAQ

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

Seedream API có giá bao nhiêu?
Một yêu cầu Seedream với cài đặt mặc định (Seedream 5.5) có giá 42 Gems, khoảng 0,042 $. Độ phân giải, thời lượng và biến thể khác sẽ làm giá thay đổi; phản hồi cho biết chính xác khoản phí. Lượt tạo bị lỗi sẽ được hoàn tiền; lượt bị chính sách nội dung của Mage chặn thì không.
Endpoint của Seedream API là gì?
POST https://api.mage.space/v1/seedream/generate kèm header Authorization: Bearer chứa khóa Mage API của bạn. Phản hồi có status_url để bạn kiểm tra kết quả.
Tôi có thể gọi những mô hình Seedream nào?
seedream-4.0 (Seedream 4.0), seedream-4.5 (Seedream 4.5), seedream-5.0-lite (Seedream 5.0 Lite), seedream-5.0-pro (Seedream 5.0 Pro), seedream-5.0-flash (Seedream 5.0 Flash), seedream-5.5 (Seedream 5.5). Mặc định là Seedream 5.5.
Seedream có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
Seedream chấp nhận image, additional_images. Seedream nhận nhân vật đã lưu và tham chiếu qua @handle trong prompt.
Tôi có thể dùng Seedream từ Claude hoặc ChatGPT không?
Có. Kết nối máy chủ Mage MCP với Claude, ChatGPT, Claude Code, Grok hoặc Cursor rồi yêu cầu Seedream theo tên. Trợ lý của bạn sẽ đọc các tùy chọn bằng get_model và báo giá trước khi tạo.
Kết quả Seedream được lưu trong bao lâu?
Kết quả và đầu vào được lưu trong 30 ngày. Hãy tải về bộ nhớ của bạn bất cứ thứ gì bạn muốn giữ lại.

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.

Lấy khóa APIDùng thử Seedream trong playground