Tạo hình ảnh

Đại lý Hermes tạo hình ảnh từ lời nhắc bằng văn bản thông qua FAL.ai. Chín mô hình được hỗ trợ ngay lập tức, mỗi mô hình có tốc độ, chất lượng và sự cân bằng chi phí khác nhau. Mô hình hoạt động có thể được người dùng định cấu hình thông qua Hermes tools và tồn tại trong `config.yaml

Model được hỗ trợ

Người mẫu	Tốc độ	Điểm mạnh	Giá

`fal-ai/flux-2/klein/9b
` (mặc định)

Giá là giá của FAL tại thời điểm viết bài; kiểm tra fal.ai để biết số hiện tại.

Thiết lập

Nous Subscribers

Nếu bạn có đăng ký Nous Portal trả phí, bạn có thể sử dụng tính năng tạo hình ảnh thông qua Tool Gateway mà không cần khóa API FAL. Lựa chọn mô hình của bạn vẫn tồn tại trên cả hai đường dẫn. Các bản cài đặt mới có thể chạy Hermes setup --portal để đăng nhập và bật mọi công cụ cổng cùng một lúc; các bản cài đặt hiện có có thể chọn Đăng ký Nous làm chương trình phụ trợ gen hình ảnh thông qua `Hermes tools

Nếu cổng được quản lý trả về HTTP 4xx cho một kiểu máy cụ thể thì mô hình đó chưa được ủy quyền ở phía cổng — nhân viên hỗ trợ sẽ cho bạn biết điều đó kèm theo các bước khắc phục (đặt FAL_KEY để truy cập trực tiếp hoặc chọn một kiểu máy khác).

Nhận khóa API FAL

Đăng ký tại fal.ai
Tạo khóa API từ trang tổng quan của bạn

Định cấu hình và chọn mô hình

Chạy lệnh công cụ:

Hermes tools

`
``Điều hướng đến **🎨 Tạo hình ảnh**, chọn phần phụ trợ của bạn (Nous Subscription hoặc FAL.ai), sau đó bộ chọn hiển thị tất cả các mô hình được hỗ trợ trong bảng được căn chỉnh theo cột — các phím mũi tên để điều hướng, Enter để chọn:

`
  Model                          Speed    Strengths                    Price
  fal-ai/flux-2/klein/9b         &lt;1s      Fast, crisp text             $0.006/MP   ← currently in use
  fal-ai/flux-2-pro              ~6s      Studio photorealism          $0.03/MP
  fal-ai/z-image/turbo           ~2s      Bilingual EN/CN, 6B          $0.005/MP
  ...

`
``Lựa chọn của bạn được lưu vào 
`config.yaml

:

`YAML
image_gen:
  model: fal-ai/flux-2/klein/9b
  use_gateway: false            # true if using Nous Subscription

`

### Chất lượng hình ảnh GPT

Chất lượng yêu cầu 
`fal-ai/GPT-image-1.5
` và 
`fal-ai/GPT-image-2
` được ghim vào 
`medium
` (~$0,034–$0,06/hình ảnh ở 1024×1024). Chúng tôi không hiển thị các cấp 
`low
` / 
`high
` dưới dạng tùy chọn hướng tới người dùng để việc thanh toán trên Nous Portal luôn có thể dự đoán được đối với tất cả người dùng — mức chênh lệch chi phí giữa các cấp là 3–22×. Nếu bạn muốn có lựa chọn rẻ hơn, hãy chọn Klein 9B hoặc Z-Image Turbo; nếu muốn chất lượng cao hơn thì dùng Nano Banana Pro hoặc Recraft V4 Pro.

## Cách sử dụng

Lược đồ hướng tới tác nhân được cố ý tối thiểu — mô hình sẽ chọn bất kỳ thứ gì bạn đã định cấu hình:

`
Generate an image of a serene mountain landscape with cherry blossoms

`

`

Create a square portrait of a wise old owl — use the typography model

`

`

Make me a futuristic cityscape, landscape orientation

`

## Tỷ lệ khung hình

Mọi mô hình đều chấp nhận ba tỷ lệ khung hình giống nhau theo quan điểm của tác nhân. Trong nội bộ, thông số kích thước gốc của mỗi mô hình được điền tự động:

| Đầu vào đại lý | image_size (flux/z-image/qwen/recraft/ideogram) | khía cạnh_ratio (nano-chuối-pro) | image_size (GPT-image-1.5) | image_size (GPT-image-2) |
|---|---|---|---|---|
| 
`landscape
` | 
`landscape_16_9
` | 
`16:9
` | 
`1536x1024
` | 
`landscape_4_3
` (1024×768) |
| 
`square
` | 
`square_hd
` | 
`1:1
` | 
`1024x1024
` | 
`square_hd
` (1024×1024) |
| 
`portrait
` | 
`portrait_16_9
` | 
`9:16
` | 
`1024x1536
` | 
`portrait_4_3
` (768×1024) |

Hình ảnh GPT 2 ánh xạ tới giá trị đặt trước 4:3 thay vì 16:9 vì số điểm ảnh tối thiểu của nó là 655.360 — giá trị đặt trước 
`landscape_16_9
` (1024×576 = 589.824) sẽ bị từ chối.

Quá trình dịch này xảy ra trong 
`_build_fal_payload()

 - mã tác nhân không bao giờ phải biết về sự khác biệt trong lược đồ trên mỗi mô hình.

## Tự động nâng cấp

Việc nâng cấp thông qua **Clarity Upscaler** của FAL được kiểm soát theo từng mô hình:

| Người mẫu | Cao cấp? | Tại sao |
|---|---|---|
| 
`fal-ai/flux-2-pro
` | ✓ | Tương thích ngược (là mặc định của bộ chọn trước) |
| Tất cả những người khác | ✗ | Các mô hình nhanh sẽ mất giá trị phụ thứ hai; model độ phân giải cao không cần |

Khi nâng cấp chạy, nó sử dụng các cài đặt sau:

| Cài đặt | Giá trị |
|---|---|
| Yếu tố cao cấp | 2× |
| Sáng tạo | 0,35 |
| Sự giống nhau | 0,6 |
| Thang hướng dẫn | 4 |
| Các bước suy luận | 18 |Nếu nâng cấp không thành công (sự cố mạng, giới hạn tốc độ), hình ảnh gốc sẽ tự động được trả về.

## Cách thức hoạt động nội bộ
1. **Độ phân giải mô hình** — 
`_resolve_fal_model()
` đọc 
`image_gen.model
` từ 
`config.yaml

, chuyển trở lại 
`FAL_IMAGE_MODEL
` env var, sau đó chuyển sang 
`fal-ai/flux-2/klein/9b

.

2. **Xây dựng tải trọng** — 
`_build_fal_payload()
` chuyển 
`aspect_ratio
` của bạn sang định dạng gốc của mô hình (enum cài sẵn, enum tỷ lệ khung hình hoặc chữ GPT), hợp nhất các thông số mặc định của mô hình, áp dụng bất kỳ phần ghi đè người gọi nào, sau đó lọc vào danh sách trắng 
`supports
` của mô hình để các khóa không được hỗ trợ không bao giờ được gửi.
3. **Gửi ** — 
`_submit_fal_request()
` định tuyến thông qua thông tin đăng nhập FAL trực tiếp hoặc cổng Nous được quản lý.
4. **Nâng cấp** — chỉ chạy nếu siêu dữ liệu của mô hình có 
`upscale: True

.
5. **Phân phối** — URL hình ảnh cuối cùng được trả về cho tác nhân, tác nhân này sẽ phát ra thẻ 
`MEDIA:&lt;url
` mà bộ điều hợp nền tảng chuyển đổi sang phương tiện gốc.

## Gỡ lỗi

Bật ghi nhật ký gỡ lỗi:

``` bash
 export IMAGE_TOOLS_DEBUG=true

`
``Nhật ký gỡ lỗi chuyển đến 

./logs/image_tools_debug_&lt;session_id.JSON
` kèm theo thông tin chi tiết về mỗi cuộc gọi (kiểu máy, thông số, thời gian, lỗi).

## Phân phối nền tảng

| Nền tảng | Giao hàng |
|---|---|
| **CLI** | URL hình ảnh được in dưới dạng đánh dấu 

![](url)

 - nhấp để mở |
| **Telegram** | Tin nhắn ảnh có lời nhắc là chú thích |
| **Discord** | Được nhúng trong tin nhắn |
| **Chống lười** | URL được cung cấp bởi Slack |
| **WhatsApp** | Thông điệp truyền thông |
| **Khác** | URL ở dạng văn bản thuần túy |

## Hạn chế
- **Yêu cầu thông tin đăng nhập FAL** (
`FAL_KEY
` trực tiếp hoặc Đăng ký Nous)

- **Chỉ chuyển văn bản thành hình ảnh** — không inpainting, img2img hoặc chỉnh sửa thông qua công cụ này
- **URL tạm thời** — FAL trả về các URL được lưu trữ hết hạn sau nhiều giờ/ngày; lưu cục bộ nếu cần
- **Ràng buộc trên mỗi mô hình** — một số kiểu máy không hỗ trợ 
`seed

, 
`num_inference_steps

, v.v. Bộ lọc 
`supports
` âm thầm loại bỏ các thông số không được hỗ trợ; đây là hành vi được mong đợi

Model được hỗ trợ​

Thiết lập​

Nhận khóa API FAL​

Định cấu hình và chọn mô hình​

Model được hỗ trợ

Thiết lập

Nhận khóa API FAL

Định cấu hình và chọn mô hình