Hy Image 3.5 Preview · API リファレンスと料金
テキストや参照画像から画像を生成し、複数ターンにわたって編集できます。
有効な APIMaster API キー を使い、Bearer 認証で JSON リクエストを送ります。
POST /v1/wand/hunyuan-image/v35-generation · Content-Type: application/json
リクエストパラメーター
| フィールド | 型 | 説明 |
|---|---|---|
model |
string |
hy-image-v3.5-preview(必須)。 |
messages |
object[] |
時系列順に並べたメッセージです。最後の user メッセージが現在の指示で、それ以前のメッセージが編集の文脈になります。必須。 |
size |
string |
幅x高さ 形式で指定します。例は 4096x4096 です。各辺は 256〜8192 ピクセルで、総面積は 16,777,216 ピクセル以下です。 |
seed |
int64 |
0〜2⁶³−1 の整数です。省略または 0 の場合はランダムになります。 |
generate_max_pixels |
integer |
size を省略した場合に使用します。1,048,576、2,359,296(既定)、4,194,304 から選びます。中間の値は最も近い段階に丸められます。4K には size を指定します。 |
resize_max_pixels |
integer |
面積がこの値を超える参照画像は同比率で縮小されます。既定は 1,048,576 ピクセルです。 |
session |
string |
ルーティングと KV キャッシュを再利用しやすくするため、同じ編集セッションでは同じ値を使います。 |
footnote |
string |
右下に表示するウォーターマークです。最大 16 Unicode 文字です。 |
use_search_tool |
object |
{"value":true} または {"value":false} を指定します。検索は既定で無効です。 |
メッセージは role(user、assistant、tool)と content 配列で構成します。テキストは type=text と text、画像は type=image_url と image_url:{url:...} を使います。公開 URL または MIME 接頭辞付きデータ URI を指定でき、画像 1 枚は 20 MB 以下、文脈ごとに最大 20 枚・100,000 トークンです。ツールの結果には該当する tool_call_id を返し、生成済み画像には is_generate:true を指定します。
assistant メッセージの reasoning と tool_calls はそのまま返せます。ツール呼び出しのみの場合は content を省略できます。呼び出し形式は {id,type:"function",function:{name,arguments}} で、arguments は JSON 文字列です。
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":"白い背景に青い円"}]}]}'
レスポンス
JSON フレームが連続して返る場合があります。実際の Content-Type に従ってください。最終画像の URL は choices[0].delta.image.url、寸法は width と height です。成功時でも finish_reason は null の場合があります。URL を確認し、有効期限内に画像をダウンロードしてください。次の編集では assembled_history を再利用できます。エラーや切断時は request_id を保存してください。生成の再送には追加料金が発生する場合があります。
料金
ゲートウェイは残高を事前に確保し、tokenhub_usage.total_tokens に基づいて一度だけ精算します。APIMaster の最新価格はモデルカードを参照してください。
