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.
