APIMaster.ai

Hy Image 3.5 Preview · Referensi API dan penagihan

Buat gambar dari teks atau gambar referensi, lalu edit dalam beberapa putaran.

Kirim permintaan JSON dengan autentikasi Bearer dan kunci API APIMaster yang valid.

POST /v1/wand/hunyuan-image/v35-generation · Content-Type: application/json

Parameter permintaan

Kolom Tipe Deskripsi
model string hy-image-v3.5-preview (wajib).
messages object[] Pesan diurutkan berdasarkan waktu. Pesan user terakhir berisi instruksi saat ini. Pesan sebelumnya menjadi konteks pengeditan. Wajib.
size string Dimensi dalam format lebarxtinggi, misalnya 4096x4096. Tiap sisi berukuran 256–8192 piksel dengan batas luas 16,777,216 piksel.
seed int64 Bilangan bulat dari 0 hingga 2⁶³−1. Gunakan 0 atau hilangkan kolom untuk seed acak.
generate_max_pixels integer Berlaku jika size tidak diisi. Pilih 1,048,576, 2,359,296 (bawaan), atau 4,194,304. Nilai di antaranya dibulatkan ke tingkat terdekat. Gunakan size untuk 4K.
resize_max_pixels integer Gambar referensi yang melebihi luas ini diperkecil secara proporsional. Nilai bawaan: 1,048,576 piksel.
session string Pertahankan nilai ini dalam satu sesi pengeditan untuk membantu penggunaan ulang rute dan cache KV.
footnote string Tanda air di kanan bawah, hingga 16 karakter Unicode.
use_search_tool object Gunakan {"value":true} atau {"value":false}. Pencarian dinonaktifkan secara bawaan.

Setiap pesan mencakup role (user, assistant, atau tool) dan array content. Untuk teks gunakan type=text dan text. Untuk gambar gunakan type=image_url dan image_url:{url:...}. Gunakan URL publik atau URI data berawalan MIME. Batasnya 20 MB per gambar dan 20 gambar serta 100,000 token per konteks. Untuk hasil alat, sertakan tool_call_id yang sesuai. Tandai gambar yang sudah dibuat dengan is_generate:true.

Pesan assistant dapat mengirim kembali reasoning dan tool_calls apa adanya. Jika hanya memanggil alat, content boleh dihilangkan. Format panggilan adalah {id,type:"function",function:{name,arguments}} dengan string JSON di arguments.

curl -X POST "https://apimaster.ai/v1/wand/hunyuan-image/v35-generation" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"hy-image-v3.5-preview","size":"1024x1024","messages":[{"role":"user","content":[{"type":"text","text":"Lingkaran biru di atas latar putih"}]}]}'

Respons

Respons dapat berisi beberapa frame JSON berurutan. Ikuti Content-Type aktual. URL gambar akhir ada di choices[0].delta.image.url, dengan ukuran di width dan height. finish_reason yang bernilai null bisa muncul pada respons berhasil. Periksa URL dan unduh sebelum kedaluwarsa. Gunakan kembali assembled_history pada putaran pengeditan berikutnya. Simpan request_id saat terjadi kesalahan atau koneksi terputus. Mengulangi permintaan dapat memicu biaya baru.

Penagihan

Gateway mencadangkan saldo dan menagih satu kali berdasarkan tokenhub_usage.total_tokens. Lihat kartu model untuk harga APIMaster saat ini.