Cara Menggunakan API Seedgream 4.5

Seedream 4.5 ialah evolusi terbaharu dalam keluarga model teks-ke-imej/penyuntingan imej Seedream (dibangunkan di bawah penyelidikan Byte/BytePlus). Ia sedang dilancarkan merentas titik akhir rasmi BytePlus dan pelbagai platform pihak ketiga — termasuk akses bersepadu melalui gerbang berbilang model seperti CometAPI — dan membawa penambahbaikan pada ketekalan subjek, tipografi/perenderan teks, serta kesetiaan penyuntingan berbilang imej.

Artikel ini ialah panduan profesional berasaskan amali untuk menggunakan API Seedream 4.5. Anda akan memperoleh langkah persediaan praktikal, pengesahan (autentikasi) dan corak permintaan, amalan terbaik prompt dan parameter, aliran kerja penyuntingan & berbilang imej, pengendalian ralat, corak penerapan, serta pertimbangan undang-undang/ keselamatan.

Apakah Seedream 4.5?

Seedream 4.5 ialah iterasi terkini keluarga Seedream — model penjanaan dan penyuntingan imej multimodal yang direka untuk penciptaan teks-ke-imej kesetiaan tinggi dan penyuntingan imej berasaskan konteks (imej-ke-imej, penyuntingan berbilang rujukan, inpainting/outpainting, tipografi dan pengendalian teks padat). Berbanding keluaran Seedream sebelumnya, 4.5 memfokus pada ketekalan subjek yang lebih baik merentas aliran kerja berbilang imej, pemeliharaan butiran rujukan yang lebih ketat, kesetiaan tipografi yang lebih tinggi (teks dalam imej), dan kualiti output yang lebih baik sehingga 4K/ultra-HD dalam tetapan “high quality”. Penambahbaikan ini hadir sebagai sebahagian daripada seni bina berskala serta penalaan prompt/heuristik pada sisi enjin yang telah dikemas kini.

Mengapa ini penting: 4.5 dibina secara sengaja untuk menangani tugas kreatif profesional — variasi produk secara kelompok, suntingan berbilang imej yang konsisten dengan jenama, dan aset cetakan resolusi tinggi — sambil membolehkan kawalan lebih halus dengan imej rujukan dan operasi penyuntingan khusus.

Keupayaan teras

• Penjanaan teks-ke-imej (tunggal dan kelompok): jana 1–15 imej bagi setiap panggilan API, dengan mod kualiti boleh pilih (Basic vs High) yang menyeimbangkan kelajuan dan resolusi.
• Penyuntingan imej (i2i / inpainting / outpainting): gunakan satu atau lebih imej rujukan; memelihara perincian dan hubungan ruang merentas pelbagai rujukan.
• Pengadunan berbilang rujukan & salin unsur: sehingga ~10 imej rujukan boleh digunakan dalam satu tugasan untuk memindahkan unsur sambil mengekalkan pencahayaan/perspektif yang koheren.
• Perenderan tipografi/teks padat tahap tinggi: pengendalian yang lebih baik untuk imej dengan teks atau papan tanda (berguna untuk mokap, label produk, tangkapan skrin UI).
• Penstriman / output progresif: sesetengah titik akhir penerapan menyokong penstriman keputusan supaya klien boleh menerima hasil separa sewaktu penjanaan diteruskan.

Bagaimanakah menggunakan API Seedream 4.5 melalui CometAPI?

Di bawah ialah panduan praktikal yang boleh disalin-tampal untuk menjana imej melalui CometAPI (sebuah pengagregator yang mendedahkan model Seedream 4.5 sebagai satu parameter model). Gunakan CometAPI apabila anda mahukan satu kunci API untuk mengakses berpuluh-puluh/ratus model dan permukaan REST yang stabil serta mudah diintegrasikan. Dokumentasi CometAPI menunjukkan alias model doubao-seedream-4-5-251128 dan titik akhir penjanaan imej piawai.

Langkah-langkah peringkat tinggi

1. Daftar CometAPI dan dapatkan kunci API.
2. Gunakan titik akhir penjanaan imej (POST https://api.cometapi.com/v1/images/generations) dengan parameter model ditetapkan kepada pengecam Seedream 4.5 (contoh: doubao-seedream-4-5-251128).
3. Sertakan prompt, imej rujukan pilihan (URL atau muat naik multipart bergantung pada pengagregator), saiz/output kualiti, dan parameter lain.
4. Terima respons JSON yang mengandungi URL imej terjana (atau base64) dan metadata.

Jenis dan mod permintaan

Seedream 4.5 lazimnya menyokong:

• Teks → Imej (prompt teks → imej baharu)
• Imej → Imej (imej rujukan + prompt untuk transformasi bergaya)
• Penyuntingan Imej / Inpainting (mask + arahan suntingan untuk perubahan tertumpu)
  API dihos menyokong mod tugas tak segerak (hantar tugasan → tinjau dengan taskId) yang sesuai untuk render jangka panjang dan aliran kerja kelompok. Pautan yang dijana selalunya terhad masa (cth., sah 24 jam pada sesetengah gerbang) jadi rancang untuk penyimpanan/eksport.

Contoh curl (teks-ke-imej, prompt tunggal)

curl -X POST "https://api.cometapi.com/v1/images/generations" \
  -H "Authorization: Bearer COMETAPI_KEY_GOES_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "A cinematic portrait of a cyberpunk fox in neon rain, 4k, detailed lighting, film grain",
    "n": 3,
    "width": 2048,
    "height": 2048,
    "quality": "high",     # or "basic"
    "seed": 12345,
    "style": "photorealistic"
  }'

Nota

• Gantikan COMETAPI_KEY_GOES_HERE dengan kunci CometAPI anda.
• Parameter n menjana berbilang variasi dalam satu panggilan (menjimatkan overhead).
• quality: "high" lazimnya memetakan kepada resolusi lebih tinggi / kos pengiraan lebih tinggi (sering menyokong 4K).

Contoh Python requests (teks-ke-imej + simpan hasil)

import requests, base64, os

API_URL = "https://api.cometapi.com/v1/images/generations"
API_KEY = os.environ.get("COMETAPI_KEY")  # set env var for safety

payload = {
  "model": "doubao-seedream-4-5-251128",
  "prompt": "Studio shot of a ceramic mug on a wooden table, warm natural light, ultra-detailed, 2k",
  "n": 2,
  "width": 1024,
  "height": 1024,
  "quality": "basic"
}

resp = requests.post(API_URL, json=payload, headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
})
resp.raise_for_status()
data = resp.json()

# Example: each item has 'b64_json' or 'url' depending on provider
for i, item in enumerate(data.get("data", [])):
    img_b64 = item.get("b64_json")
    if img_b64:
        img_bytes = base64.b64decode(img_b64)
        with open(f"seedream_result_{i}.png", "wb") as f:
            f.write(img_bytes)
    else:
        print("Image URL:", item.get("url"))

Mengapa corak ini? Pengagregator lazimnya memulangkan sama ada payload base64 atau URL dihos; kod mengendalikan kedua-duanya. Titik akhir lazimnya akan memulangkan task_id. Tinjau titik akhir GET /tasks/{task_id} sehingga status ialah succeeded dan kemudian muat turun hasilnya. Banyak penyedia menyertakan SDK dengan pembantu terbina untuk corak ini.

Bagaimanakah saya mengoptimumkan kualiti imej dan memastikan teks boleh dibaca?

1. Gunakan imej rujukan untuk konteks dan padanan warna yang konsisten.
2. Nyatakan tipografi dengan jelas dalam prompt (keluarga fon, berat, penjajaran) dan pertimbangkan untuk menambah teks tepat sebagai tindanan dalam langkah sekunder bagi memastikan kebolehbacaan.
3. Jalankan proses dua langkah: (a) jana komposisi asas; (b) render semula atau sunting dalam lintasan kedua yang memfokus pada close-up atau kawasan label pada resolusi lebih tinggi.

Bagaimanakah anda harus menulis prompt untuk Seedream 4.5?

Prinsip kejuruteraan prompt

• Nyatakan dengan jelas: senaraikan subjek, aksi, gaya, lensa/kamera, waktu siang, dan palet warna yang diingini.
• Gunakan sauh identiti: Jika anda memerlukan wajah/prop yang sama merentas imej, sertakan deskriptor kekal (cth., “wanita yang sama berambut pendek beralun, jaket hijau, parut di kening kiri”) dan bekalkan 1–3 imej rujukan. Penggabungan berbilang rujukan Seedream 4.5 bertambah baik, tetapi sauh membantu.
• Prompt negatif: nyatakan dengan jelas perkara yang ingin dielakkan (cth., “tiada teks”, “tiada tera air”, “tiada anggota tambahan”).
• Hibrid pendek + panjang: berikan arahan kanonik ringkas kemudian lanjutan dengan beberapa baris perincian dan kekangan.

Templat prompt contoh

Produk hero shot (fotoreal): "Satu hero shot produk yang bersih bagi pembesar suara tanpa wayar matte hitam diletakkan di atas meja putih, pencahayaan softbox, 50mm, kedalaman medan cetek, latar studio, fotoreal, tiada teks"

Ilustrasi fantasi (berstail): "Landskap fantasi epik, istana kaca menjulang di atas tebing, golden hour, kabus volumetrik, gaya pelukis, sangat terperinci, seni konsep"

Sunting imej (alih objek): "Alihkan orang di sebelah kiri dan panjangkan latar belakang untuk mengisi ruang, kekalkan pencahayaan konsisten, tiada artifak"

Mokap berat tipografi: "Mokap skrin pendaratan aplikasi mudah alih pada iPhone 14, dengan teks 'Launch Now' dalam Gotham Bold, jadikan butang berwarna hijau dan kekalkan bayang lembut"

Potret watak: "Potret heroik seorang pahlawan wanita, pencahayaan rim sinematik, lensa potret 85mm, tekstur kulit ultra-terperinci, jeragat semula jadi, perisai kulit, latar neutral, fotorealistik."

Prompt berbilang imej dan rujukan

Apabila menggunakan penyuntingan berbilang imej, nyatakan imej rujukan mana yang memetakan kepada bahagian prompt mana. Seedream 4.5 bertambah baik dalam mengenal pasti subjek utama merentas berbilang rujukan — tetapi bersikap eksplisit (cth., “guna image_1 untuk wajah, image_2 untuk tekstur pakaian”) memberikan hasil lebih baik.

Pemilihan output & pascapemprosesan

• Jana N varian dan jalankan penapis objektif: skor keserupaan wajah, perbandingan histogram warna, OCR tipografi untuk menyemak ketepatan teks.
• Automasi ambang QC untuk merutekan output di bawah ambang kepada sentuhan semula manual.
• Serahkan tipografi akhir kepada alat tata letak jika anda perlukan teks yang tepat pada piksel — gunakan model untuk latar dan imejan, kemudian kompositkan teks tepat pada pasca. Ini mengurangkan kebergantungan pada kesetiaan teks model bagi aset pemasaran.

---

Bagaimanakah melakukan penyuntingan imej, inpainting, dan komposisi berbilang imej?

Aliran kerja penyuntingan imej

1. Muat naik imej rujukan ke penyedia atau hantar secara inline bersama permintaan.
2. Sediakan mask (imej binari) untuk inpainting atau anotasi sempadan bagi suntingan tertumpu.
3. Hantar prompt suntingan yang memperjelas bahagian mana perlu diubah dan mana perlu dikekalkan.

Banyak API menyokong mod suntingan imej tunggal dan komposisi berbilang imej; 4.5 ditala secara eksplisit untuk memelihara identiti subjek dan meningkatkan ketekalan berbilang imej.

Contoh: Payload Inpainting (pseudokod JSON)

{
  "model": "seedream-4.5",
  "mode": "image_edit",
  "image_url": "https://.../original.png",
  "mask_url": "https://.../mask.png",
  "prompt": "Replace background with a sunset beach — keep subject untouched, maintain original lighting on subject",
  "guidance": 9,
  "steps": 40
}

Petua untuk penyuntingan berbilang imej yang konsisten

• Gunakan seed yang sama untuk render berkaitan bagi mengekalkan konsistensi merentas bingkai.
• Kekalkan deskriptor kamera konsisten merentas prompt (cth., “potret 85mm, softbox, 3/4”) untuk mengekalkan konsistensi sudut pandang.
• Apabila menyunting wajah, minta klausa pemeliharaan halus (“kekalkan struktur wajah, tukar warna rambut sahaja”) untuk mengurangkan hanyutan identiti.

Apakah amalan terbaik apabila menggunakan Seedream 4.5

Bagaimanakah anda menyelesaikan isu lazim?

Berikut ialah langkah penyelesaian masalah praktikal apabila hasil tidak tepat:

Wajah kabur / butiran salah

Tingkatkan kekhususan prompt untuk butiran wajah (umur, ekspresi, pencahayaan), bekalkan imej rujukan berkualiti lebih tinggi, atau cuba arahan eksplisit “kekalkan wajah” dan turunkan strength suntingan untuk mengekalkan lebih banyak yang asal. Seedream 4.5 menambah baik realisme wajah, tetapi input masih penting.

Teks tidak boleh dibaca atau bercelaru

Sediakan teks vektor atau raster sebagai tindanan berasingan jika anda perlukan tipografi tepat pada piksel; jika tidak, gunakan tetapan resolusi lebih tinggi dan arahan gaya yang eksplisit “render teks boleh dibaca: ya”. 4.5 menambah baik pengendalian teks padat berbanding versi sebelumnya, tetapi kesempurnaan tipografi mungkin masih memerlukan pengkomposisian pada pasca.

Pencahayaan atau komposisi kelompok tidak konsisten

Gunakan prompt bertemplat dengan sebutan pencahayaan/kamera tetap, atau jana dalam satu panggilan kelompok untuk meningkatkan ketekalan. BytePlus dan CometAPI menyediakan corak inferens kelompok atas sebab itu.

Nota akhir dan langkah seterusnya

Seedream 4.5 ialah model imej matang berorientasikan produksi dengan penambahbaikan jelas yang disasarkan pada aliran kerja kreatif sebenar: ketekalan lebih baik, perenderan teks dan wajah yang diperbaiki, serta sokongan berbilang rujukan. Gunakan CometAPI atau pengagregator serupa apabila anda mahukan percubaan pantas dan fleksibiliti berbilang model.

Pembangun boleh mengakses [Seedream 4.5](http://Seedream 4.5) API dsb. melalui CometAPI, versi model terkini sentiasa dikemas kini dengan laman rasmi. Untuk bermula, terokai keupayaan model dalam Playground dan rujuk panduan API untuk arahan terperinci. Sebelum mengakses, sila pastikan anda telah log masuk ke CometAPI dan memperoleh kunci API. CometAPI menawarkan harga yang jauh lebih rendah berbanding harga rasmi untuk membantu anda mengintegrasi.

Sedia untuk bermula?→ Percubaan percuma Seedream 4.5 !

Jika anda ingin mengetahui lebih banyak tip, panduan dan berita tentang AI ikuti kami di VK, X dan Discord!