Tổng › UI → provider
3. Đối chiếu UI → provider
Màn hình → model
| Màn / thao tác | Đường gọi | Provider | Ghi chú |
|---|---|---|---|
| EZ / Studio: Virtual Staging, Renovation, Furniture Removal, Sketch to Image, Floor Plan AI, Style Transfer | generation.ts:99 buildRoomIntent → canvas-intent.ts → API core/generation-mode.ts → Core room.edit |
KIE, 4 mode (bảng dưới) | Home "Try it Free" dùng cùng room.edit, 1 output |
| Studio Multiple Angles | studio-settings.ts:27 orbitIntent → jobs/fal-orbit.client.ts |
FAL qwen-image-edit-2511-multiple-angles |
1K/2K/4K; góc ngang 0–360, dọc −30…90, zoom 0–10; 50 steps, acceleration none |
| Studio Topaz Upscale | TopazControls.tsx → studio-settings.ts:23 topazIntent → topaz-upscale.ts |
FAL Topaz Precision / Creative / Generative | 19 model, 3 mức output; gửi preserve_source_size=true |
| Studio Layers → Separate objects | LayerWorkspace.tsx:178 |
KIE seedream/5-flash-layer-decomposition |
Cố định 1K (LayerWorkspace.tsx:41) |
| Studio: sửa layer → Run | LayerEdit.tsx:90 layer.edit, output_mode=scene |
KIE Sunburst | Cố định 1K |
| Sau khi sửa layer: lấy lại vật thể và alpha | API layer-output.service.ts:415–459 → Core engine.mjs:250–347 |
KIE Sunburst (extract 2K, transparent) → recraft/remove-background |
Stage phụ do worker chạy (xem K8) |
| LibRaw / Enhance → Apply / Save | Xử lý ngay trong browser → lưu derived asset | Không gọi AI | Save chậm thì không do provider |
4 mode của room.edit
| Mode trên UI | Model KIE | Giới hạn provider | Trong code |
|---|---|---|---|
| Turbo | seedream/5-flash-image-to-image | Prompt 4–5000; tối đa 10 ảnh; 1K/1.5K/2K; 8 tỷ lệ | UI chỉ cho 1K/2K, đã chặn 4K. Khớp provider |
| Default | gpt-image-2-5-flare-image-to-image | Prompt ≤ 20000; tối đa 16 ảnh; 1K/2K/4K; background chỉ 1K | 2K/4K vẫn gửi background → G5 |
| VIP Sunburst | gpt-image-2-5-sunburst-image-to-image | Như Default | Như trên; cũng dùng cho scene/extract của Layer |
| VIP Banana Pro | nano-banana-pro | Prompt ≤ 20000; tối đa 8 ảnh; 1K/2K/4K | Payload mẫu khớp schema. Source và guide cũng chiếm slot ảnh |
API giới hạn 14 ref và prompt 4000 ký tự. Core còn trừ thêm phần prompt hệ thống, guide và variation, nên số ký tự user thực sự còn ít hơn. Ví dụ ở living room, modern, 2K, 3:2: còn khoảng 3900 ký tự (Default / VIP), 2700 (Turbo).
Control của FAL
| Control | Provider cho phép | Code |
|---|---|---|
| Multiple Angles | Ngang 0–360, dọc −30…90, zoom 0–10, steps 1–50 | Trong miền cho phép. Không gửi additional_prompt |
| Topaz Precision | 7 model; sharpen/denoise; fix compression (trừ CGI); strength cho Text Refine | UI lọc field theo model, adapter lọc thêm một lần |
| Topaz Creative | Bloom 2 / Bloom / Bloom Realism; creativity, color, autoprompt tùy model | Ba control này chỉ hiện với Bloom 2 |
| Topaz Generative | 9 model; Wonder, Redefine, Recovery V2 | Control khuôn mặt bật/tắt theo toggle; field riêng theo model |
| Topaz output 1K/2K/4K | upscale factor; output tối đa theo provider | Là cạnh dài tối thiểu; giữ ảnh gốc nếu lớn hơn; API giới hạn 8192 px / 64 MP |
| Separate objects | 1 ảnh PNG/JPEG ≤ 30 MB, 262 144 px – 36 MP, tỷ lệ ≤ 16 | jobs/native-layer-input.ts chuẩn hóa ảnh trước khi gửi |
| Layer alpha (Recraft) | ≤ 5 MB, ≤ 16 MP, cạnh 256–4096 | layer-output.service.ts:66 chuẩn hóa ảnh trước khi gửi |
Giới hạn tài khoản provider
- KIE: 20 request tạo task / 10 s / tài khoản; media lưu 14 ngày, log 2 tháng (docs.kie.ai). Liên quan K2.
- FAL: giới hạn số request chạy đồng thời theo tài khoản (concurrency). Request đã vào queue chưa có nghĩa model đã tải ảnh (queue). Media hết hạn theo cấu hình tài khoản (media expiration). URL provider không phải nơi lưu lâu dài.
Schema đã đọc (28/10/2026)
Đọc bằng GET read-only, HTTP 200. Mã băm SHA-256 dùng để biết provider có đổi schema sau ngày này hay không.
| Schema | Thời điểm (UTC) | SHA-256 |
|---|---|---|
| KIE gpt-image-2-5-flare | 2026-10-27T17:17:28Z | 4045cbac7af3cfc0f7fe3a2365e4341cc9c7477cde94995ccbfd0aa56d279567 |
| KIE gpt-image-2-5-sunburst | 2026-10-27T17:17:29Z | 2876e885883250dbaff02d25b1117c453a9f635ed22f210870ebabf5082742ad |
| KIE seedream/5-flash-image-to-image | 2026-10-27T17:17:31Z | 0567e8fd5c597a7d710ffa280ed43b0c5c2946e18697f75f621b5e9220c50b54 |
| KIE nano-banana-pro | 2026-10-27T17:17:32Z | 7a6cac11d7b4aeb21baeb51a7047b19646615532a2ec114afcd5fcbfaba0017b |
| KIE seedream/5-flash-layer-decomposition | 2026-10-27T17:17:35Z | 694c4dbbade1921080108c69296b326442bd71650e6f96a8c58a2a26729ad384 |
| KIE recraft/remove-background | 2026-10-27T17:17:38Z | fd52ad551a8fc6afbdfabf699103471cc5f1db8d90015ebcdc708df6580fe1f8 |
| FAL qwen-image-edit-2511-multiple-angles | 2026-10-27T17:17:40Z | 96706245a49743d08afc97552eff8d6e8337c3d08a0c1023c54235ad18c4c1c9 |
| FAL topaz/upscale/image/precision | 2026-10-27T17:17:41Z | 0bc6c7dbc06c4f2097335b2860b1443119334e0da0ab590e6f45ef45bde915ee |
| FAL topaz/upscale/image/creative | 2026-10-27T17:17:41Z | f6551f15cb0eed9c67a1207dd53211a702414b6f9ded41c1c000e8f29826648d |
| FAL topaz/upscale/image/generative | 2026-10-27T17:17:42Z | f41c03364a022b97feedfc37cafcc12c01e639d354a77a8c43316d721ef861cb |
Schema KIE: https://api.kie.ai/api/v1/models/<model>/schema (cần API key). Schema FAL: https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=<endpoint>. Điều kiện "background chỉ 1K" nằm ở properties.input.properties.background.description.
Không tính vào danh sách lỗi
Các nhánh dưới đây không có nút nào trên UI gọi tới:
image.enhance(KIE topaz/image-upscale cũ): Topaz trên UI đi qua FAL.image.segment_map(Grok): Separate objects dùngimage.layer_decompose.nano-banana-2-1vàideogram/v4.5/edit: không có trong bộ chọn 4 mode.room.add_objects,room.camera_view,image.draft,image.remove_backgroundgọi độc lập.
Giữ compatibility và dữ liệu cũ của các nhánh này; không cần xóa.