Skip to main content
POST

Model yang Didukung

Ketiga model mendukung pembuatan gambar dari teks dan dari gambar referensi.

Otorisasi

string
wajib
Semua endpoint memerlukan autentikasi Bearer Token.Dapatkan API key dari Manajemen API Key, lalu tambahkan ke header permintaan:

Body

string
wajib
Nama model:
  • flux-2-flex
  • flux-2-pro
  • flux-2-max
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas gambar dikirim.
  • true: periksa prompt dan gambar input dengan omni-moderation-latest
  • false atau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
string
wajib
Deskripsi teks untuk gambar yang akan dibuat atau perubahan yang akan diterapkan pada gambar referensi.
string
default:"2MP"
Preset resolusi gambar. Nilai yang didukung:
  • 1MP
  • 2MP (default)
  • 3MP
  • 4MP
Di sini, 1MP setara dengan 1,048,576 piksel.Untuk kompatibilitas dengan integrasi lama, alias berikut juga didukung: 512, 512P, dan 1M setara dengan 1MP; 1K dan 1024 setara dengan 2MP; 2K dan 2048 setara dengan 3MP; 4K setara dengan 4MP. Nilai lain akan ditolak.Preset menentukan dimensi gambar ketika size berupa rasio aspek. Preset ini diabaikan jika dimensi piksel yang tepat diberikan melalui size atau melalui width dan height.
string
default:"1:1"
Rasio aspek atau dimensi piksel gambar.size juga mendukung auto: ketika image_urls diberikan, rasio aspek gambar referensi akan diikuti dengan tetap mempertahankan tingkat resolution saat ini; tanpa gambar referensi, default 1:1 digunakan.Opsi ukuran yang didukung:
  • 1:1 (default)
  • 4:3
  • 3:4
  • 16:9
  • 9:16
  • 3:2
  • 2:3
  • 21:9
  • 9:21
  • auto - mengikuti rasio aspek gambar referensi
Anda juga dapat memberikan string piksel seperti 1024x1536. Dimensi piksel yang tepat tunduk pada batas piksel yang sama dengan width dan height.Urutan prioritas ukuran adalah pasangan width + height, string piksel di size, resolution + rasio aspek di size, lalu default 2MP + 1:1 (1440×1440).
integer
Lebar gambar dalam piksel. Jika diberikan, height juga wajib diberikan. Setiap dimensi minimal 64 piksel. Jika hanya salah satu dimensi diberikan, tugas akan gagal.Pasangan width dan height yang lengkap memiliki prioritas tertinggi serta mengabaikan resolution dan size.
integer
Tinggi gambar dalam piksel. Jika diberikan, width juga wajib diberikan. Setiap dimensi minimal 64 piksel. Jika hanya salah satu dimensi diberikan, tugas akan gagal.Gambar keluaran tidak boleh melebihi 4 MP (width × height ≤ 4.194.304), dan jumlah piksel gambar keluaran beserta semua gambar referensi tidak boleh melebihi 9 MP.
array
Gambar referensi untuk pembuatan gambar dari gambar. Berikan melalui URL yang dapat diakses publik atau dalam format Base64.
  • Maksimum: 8 gambar
  • Jumlah piksel gambar keluaran beserta semua gambar referensi tidak boleh melebihi 9 MP
string
default:"jpeg"
Format gambar hasil: jpeg, png, atau webp. Default-nya adalah jpeg.
integer
default:"1"
Jumlah gambar yang dibuat. Hanya nilai 1 yang didukung.
integer
Seed acak. Gunakan kembali seed dan parameter yang sama untuk menghasilkan gambar yang dapat direproduksi; hilangkan parameter ini untuk menggunakan seed acak.
boolean
default:"false"
Menentukan apakah prompt ditingkatkan dan ditulis ulang sebelum pembuatan gambar. Default-nya adalah false; atur ke true untuk mengaktifkannya. Tetapkan false secara eksplisit untuk menonaktifkan penulisan ulang prompt.
integer
default:"2"
Toleransi keamanan dari 0 hingga 5. Nilai yang lebih tinggi lebih permisif.
integer
default:"50"
Jumlah langkah sampling dari 1 hingga 50. Nilai yang lebih tinggi dapat meningkatkan detail, tetapi membutuhkan waktu lebih lama.Parameter ini hanya didukung oleh flux-2-flex. Jangan kirimkan bersama flux-2-pro atau flux-2-max.
number
default:"5.0"
Panduan prompt dari 1.5 hingga 10. Nilai yang lebih tinggi mengikuti prompt dengan lebih ketat.Parameter ini hanya didukung oleh flux-2-flex. Jangan kirimkan bersama flux-2-pro atau flux-2-max.

Tabel Referensi Resolusi

Contoh Penggunaan

Pembuatan gambar dari teks

Pembuatan gambar dari gambar referensi

Dimensi gambar yang tepat

Kontrol FLUX.2 Flex

Respons

integer
Kode status respons.
array
Array hasil pengiriman tugas.

Mengambil Hasil

Lakukan polling pada GET /v1/tasks/{task_id} hingga tugas mencapai status completed atau failed. Lihat API Status Tugas untuk skema respons lengkap. Tugas yang selesai mencakup satu gambar yang dihasilkan:
URL gambar berada di data.result.images[0].url[0]. Masa berlakunya ditentukan oleh timestamp Unix di data.result.images[0].expires_at; unduh gambar sebelum waktu tersebut.

Status tugas

Contoh tugas yang gagal:
Parameter model yang tidak valid tidak menghasilkan error 400 secara sinkron. Pengiriman mengembalikan HTTP 200 dan task_id; saat dipolling, tugas berubah menjadi failed. Alasan spesifik selalu tersedia di error.message, sedangkan error.code adalah task_failed. Dana untuk tugas yang gagal dikembalikan sepenuhnya.

Catatan

  1. Tugas diproses secara asinkron. Respons pengiriman mengembalikan task_id untuk polling.
  2. Parameter n harus bernilai 1; setiap permintaan menghasilkan tepat satu gambar.
  3. Gambar referensi dapat diberikan melalui URL yang dapat diakses publik atau dalam format Base64.
  4. Hingga 8 gambar referensi didukung, dengan batas total 9 MP untuk gambar masukan dan keluaran.
  5. Dimensi keluaran yang tepat dapat ditetapkan melalui size berupa piksel, atau dengan memberikan width dan height secara berpasangan. Jika digunakan, keduanya harus minimal 64 piksel; gambar keluaran dibatasi hingga 4 MP.
  6. Masa berlaku URL hasil ditentukan oleh nilai expires_at yang dikembalikan dalam respons tugas.
  7. prompt_upsampling bernilai false secara default.