Seedream 5.0 Pro API Panduan: Menghasilkan dan Mengedit Gambar dengan Kode

Pembagian Seedream 5.0 Pro API memberikan akses kepada pengembang ByteDanceModel generasi gambar dan pengeditan flagship melalui alur kerja asinkron berorientasi produksi. Panduan ini menunjukkan cara mengirimkan pekerjaan teks-ke-gambar dan pengeditan gambar melalui Poyo.ai, kemudian mendapatkan hasil dengan polling atau webhook.

Harga saat ini adalah 15 kredit, sekitar $0.075 per gambar yang dihasilkan, untuk kedua varian model.

API Model dan Parameter

Aliran kerja	ID Model
Teks ke gambar	seedream-5.0-pro
Pengeditan gambar	seedream-5.0-pro-edit

Masukan yang didukung meliputi:

• prompt- instruksi generasi atau pengeditan yang diperlukan
• size- resolusi yang ditetapkan sebelumnya seperti 1K atau 2K, atau rasio aspek seperti 1:1, 4:3, 3:4, 16:9, atau 9:16
• n- jumlah gambar yang akan dihasilkan
• output_format: jpeg atau png
• image_urls- Gambar referensi untuk model pengeditan, hingga 10
• callback_url- pilihan HTTPS titik akhir untuk pemberitahuan penyelesaian

Lihatlah hidup API referensi untuk skema saat ini.

1. Buat kunci API

Buatlah Poyo.ai akun, terbuka API Manajemen Kunci, dan menyimpan kunci dalam variabel lingkungan. Jangan pernah mengekspos kunci produksi dalam kode browser atau berkomitmen ke Git.

export POYO_API_KEY="your-api-key"

2. Kirimkan permintaan teks-ke-gambar

Semua pekerjaan menggunakan titik akhir submit yang terpadu:

POST https://api.poyo.ai/api/generate/submit

cURL

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header "Authorization: Bearer $POYO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "seedream-5.0-pro",
    "callback_url": "https://example.com/webhooks/poyo",
    "input": {
      "prompt": "Editorial science magazine cover about clean energy cities, title \"THE ELECTRIC CITY\", structured grid, accurate icons, dark navy and electric green palette",
      "size": "3:4",
      "n": 1,
      "output_format": "png"
    }
  }'

Tanggapan berisi ID tugas:

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "not_started",
    "created_time": "2026-07-16T10:10:00"
  }
}

3. Hubungi Seedream 5.0 Pro dengan JavaScript

const API_URL = 'https://api.poyo.ai/api/generate/submit';

async function generateSeedreamImage(prompt) {
  const response = await fetch(API_URL, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.POYO_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'seedream-5.0-pro',
      input: {
        prompt,
        size: '2K',
        n: 1,
        output_format: 'png',
      },
    }),
  });

  const payload = await response.json();
  if (!response.ok || payload.code !== 200) {
    throw new Error(payload.error?.message || 'Seedream request failed');
  }
  return payload.data.task_id;
}

Penggunaan 2K ketika resolusi lebih penting daripada rasio tetap. Gunakan nilai aspek-ratio ketika format penempatan adalah kendala utama.

4. Hubungi Seedream 5.0 Pro dengan Python

import os
import requests

API_URL = "https://api.poyo.ai/api/generate/submit"

def generate_seedream_image(prompt: str) -> str:
    response = requests.post(
        API_URL,
        headers={
            "Authorization": f"Bearer {os.environ['POYO_API_KEY']}",
            "Content-Type": "application/json",
        },
        json={
            "model": "seedream-5.0-pro",
            "input": {
                "prompt": prompt,
                "size": "16:9",
                "n": 1,
                "output_format": "jpeg",
            },
        },
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()
    if payload.get("code") != 200:
        raise RuntimeError(payload.get("error", {}).get("message", "Request failed"))
    return payload["data"]["task_id"]

5. Mengedit Gambar dengan Banyak Referensi

Mengganti ID model dan memberikan image_urls. Katakan kepada model apa kontribusi setiap referensi.

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header "Authorization: Bearer $POYO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "seedream-5.0-pro-edit",
    "input": {
      "prompt": "Use the room from reference 1. Replace only the chair with the chair from reference 2. Put the logo from reference 3 on the wall. Preserve the original camera, windows, floor, and afternoon lighting.",
      "image_urls": [
        "https://example.com/room.jpg",
        "https://example.com/chair.png",
        "https://example.com/logo.png"
      ],
      "size": "16:9",
      "n": 1,
      "output_format": "png"
    }
  }'

Untuk pengeditan yang dapat diandalkan, pisahkan prompt menjadi tiga ide: peran referensi, perubahan yang diminta, dan batasan konservasi.

6. Menemukan Hasilnya

Submit adalah asinkron. Setelah menerima task_id, baik:

• polling Poyo.ai” Unified Task-Status Endpoint; atau
• memberikan callback_url dan proses penyelesaian webhook.

Ikuti Dokumen manajemen tugas untuk rute status saat ini dan objek respons. Dalam produksi, gunakan backkoff eksponensial daripada polling terus menerus.

Pengendalian Kesalahan

Mengatasi kasus ini secara eksplisit:

• 400- parameter model yang tidak valid, ukuran yang tidak didukung, URL gambar yang tidak dapat diakses, atau cacat JSON
• 401- hilang atau tidak valid kunci API
• gagal tugas async: Generasi gagal setelah pengajuan yang valid
• webhook Coba lagi: acara penyelesaian yang sama dapat disampaikan lebih dari satu kali

Simpan ID tugas dengan ID pekerjaan internal Anda, membuat webhook menangani idempotent, dan log provider error messages tanpa log rahasia.

Daftar Pemeriksa Produksi

• Tetaplah kunci API di sisi server.
• Validasi panjang dan gambar prompt URL jenis sebelum pengajuan.
• Penggunaan HTTPS gambar referensi yang dapat diakses oleh layanan generasi.
• Setel waktu permintaan untuk panggilan pengiriman.
• Coba ulang kesalahan jaringan sementara, tetapi jangan secara buta mencoba ulang permintaan yang tidak valid.
• Biaya jalur sebagai number of requested outputs × 15 credits dengan harga saat ini.
• Ulasan teks yang dihasilkan, rincian produk, dan klaim faktual sebelum dipublikasikan.
• Tambahkan moderasi konten yang sesuai dengan produk dan pasar Anda.

Kapan Menggunakan Pro Daripada Lite

Penggunaan Seedream 5.0 Pro untuk desain terstruktur, tata letak padat, teks multilingual, dan pengeditan terkontrol. Penggunaan Seedream 5.0 Sedikit untuk pekerjaan gambar berbiaya rendah dan volume yang lebih tinggi di mana presisi desain tingkat Pro tidak diperlukan.

Untuk gambaran umum non-teknis, baca Seedream 5.0 Fitur Pro dan harga. Anda juga dapat menguji API beban berguna secara visual pada Seedream 5.0 Halaman model profesional.

Pertanyaan yang Sering Ditanyakan

Apa itu Seedream 5.0 Pro API titik akhir?

Mengirimkan pekerjaan pembuatan dan pengeditan ke POST https://api.poyo.ai/api/generate/submit.

Apa ID model edit?

Penggunaan seedream-5.0-pro-edit dan mencakup satu atau lebih nilai dalam input.image_urls.

Berapa banyak gambar referensi yang didukung?

arus Poyo.ai dokumentasi mendukung hingga 10 gambar referensi untuk Seedream 5.0 Editing profesional.

Berapa banyak yang bisa API biaya gambar?

arus Poyo.ai harga adalah 15 kredit, sekitar $0.075, untuk setiap gambar yang dihasilkan atau diedit.