Hy Image 3.5 Preview · Tài liệu API và tính phí
Tạo ảnh từ văn bản hoặc ảnh tham chiếu và chỉnh sửa qua nhiều lượt.
Gửi yêu cầu JSON với xác thực Bearer và khóa API APIMaster hợp lệ.
POST /v1/wand/hunyuan-image/v35-generation · Content-Type: application/json
Tham số yêu cầu
| Trường | Kiểu | Mô tả |
|---|---|---|
model |
string |
hy-image-v3.5-preview (bắt buộc). |
messages |
object[] |
Mảng tin nhắn theo thứ tự thời gian. Tin nhắn user cuối cùng là chỉ dẫn hiện tại. Các tin nhắn trước cung cấp ngữ cảnh chỉnh sửa. Bắt buộc. |
size |
string |
Kích thước theo dạng rộngxcao, ví dụ 4096x4096. Mỗi cạnh từ 256 đến 8192 pixel và diện tích tối đa là 16,777,216 pixel. |
seed |
int64 |
Số nguyên từ 0 đến 2⁶³−1. Bỏ trống hoặc dùng 0 để chọn seed ngẫu nhiên. |
generate_max_pixels |
integer |
Áp dụng khi thiếu size. Các mức là 1,048,576, 2,359,296 (mặc định) và 4,194,304. Giá trị nằm giữa được làm tròn về mức gần nhất. Dùng size cho 4K. |
resize_max_pixels |
integer |
Ảnh tham chiếu vượt diện tích này được thu nhỏ theo tỷ lệ. Mặc định là 1,048,576 pixel. |
session |
string |
Giữ nguyên giá trị trong phiên chỉnh sửa để hỗ trợ tái sử dụng định tuyến và bộ nhớ đệm KV. |
footnote |
string |
Hình mờ tùy chỉnh ở góc dưới bên phải, tối đa 16 ký tự Unicode. |
use_search_tool |
object |
Dùng {"value":true} hoặc {"value":false}. Tính năng tìm kiếm mặc định tắt. |
Mỗi tin nhắn có role (user, assistant hoặc tool) và mảng content. Văn bản dùng type=text với text, ảnh dùng type=image_url với image_url:{url:...}. Hỗ trợ URL công khai hoặc URI dữ liệu có tiền tố MIME. Giới hạn là 20 MB mỗi ảnh, 20 ảnh và 100,000 token mỗi ngữ cảnh. Khi trả kết quả công cụ, hãy gửi tool_call_id tương ứng và đánh dấu ảnh đã tạo bằng is_generate:true.
Tin nhắn assistant có thể gửi lại nguyên vẹn reasoning và tool_calls. Có thể bỏ content khi chỉ gọi công cụ. Định dạng là {id,type:"function",function:{name,arguments}}, trong đó arguments là chuỗi 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":"Một hình tròn màu xanh trên nền trắng"}]}]}'
Phản hồi
Phản hồi có thể gồm các khung JSON liên tiếp. Hãy xử lý theo Content-Type thực tế. URL ảnh cuối nằm ở choices[0].delta.image.url và kích thước ở width và height. finish_reason có thể là null khi yêu cầu thành công. Xác nhận URL và tải ảnh trước khi hết hạn. Dùng lại assembled_history cho lượt chỉnh sửa tiếp theo. Giữ request_id khi có lỗi hoặc mất kết nối. Gửi lại yêu cầu tạo ảnh có thể phát sinh phí.
Tính phí
Cổng API giữ trước số dư và quyết toán một lần theo tokenhub_usage.total_tokens. Xem thẻ mô hình để biết giá APIMaster hiện tại.
