APIMaster.ai

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 の最新価格はモデルカードを参照してください。