# API Z Image Tài liệu tham chiếu API đầy đủ cho tạo text-to-image Z Image. ## Biến thể mô hình API này hỗ trợ một biến thể mô hình: | Mô hình | ID | Mô tả | |-------|-----|-------------| | **Z Image** | `z-image` | Tạo text-to-image nhanh | ## So sánh nhanh | Tính năng | Z Image | |---------|---------| | Đầu vào | Prompt văn bản | | Đầu ra | Một hình ảnh được tạo | | Tỷ lệ khung hình | Hỗ trợ nhiều tỷ lệ | | Độ phân giải | Suy ra từ giá trị tỷ lệ width/height | | `seed` | Tùy chọn | ### Tỷ lệ khung hình được hỗ trợ Cặp `width:height` phải là một trong các giá trị: `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `9:16`, `16:9`, `9:21` ## Z Image (Text-to-Image) ### Điểm cuối ``` POST /api/v1/image/task ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model_name` | string | Phải là `"z-image"` | | `prompt` | string | Prompt tạo hình ảnh | | `width` | number | Giá trị tỷ lệ chiều rộng (ví dụ: `16` cho `16:9`) | | `height` | number | Giá trị tỷ lệ chiều cao (ví dụ: `9` cho `16:9`) | #### Tùy chọn | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `seed` | number | Seed ngẫu nhiên trong phạm vi `[0, 2147483647]`. Dùng `null` hoặc `0` để tạo ngẫu nhiên. | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'z-image', prompt: 'A cinematic portrait of a traveler standing on a cliff at golden hour', width: 16, height: 9, seed: 0 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Định dạng phản hồi Phản hồi submit: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_status": "submitted" } } ``` Poll bằng `GET /api/v1/image/{task_id}`. Trạng thái tác vụ: `submitted`, `processing`, `succeed`, `failed`. Phản hồi polling thành công hiển thị URL hình ảnh được tạo trong `data.task_result.images[].url`. ## Thực hành tốt nhất - Dùng giá trị tỷ lệ, không dùng kích thước pixel, cho `width` và `height`. - Giữ prompt giàu mô tả nhưng tập trung vào chủ thể, ánh sáng và bố cục. - Dùng `seed` cố định khi bạn muốn kết quả tạo có thể tái lập trong quá trình kiểm thử.