Tencent: Hy Image 3.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

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

Tencent /tencent/hy-image-v3.5-preview

Bắt đầu

Đầ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 →

Ví dụ yêu cầu

Ailoot Ultra · Ảnh

curl

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"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Nhận và lưu kết quả

Ailoot Ultra · Ảnh

Tải xuống từng ảnh trả về hoặc lưu nội dung Base64 của ảnh

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Lượt đọc nội dung khác

Đọc tài nguyên hiện có thuộc về bạn

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Lưu tất cả kết quả đã hoàn tất

Lưu mọi ảnh đã hoàn tất; truy xuất từng URL trả về hoặc giải mã nội dung Base64 của ảnh.

Giữ lại toàn bộ phản hồi và các header, mọi đầu ra thực tế, các định danh gốc đã trả về và mọi trường usage. Khôi phục thao tác gốc mà không gửi lại yêu cầu tạo.

Nếu cần kiểm tra phản hồi gốc

Giữ lại X-Client-Request-ID đã trả về để đối soát. Chỉ truy xuất theo các giá trị task_id/asset_id thực tế đã trả về hoặc từ thư viện nội dung đa phương tiện thuộc quyền sở hữu của bạn; tuyệt đối không tạo URL tác vụ từ ID thao tác và không gửi lại yêu cầu tạo.

Trường phản hồi

Trường	Loại
Trường`created`	Loại
Trường`data[].url`	Loại
Trường`data[].b64_json`	Loại
Trường`usage`	Loại

Bí danh

Bí danh mô hình

Ailoot Ultra tencent/hy-image-v3.5-preview

Bí danh đường dẫn phương thức

/v1/images

ID gọi liên quan

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview

Có những đầu vào và kết quả nào?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image
Yêu cầu sử dụng những trường nào?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider
Áp dụng những giới hạn nào?: POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Tencent: Hy Image 3.5 Preview