Source: https://ailoot.ai/models/vi/tencent-hy-image-v3-5-preview/ Canonical: https://ailoot.ai/models/vi/tencent-hy-image-v3-5-preview/ Language: vi # Tencent: Hy Image 3.5 Preview [Markdown](https://ailoot.ai/models/vi/tencent-hy-image-v3-5-preview/index.md) · [JSON](https://ailoot.ai/models/vi/tencent-hy-image-v3-5-preview/facts.json) ## [Tencent: Hy Image 3.5 Preview](https://ailoot.ai/models/vi/tencent-hy-image-v3-5-preview/) HY Image 3.5 Preview kết hợp tạo ảnh từ văn bản, tạo dựa trên tham chiếu và chỉnh sửa nhiều lượt. Tencent công bố tối đa 20 ảnh tham chiếu, tự chọn kích thước và kích thước đầu ra chỉ định tối đa ảnh 4096 × 4096 cho công việc hình ảnh chi tiết. - [**Ailoot Ultra · Ảnh** `POST /v1/images/generations` `tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/vi/tencent-hy-image-v3-5-preview/#method-0) Về mô hình Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn. HY Image 3.5 Preview là mô hình tạo và chỉnh sửa ảnh hợp nhất của Tencent. Mô hình nhận bản yêu cầu viết với ảnh tham chiếu tuỳ chọn và hỗ trợ tiếp tục cùng tác vụ thị giác qua nhiều lượt. Kết quả là ảnh cho cảnh, bố cục hoặc chỉnh sửa đã xác định. Ví dụ của Tencent gồm ảnh sản phẩm, áp phích chiến dịch, hình ảnh thiết kế giao diện và ý tưởng chất liệu. Chọn tác vụ cần ảnh mới, bố cục có tham chiếu định hướng hay thay đổi có trọng tâm trên kết quả có sẵn. Nhà sản xuất xác định phiên bản là hy-image-v3.5-preview và công bố giới hạn câu lệnh 100K token. Đầu vào là hội thoại theo trình tự thời gian chứa văn bản và ảnh, với tin nhắn cuối cùng của người dùng cung cấp chỉ dẫn hiện tại. Tin nhắn trước cung cấp ngữ cảnh cho chỉnh sửa lặp lại. Điều này khác quy trình một câu lệnh của HY Image 3.0 và giới hạn đầu vào riêng của nó. Với tác vụ thiết kế liên tục, giữ bản yêu cầu liên quan, vai trò tham chiếu và ảnh đã chọn để chỉ dẫn tiếp theo phát triển từ trạng thái thị giác dự định. Chuẩn bị ảnh tham chiếu PNG hoặc JPEG/JPG. Đầu vào tham chiếu có thể chứa tối đa 20 ảnh, mỗi ảnh không lớn hơn 20 MB trong quy trình được công bố. Có thể cung cấp ảnh dưới dạng tài nguyên được tham chiếu hoặc đã mã hoá. Nếu hội thoại mang quá nhiều ảnh, hướng dẫn nhà sản xuất mô tả cắt bỏ ảnh cũ trước. Giữ bộ tham chiếu đang dùng có trọng tâm thay vì dựa vào mọi ảnh lịch sử còn trong ngữ cảnh. Tuỳ chọn đổi kích thước đầu vào giữ ảnh nhỏ hơn và thu phóng ảnh lớn theo tỷ lệ về diện tích điểm ảnh đích; đích mặc định là 1,048,576 pixel. Giữ đủ chi tiết nhìn thấy cho sản phẩm, chất liệu hoặc bố cục cần định hướng kết quả. Kích thước đầu ra có hai cách chuẩn bị riêng. Với tự chọn kích thước, generate\_max\_pixels đặt diện tích đích: 1,048,576 pixel cho mức 1K, 2,359,296 cho mức 1.5K mặc định hoặc 4,194,304 cho 2K. FAQ của nhà sản xuất nêu thiết lập diện tích đích được cung cấp một mình mặc định tỷ lệ vuông. Khi bỏ qua cả hai tuỳ chọn kích thước, mô hình dùng bản yêu cầu và mức 1.5K mặc định. Các mức đó không tạo thiết lập 4K tự động. Dùng mức diện tích khi ảnh vuông phù hợp tác vụ. Để bản yêu cầu định hướng tỷ lệ ở mức 1.5K mặc định, bỏ cả hai tuỳ chọn kích thước; yêu cầu kích thước rõ khi bố cục cần cỡ dọc hoặc rộng cụ thể. Với kích thước chỉ định, nhà sản xuất cho phép các cạnh là số nguyên dương từ 256 đến 8192 pixel, với tổng diện tích không lớn hơn 16,777,216 pixel. Hình vuông 4096 × 4096 đáp ứng giới hạn đó. Khoảng chiều dài cạnh và trần diện tích cùng áp dụng, nên cạnh 8192 pixel không cho phép ảnh 8192 × 8192. Yêu cầu chiều rộng và chiều cao cần thiết rõ ràng khi bố cục cuối cần kích thước cụ thể, thay vì mặc định mức diện tích đích xác định cùng kích thước. Giữ chi tiết dễ bị ảnh hưởng khi cắt và khoảng trống cần có rõ trong câu lệnh. Mô hình hỗ trợ chỉnh sửa nhiều lượt qua lịch sử hội thoại trả về. Tencent phân biệt ảnh cuối bàn giao với ảnh trung gian dùng làm ngữ cảnh lần sửa tiếp theo, và ví dụ giữ suy luận của trợ lý, yêu cầu công cụ và kết quả ảnh được tạo khi tiếp tục. Với bố cục sản phẩm, trước tiên xác lập chủ thể và khung hình; rồi yêu cầu đổi ánh sáng hoặc nền mới trong khi chỉ rõ phần cần giữ diện mạo. Lưu kết quả đã chọn cùng lịch sử để lượt tiếp theo làm việc trên ảnh đó thay vì biến thể đã bỏ. Trong quy trình được Tencent công bố, cả liên kết ảnh cuối lẫn ảnh lịch sử hết hạn sau 12 giờ, nên lưu tài nguyên ảnh trước khi dựa vào chúng cho lần sửa về sau. Các tuỳ chọn được công bố gồm seed, chú thích thuỷ vân tuỳ chỉnh tối đa 16 ký tự và tăng cường bằng tìm kiếm bên ngoài tuỳ chọn, mặc định tắt. Seed là số nguyên không âm; bằng không hoặc bỏ qua sẽ để nhà sản xuất chọn ngẫu nhiên. Những tuỳ chọn này có mục đích khác chính bản yêu cầu. Với hình ảnh sản phẩm dựa trên tham chiếu, mô tả diện mạo sản phẩm, góc máy, bề mặt, ánh sáng và bố cục dự định, rồi dùng tham chiếu để định hướng chi tiết nhận diện. Với áp phích, đưa thứ bậc và nội dung chính xác thay vì để thông điệp được tự bịa. Hướng dẫn thực tế của Tencent khuyến nghị kiểm tra chữ và bố cục, nhất là khi thông số sản phẩm, tên tổ chức hoặc nội dung mang tính dữ kiện khác quan trọng. Kiểm tra ảnh hoàn chỉnh về chủ thể, tỷ lệ, chất liệu, vùng cắt và chữ. Lưu tài nguyên cuối cùng với bản yêu cầu và thiết lập, rồi dùng chỉ dẫn cụ thể gắn với vấn đề nhìn thấy cho lần sửa tiếp theo. **Ailoot Ultra · Ảnh** `POST /v1/images/generations` `tencent/hy-image-v3.5-preview` [`tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/vi/#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` ### Bắt đầu HY Image 3.5 Preview kết hợp tạo ảnh từ văn bản, tạo dựa trên tham chiếu và chỉnh sửa nhiều lượt. Tencent công bố tối đa 20 ảnh tham chiếu, tự chọn kích thước và kích thước đầu ra chỉ định tối đa ảnh 4096 × 4096 cho công việc hình ảnh chi tiết. Đầu vào được chấp nhận Văn bản · Ảnh Kết quả Ảnh ### Có trên Ailoot · đầu vào & phương thức **Ailoot Ultra · Ảnh** `POST /v1/images/generations` Đầu vào `text`, `image` Đầu ra `image` | Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định | | --- | --- | --- | --- | --- | | Trường`model` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn tencent/hy-image-v3.5-preview | Mặc định— | | Trường`prompt` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn Độ dài tối thiểu: 1 | Mặc định— | | Trường`resolution` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1K, 1.5K, 2K, 4K | Mặc định— | | Trường`aspect_ratio` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 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 | Mặc định— | | Trường`n` | Loại`integer` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tối đa: 1 | Mặc định— | | Trường`input_references` | Loại`array` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số mục tối thiểu: 0 Số mục tối đa: 20 | Mặc định— | | Trường`provider` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— | Tham số phương thức và vòng đời | Tham số | Hợp đồng | | --- | --- | | Tham số`content_type` | Hợp đồngapplication/json | | Tham số`required` | Hợp đồngmodel, prompt | | Tham số`material_types` | Hợp đồngtext, image | Vòng đời: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · Giá trị task\_id thực tế đã trả về hoặc bản ghi trong thư viện nội dung đa phương tiện `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Bảng giá ##### Cách tính phí cuối cùng Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí. Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn. Chế độ nhanh Chưa chỉ định Khi chọn chế độ nhanh Chế độ Flex Chưa chỉ định Khi chọn chế độ flex Mức độ suy luận tối đa Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa #### Mức phí ước tính để so sánh #### Giá theo cấu hình Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế. | Cấu hình | Biểu mức phí | Số lượng dự báo | Đơn vị tính phí | Phí | | --- | --- | --- | --- | --- | | Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Số lượng dự báo— | Đơn vị tính phí— | Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh **—** / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh **—** / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh **—** / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh **—** / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh **—** / 1K token | | Cấu hìnhToken ảnh đầu ra | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phí/ 1K token hình ảnh | Phí Đầu ra · Token ảnh đầu ra · Ước tính chỉ để so sánh **$0.0032** / 1K token hình ảnh | | Cấu hìnhChi phí tạo ước tính | Biểu mức phí— | Số lượng dự báoước tính cho một lần tạo | Đơn vị tính phí— | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh **$0.0131072** ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất. | Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. [Cách hoạt động của cơ chế tạm giữ và quyết toán →](https://ailoot.ai/docs/vi/billing/reserve/) ### Ví dụ yêu cầu #### Ailoot Ultra · Ảnh 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"