Source: https://ailoot.ai/models/zh-hant-tw/tencent-hy-image-v3-5-preview/ Canonical: https://ailoot.ai/models/zh-hant-tw/tencent-hy-image-v3-5-preview/ Language: zh-hant-tw # Tencent: Hy Image 3.5 Preview [Markdown](https://ailoot.ai/models/zh-hant-tw/tencent-hy-image-v3-5-preview/index.md) · [JSON](https://ailoot.ai/models/zh-hant-tw/tencent-hy-image-v3-5-preview/facts.json) ## [Tencent: Hy Image 3.5 Preview](https://ailoot.ai/models/zh-hant-tw/tencent-hy-image-v3-5-preview/) HY Image 3.5 Preview 整合文字生圖、參考圖創作與多輪編輯。Tencent 文件記載最多 20 張參考圖片、自動選擇尺寸，以及最高 4096 × 4096 的明確輸出尺寸，適合細緻視覺工作。 - [**Ailoot Ultra · 圖片** `POST /v1/images/generations` `tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/zh-hant-tw/tencent-hy-image-v3-5-preview/#method-0) 關於模型 此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。 HY Image 3.5 Preview 是 Tencent 統一的圖片生成與編輯模型。它接受文字需求及選用參考圖片，支援跨多輪持續處理同一視覺任務。成果是對應明確場景、構圖或修改需求的圖片。Tencent 範例包括產品圖片、行銷海報、介面設計視覺與材質概念。請先選擇任務需要全新圖片、參考圖引導的構圖，還是針對現有結果的聚焦修改。 原廠將此版本識別為 hy-image-v3.5-preview，並記載 100K token 的提示詞上限。輸入是包含文字與圖片、按時間排列的對話，最後一則使用者訊息提供當前指令。先前訊息為反覆編輯提供背景。這與 HY Image 3.0 的單一提示詞流程及其獨立輸入限制不同。持續設計任務應保留相關需求、參考圖角色與選定圖片，讓下一項指令能延續預期視覺狀態。 請準備 PNG 或 JPEG/JPG 參考圖片。文件流程允許最多 20 張參考輸入，每張不超過 20 MB。圖片可透過參照或編碼素材提供。對話包含過多圖片時，原廠指南說明會先裁去較舊圖片。請聚焦目前需要的參考集合，不要依賴所有歷史圖片都留在上下文。輸入縮放控制會保留較小圖片，並將較大圖片依比例縮放至目標像素面積；預設目標為 1,048,576 像素。請保留足夠可見細節，讓產品、材質或版面能有效引導結果。 輸出尺寸有兩種不同準備方式。自動尺寸中，generate\_max\_pixels 設定目標面積：1K 級別為 1,048,576 像素，預設 1.5K 級別為 2,359,296，2K 為 4,194,304。原廠 FAQ 說明，僅提供面積目標設定時，比例預設為正方形。兩個尺寸控制項都省略時，模型依需求與預設 1.5K 級別處理。這些級別不會產生自動 4K 設定。正方形適合任務時可使用面積級別；如要在預設 1.5K 級別讓需求引導比例，請省略兩個尺寸控制項。版面需要特定直向或寬幅尺寸時，應明確指定寬高。 明確指定尺寸時，原廠允許兩邊為 256 至 8192 像素的正整數，總面積不超過 16,777,216 像素。4096 × 4096 正方形符合此限制。邊長範圍與面積上限須同時滿足，因此允許 8192 像素長邊，不代表可生成 8192 × 8192 圖片。最終版面需要特定尺寸時，應明確要求所需寬高，不要假設目標面積級別會決定相同尺寸。提示詞須清楚保留容易受裁切影響的細節與所需留白。 模型透過傳回的對話歷史支援多輪編輯。Tencent 區分最終交付圖片與下一次編輯作為上下文的中間圖片，範例在延續時保留助理推理、工具請求與生成圖片結果。產品構圖應先確立主體與取景，再要求修改光線或背景，並指定哪些部分應維持外觀。將選定結果與歷史一併保留，讓下一輪操作該圖片，而非已捨棄的變化版本。Tencent 文件流程中的最終圖片與歷史圖片連結，都在 12 小時後到期，因此後續編輯依賴它們之前，請先保存圖片素材。 文件中的控制項包含種子、最多 16 個字元的自訂浮水印註腳，以及預設關閉的選用外部搜尋增強。種子是非負整數；設定為零或省略時，由原廠隨機選擇。這些控制項的用途與需求本身不同。製作參考圖引導的產品視覺時，描述產品外觀、拍攝角度、表面、光線與預定版面，再用參考圖引導識別細節。海報應提供層級與確切文字，不要讓模型自行編造訊息。 Tencent 的實務指南建議檢查文字與版面，尤其是產品規格、組織名稱或其他事實文字。請檢查完成圖片的主體、比例、材質、裁切與文字。將最終素材與需求及設定一併保存，下一次編輯則使用與可見問題直接相關的具體指令。 **Ailoot Ultra · 圖片** `POST /v1/images/generations` `tencent/hy-image-v3.5-preview` [`tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/zh-hant-tw/#m=tencent%2Fhy-image-v3.5-preview&route=Ultra&caller=tencent%2Fhy-image-v3.5-preview&fmt=images) Tencent /`tencent/hy-image-v3.5-preview` ### 入門 HY Image 3.5 Preview 整合文字生圖、參考圖創作與多輪編輯。Tencent 文件記載最多 20 張參考圖片、自動選擇尺寸，以及最高 4096 × 4096 的明確輸出尺寸，適合細緻視覺工作。 接受的輸入 文字 · 圖片 結果 圖片 ### Ailoot 可用 · 輸入與方法 **Ailoot Ultra · 圖片** `POST /v1/images/generations` 輸入 `text`, `image` 輸出 `image` | 欄位 | 類型 | 要求 | 值與限制 | 預設值 | | --- | --- | --- | --- | --- | | 欄位`model` | 類型`string` | 要求必填 | 值與限制 tencent/hy-image-v3.5-preview | 預設值— | | 欄位`prompt` | 類型`string` | 要求必填 | 值與限制 長度下限: 1 | 預設值— | | 欄位`resolution` | 類型`string` | 要求選填 | 值與限制 1K, 1.5K, 2K, 4K | 預設值— | | 欄位`aspect_ratio` | 類型`string` | 要求選填 | 值與限制 1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9 | 預設值— | | 欄位`n` | 類型`integer` | 要求選填 | 值與限制 最小值: 1 最大值: 1 | 預設值— | | 欄位`input_references` | 類型`array` | 要求選填 | 值與限制 項目數下限: 0 項目數上限: 20 | 預設值— | | 欄位`provider` | 類型`object` | 要求選填 | 值與限制 | 預設值— | 方法參數與生命週期 | 參數 | 規格 | | --- | --- | | 參數`content_type` | 規格application/json | | 參數`required` | 規格model, prompt | | 參數`material_types` | 規格text, image | 生命週期： `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · 實際回傳的 task\_id 或媒體庫紀錄 `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### 方案 ##### 最終費用的計算方式 顯示的費率用於在生成前估算費用。最終費用依原始生成作業記錄的成本計算。實測的輸出時間長度與預估數量並非最終計費數量。 費率資訊不會增加請求選項。支援的參數列於所選方法中。 快速模式 未指定 選取快速模式時 flex 模式 未指定 選取 flex 模式時 最高推理強度 未指定 最高推理強度採用 default 調整值時 #### 供比較的預估費率 #### 各設定的價格 請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。 | 設定 | 費率表 | 預估數量 | 計費單位 | 費用 | | --- | --- | --- | --- | --- | | 設定基礎 token 費率 | 費率表基本費率 | 預估數量— | 計費單位— | 費用 輸入 · 輸入 Token · 僅供比較的估算 **—** / 1K Token 輸出 · 輸出 Token · 僅供比較的估算 **—** / 1K Token 輸入 · 讀取快取 · 僅供比較的估算 **—** / 1K Token 輸入 · 寫入快取 · 僅供比較的估算 **—** / 1K Token 輸入 · 寫入快取，1 小時 · 僅供比較的估算 **—** / 1K Token | | 設定圖片輸出詞元 | 費率表— | 預估數量— | 計費單位/ 1K 圖片 Token | 費用 輸出 · 圖片輸出詞元 · 僅供比較的估算 **$0.0032** / 1K 圖片 Token | | 設定預估生成費用 | 費率表— | 預估數量單次生成估算值 | 計費單位— | 費用 輸出 · 預估生成費用 · 僅供比較的估算 **$0.0131072** 生成前估算 此估算並非額外費用，也不是本次生成完成後的固定費率。 | Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。[預留金額與結算的運作方式 →](https://ailoot.ai/docs/zh-hant-tw/billing/reserve/) ### 請求範例 #### Ailoot Ultra · 圖片 curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'tencent/hy-image-v3.5-preview', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"