APIMaster.ai

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.