Langsung ke konten
PlaygroundDokumentasiDapatkan kunci API

Mage API · Model gambar

Seedream API

Seedream, dengan filter ketat

Dapatkan kunci APICoba Seedream di playground
POST https://api.mage.space/v1/seedream/generate

Sekilas info

Seedream API menjalankan Seedream 5.5 dan 5 varian lainnya lewat Mage di POST https://api.mage.space/v1/seedream/generate. Satu permintaan dengan pengaturan default berharga 42 Gems (sekitar $0,042), tanpa langganan. Seedream mendukung karakter tersimpan dan referensi lewat @handle di dalam prompt.

  • GambarOutput
  • 6Varian
  • 42Gems per gambar, default
  • $0.042Perkiraan, dalam USD

Ringkasan

Apa yang bisa dilakukan Seedream API

Seedream dari ByteDance, dari Seedream 5.0 Flash untuk draf hingga Seedream 5.5, yang terbaru dan default, dengan adegan detail, teks yang terbaca jelas, dan edit dari hingga 10 referensi atau Characters, hingga 4K di Seedream 4.5. Filter Ketat: prompt dan gambar pertama diperiksa sebelum setiap proses.

Keluarga model gambar Seedream dari ByteDance, cocok untuk adegan detail, teks yang terbaca jelas, dan pengeditan dari hingga 10 referensi atau Characters: Seedream 5.5 (`seedream-5.5`), yang terbaru dan menjadi default, dengan gambar lebih realistis, teks kecil lebih jelas, dan hasil edit berulang yang lebih stabil; Seedream 5.0 Pro (`seedream-5.0-pro`), model unggulan sebelumnya; Seedream 5.0 Flash (`seedream-5.0-flash`), satu harga tetap sudah termasuk gambar input, paling murah untuk 2K atau dengan gambar input (Seedream 5.5 lebih murah untuk prompt saja di 1K); Seedream 5.0 Lite (`seedream-5.0-lite`), hingga 3K; Seedream 4.5 (`seedream-4.5`), hingga 4K; dan Seedream 4.0 (`seedream-4.0`). Strict Filter: Mage memeriksa prompt dan gambar pertama sebelum proses dijalankan; permintaan yang ditolak akan gagal dengan `content_blocked` beserta alasannya, dan Gems-nya dikembalikan.

Menerima image dan additional_images sebagai input.

Mulai cepat

Panggil Seedream API

Setel MAGE_API_KEY, kirim ke /seedream/generate, lalu pantau status_url sampai permintaan selesai.

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

Model

Nilai model_id Seedream

Kirim model_id untuk memilih varian. Permintaan tanpa model_id akan menjalankan varian default.

model_idNamaDefault
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.5Ya

Opsi

Parameter Seedream

Nilai yang diizinkan untuk semua varian; satu varian bisa menawarkan lebih sedikit. Dokumentasi mencantumkan opsi untuk tiap varian.

KolomNilai
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Input

Input media yang diterima Seedream

Kirim masing-masing sebagai URL https, data URL, atau unggahan hingga 100 MB.

KolomPeran
imageGambar referensi.
additional_imagesGambar referensi tambahan.

Model gambar lainnya

API pembuat gambar lainnya di Mage

FAQ

Pertanyaan yang sering diajukan

Berapa biaya Seedream API?
Satu permintaan Seedream dengan pengaturan default (Seedream 5.5) berharga 42 Gems, sekitar $0,042. Resolusi, durasi, dan varian lain akan mengubah harganya; biaya pastinya tercantum di respons. Pembuatan yang gagal akan dikembalikan Gems-nya, sedangkan yang diblokir oleh kebijakan konten Mage tidak.
Apa endpoint Seedream API?
POST https://api.mage.space/v1/seedream/generate dengan header Authorization: Bearer yang berisi kunci API Mage-mu. Responsnya menyertakan status_url untuk dipantau sampai hasilnya siap.
Model Seedream mana yang bisa kupanggil?
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). Defaultnya adalah Seedream 5.5.
Apakah Seedream mendukung gambar referensi atau karakter?
Seedream menerima image, additional_images. Seedream menerima karakter dan referensi yang tersimpan lewat @handle di prompt.
Bisakah aku memakai Seedream dari Claude atau ChatGPT?
Bisa. Hubungkan server MCP Mage ke Claude, ChatGPT, Claude Code, Grok, atau Cursor, lalu minta Seedream dengan menyebut namanya. Asistenmu membaca opsinya dengan get_model dan menyebutkan harganya sebelum membuat.
Berapa lama hasil Seedream disimpan?
Hasil dan input disimpan selama 30 hari. Unduh apa pun yang ingin kamu simpan ke penyimpananmu sendiri.

Mulai berkarya dengan Mage

Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.

Dapatkan kunci APICoba Seedream di playground