Hy Image 3.5 Preview · API başvurusu ve faturalandırma
Metinden veya referans görsellerden görsel oluşturun ve birden çok adımda düzenleyin.
Geçerli bir APIMaster API anahtarı ile Bearer kimlik doğrulaması kullanarak JSON isteği gönderin.
POST /v1/wand/hunyuan-image/v35-generation · Content-Type: application/json
İstek parametreleri
| Alan | Tür | Açıklama |
|---|---|---|
model |
string |
hy-image-v3.5-preview (zorunlu). |
messages |
object[] |
Zaman sırasına göre iletiler. Son user iletisi güncel talimatı, öncekiler düzenleme bağlamını içerir. Zorunludur. |
size |
string |
Boyut genişlikxyükseklik biçiminde verilir, örneğin 4096x4096. Her kenar 256–8192 piksel, toplam alan en fazla 16,777,216 pikseldir. |
seed |
int64 |
0 ile 2⁶³−1 arasında tam sayı. Rastgele bir tohum için alanı boş bırakın veya 0 girin. |
generate_max_pixels |
integer |
size bulunmadığında geçerlidir. Değerler 1,048,576, 2,359,296 (varsayılan) ve 4,194,304'tür. Ara değerler en yakın seviyeye yuvarlanır. 4K için size kullanın. |
resize_max_pixels |
integer |
Bu alanı aşan referans görseller orantılı olarak küçültülür. Varsayılan değer 1,048,576 pikseldir. |
session |
string |
Yönlendirmeyi ve KV önbelleğini yeniden kullanmak için aynı düzenleme oturumunda değeri koruyun. |
footnote |
string |
Sağ alt köşede en fazla 16 Unicode karakterden oluşan özel filigran. |
use_search_tool |
object |
{"value":true} veya {"value":false} kullanın. Arama varsayılan olarak kapalıdır. |
Her ileti bir role (user, assistant veya tool) ve content dizisi içerir. Metin için type=text ve text, görsel için type=image_url ve image_url:{url:...} kullanın. Herkese açık URL veya MIME önekli veri URI'si desteklenir. Sınırlar görsel başına 20 MB, bağlam başına 20 görsel ve 100,000 tokendır. Araç sonucunda ilgili tool_call_id değerini gönderin ve önceden oluşturulmuş görselleri is_generate:true ile işaretleyin.
assistant iletisi reasoning ve tool_calls alanlarını değiştirmeden geri gönderebilir. Yalnızca araç çağırıyorsa content atlanabilir. Çağrı biçimi {id,type:"function",function:{name,arguments}} şeklindedir ve arguments bir JSON dizesidir.
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":"Beyaz zemin üzerinde mavi bir daire"}]}]}'
Yanıt
Yanıtta ardışık JSON çerçeveleri olabilir. Dönen Content-Type değerine göre işleyin. Son görselin URL'si choices[0].delta.image.url alanında, boyutları width ve height alanlarındadır. Başarılı bir yanıtta finish_reason null olabilir. Görselin URL'sini doğrulayın ve süresi dolmadan indirin. Sonraki düzenlemede assembled_history değerini kullanın. Hata veya kesinti durumunda request_id değerini saklayın. Oluşturma isteğini tekrarlamak yeni bir ücrete yol açabilir.
Faturalandırma
Ağ geçidi bakiyeyi önceden ayırır ve tokenhub_usage.total_tokens üzerinden bir kez tahsilat yapar. Güncel APIMaster fiyatı için model kartına bakın.
