API Seedream 5.5

Referensi API lengkap untuk model Seedream 5.5 dari ByteDance.

Varian model

API ini mendukung dua varian model:

Perbandingan singkat

Rasio aspek yang didukung

16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9

Seedream 5.5 (Pembuatan gambar dari teks)

Endpoint

POST /api/v1/image/task

Parameter permintaan

Wajib

Catatan: Rasio lebar terhadap tinggi harus salah satu dari 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, atau 21:9.

Opsional

Contoh permintaan

javascriptSalin
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedream-v5.5',
    prompt: 'Editorial fashion portrait, soft window light, muted palette',
    resolution: '1.5k',
    width: 16,
    height: 9,
    background: 'auto'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedream 5.5 Edit (Penyuntingan gambar)

Endpoint

POST /api/v1/image/task

Parameter permintaan

Wajib

Catatan: Rasio lebar terhadap tinggi harus salah satu dari 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, atau 21:9.

Opsional

Contoh permintaan

javascriptSalin
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedream-v5.5-edit',
    prompt: 'Change the hairstyle',
    image_url_list: [
      'https://img.bestimage.ai/test/2026/7/1/ad8e011a-3e9b-49f0-9397-282bf51e2e45_162640331.jpeg'
    ],
    resolution: '1.5k',
    width: 16,
    height: 9,
    background: 'auto'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Contoh penyuntingan satu gambar

javascriptSalin
{
  model_name: 'seedream-v5.5-edit',
  image_url_list: ['https://img.bestimage.ai/test/2026/7/1/ad8e011a-3e9b-49f0-9397-282bf51e2e45_162640331.jpeg'],
  prompt: 'Change the hairstyle',
  resolution: '1.5k',
  width: 16,
  height: 9,
  background: 'auto'
}

Contoh penyuntingan beberapa gambar

javascriptSalin
{
  model_name: 'seedream-v5.5-edit',
  image_url_list: [
    'https://example.com/image1.jpg',
    'https://example.com/image2.jpg'
  ],
  prompt: 'Blend these images into a cohesive composition',
  resolution: '1.5k',
  width: 16,
  height: 9,
  background: 'auto'
}

Format respons

Respons awal

jsonSalin
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "0ca5f379-327b-4d49-ba19-e38782ceb2f0",
    "response_url": "https://api.flaq.ai/api/v1/image/0ca5f379-327b-4d49-ba19-e38782ceb2f0",
    "task_status": "submitted"
  }
}

Respons polling

Panggil GET /api/v1/image/{task_id} secara berkala untuk memeriksa status:

jsonSalin
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_result": {
      "credit": 200,
      "images": [
        {
          "url": "https://example.com/generated-image.png"
        }
      ]
    }
  },
  "message": "success"
}

Respons kesalahan

jsonSalin
{
  "code": 1201,
  "message": "[width, height] Invalid parameter (e.g. wrong key or value)",
  "data": null
}

Nilai status

• submitted: Tugas telah diterima
• processing: Pembuatan gambar sedang berlangsung
• succeed: Pembuatan gambar selesai
• failed: Pembuatan gambar gagal

Waktu pemrosesan

Periksa status secara berkala hingga tugas berstatus succeed atau failed. Untuk tugas yang baru dikirim atau masih diproses, respons mungkin belum memuat gambar hasil.

Praktik terbaik

1. Prompt terperinci: Jelaskan gambar yang diinginkan secara terperinci untuk mendapatkan hasil yang lebih baik.
2. Rasio aspek: Sebelum membuat gambar, pilih rasio yang sesuai dengan tujuan penggunaannya.
3. Kualitas penyuntingan gambar: Gunakan gambar sumber beresolusi tinggi dengan pencahayaan yang baik.