
Ideogram 4.6 API cho bạn dùng model hình ảnh mới nhất của Ideogram qua một endpoint REST duy nhất trên PoYo: ideogram-v4.6 cho text-to-image và ideogram-v4.6-edit để chỉnh sửa một ảnh nguồn, có thể kèm mask và ảnh tham chiếu. Ảnh đầu ra lên tới 4096 pixel mỗi cạnh, giá từ 1.6 credit ($0.008) mỗi ảnh, và mọi request đều dùng cùng API key với phần còn lại của PoYo. Trang này trình bày Ideogram 4.6 là gì, các giới hạn chính xác, các bậc giá và những gì chúng tôi đo được trong ngày ra mắt.
Ideogram 4.6 là gì?
Ideogram 4.6 là model tạo và chỉnh sửa ảnh của Ideogram, ra mắt vào ngày 19 tháng 11 năm 2026. Ideogram gọi nó là "our most precise editing model yet" và cho biết model "generates images in native 4K", "no upscaling". Trên trang model, Ideogram cũng cho biết model "leaves far less pixel drift outside your edits and holds color more accurately".
Ideogram củng cố điều đó bằng điểm số theo tác vụ ở chất lượng cao, so sánh 4.6 với 4.5:
| Tác vụ (theo mô tả của Ideogram) | Ideogram 4.6 | Ideogram 4.5 |
|---|---|---|
| Màu chính xác: đổi màu một vật thể sang mã hex của thương hiệu | 83% | 46% |
| Chi tiết sản phẩm: sửa một lỗi nhỏ trong ảnh sản phẩm | 86% | 61% |
| Ảnh sản phẩm: dàn dựng, đổi phong cách và đổi nhãn sản phẩm | 88% | 66% |
| Nhất quán nhân vật: giữ một người dễ nhận ra trong cảnh mới | 85% | 69% |
| Chỉnh sửa bằng mask: chỉ thay đổi vùng được tô | 90% | 82% |
Đây là số liệu của Ideogram, không phải đo đạc của PoYo. Với một tích hợp API, chúng chỉ ra ba loại request đáng gửi tới đây:
- Poster, nhãn và ảnh mạng xã hội có chữ chính xác: đặt chữ trong dấu ngoặc kép trong prompt.
- Chỉnh sửa phải giữ nguyên mọi thứ khác: ngày mới trên tờ rơi, sản phẩm được đổi màu, một chi tiết được thay đổi.
- Bản in khổ lớn: kích thước tùy chỉnh lên tới 4096 pixel mỗi cạnh mà không cần bước upscale riêng.
Tổng quan Ideogram 4.6 API
| Text-to-image | Chỉnh sửa | |
|---|---|---|
| Model ID trên PoYo | ideogram-v4.6 | ideogram-v4.6-edit |
| Endpoint gửi | POST https://api.poyo.ai/api/generate/submit | Giống nhau |
| Kết quả | Polling GET /api/generate/status/{task_id} hoặc dùng callback_url | Giống nhau |
| Đầu vào | prompt | prompt + đúng một ảnh trong image_urls, tùy chọn mask_url và reference_image_urls |
| Số ảnh mỗi request | 1 đến 8 (n) | 1 đến 8 (n) |
| Mức chất lượng | very_low, low, medium (mặc định), high | Giống nhau |
| Ngày Ideogram phát hành | 19 tháng 11 năm 2026 | 19 tháng 11 năm 2026 |
| Tài liệu | Tài liệu tham chiếu Ideogram V4.6 API | Tài liệu tham chiếu Ideogram V4.6 Edit |
Hai ID dùng chung xác thực, polling và tính phí, nên một ứng dụng có thể tạo ảnh bằng ID này và tinh chỉnh bằng ID kia mà không cần tích hợp thứ hai.
Giới hạn và các trường request
| Trường | Quy tắc trên PoYo |
|---|---|
prompt | Bắt buộc, 1 đến 10,000 ký tự, phải chứa ký tự không phải khoảng trắng. Đặt chữ chính xác trên ảnh trong dấu ngoặc kép. |
size | auto (mặc định), 1:1 (512×512), 1:1 HD (1024×1024), 4:3, 3:4, 16:9, 9:16, hoặc WIDTHxHEIGHT tùy chỉnh |
| Kích thước tùy chỉnh | Chữ x viết thường, cả hai cạnh từ 256 đến 4096 pixel và là bội số của 32, tỷ lệ khung hình trong khoảng 1:6 đến 6:1 |
quality | very_low, low, medium (mặc định), high; very_low chỉ tới 4,194,304 pixel |
n | Số nguyên 1 đến 8 |
background | transparent hoặc opaque; chỉ cho text-to-image và chỉnh sửa thông thường |
seed | Số nguyên 0 đến 2,147,483,647 |
image_urls (chỉnh sửa) | Đúng một ảnh nguồn, URL HTTP(S) công khai hoặc data URI base64, luôn là mảng |
mask_url (chỉnh sửa) | Cùng kích thước với ảnh nguồn; vùng đen được chỉnh sửa, vùng trắng được giữ; cần size: auto |
reference_image_urls (chỉnh sửa) | 0 đến 4 ảnh, hoặc tối đa 3 khi có mask |
edit_precision (chỉnh sửa) | regular (mặc định) hoặc high; high cần size: auto và từ chối background |
context_window (chỉnh sửa) | none (mặc định) hoặc auto; auto cần mask_url và edit_precision: high |
Mọi trường khác bên trong input đều bị từ chối với lỗi unsupported fields. File được tạo ra lưu trong 3 ngày, vì vậy hãy sao chép chúng sang kho lưu trữ của bạn.
Giá Ideogram 4.6 API
PoYo tính phí theo mỗi ảnh đầu ra, theo chất lượng và bậc kích thước. "2K" nghĩa là ảnh đầu ra tối đa 4,194,304 pixel (diện tích bằng 2048×2048); lớn hơn là "4K". 1 credit = $0.005.
| Chất lượng | Text-to-image 2K | Text-to-image 4K | Chỉnh sửa 2K | Chỉnh sửa 4K |
|---|---|---|---|---|
very_low | 1.6 credit ($0.008) | không có | 1.6 credit ($0.008) | không có |
low | 6 credit ($0.03) | 12 credit ($0.06) | 6 credit ($0.03) | 12 credit ($0.06) |
medium | 12 credit ($0.06) | 24 credit ($0.12) | 12 credit ($0.06) | 40 credit ($0.20) |
high | 20 credit ($0.10) | 40 credit ($0.20) | 44 credit ($0.22) | 120 credit ($0.60) |
Với text-to-image, size: auto và sáu kích thước preset luôn là 2K. Với chỉnh sửa dùng size: auto, ảnh đầu ra giữ nguyên hình dạng của ảnh nguồn, nên ảnh nguồn lớn sẽ rơi vào bậc 4K. Các mức giá này khớp với bảng giá mỗi ảnh trên trang model của Ideogram; phân tích giá chi tiết tính toán qua các dạng request thực tế.
Những gì chúng tôi đo được trong ngày ra mắt
Đội ngũ PoYo chạy các tác vụ này trên API production của PoYo vào ngày 20 tháng 11 năm 2026. Prompt là một poster in lụa "NORTHBOUND JAZZ FESTIVAL" với các dòng "JUNE 12-14 · RIVERSIDE PARK" và "Three nights. Twenty-one bands. Free entry before 6 PM."
| Task | Request | Đầu ra | Đã tính phí |
|---|---|---|---|
M4WA9OIQXVV80DHG | ideogram-v4.6, quality: high, size: 2304x3072, n: 1 | Một PNG 2304×3072, khoảng 10.8 MB | 40 credit ($0.20) |
BS7M64COKT80JSLX | Cùng prompt, quality: very_low, size: 3:4 | PNG 768×1024 | 1.6 credit ($0.008) |
672JRU198S22NS8D | ideogram-v4.6-edit trên poster đầu tiên, edit_precision: high, context_window: none, size: auto, quality: high | PNG 2304×3072 | 120 credit ($0.60) |
Toàn bộ chữ trong hai poster đầu đều hiển thị đúng như đã viết, kể cả dòng chữ nghiêng nhỏ; bản nháp có bố cục khác. Prompt chỉnh sửa là: Change only the date line to "JULY 3-5 · RIVERSIDE PARK". Keep everything else exactly the same. So sánh từng pixel với ảnh gốc cho thấy mọi pixel thay đổi đều nằm trong một khung, từ (471, 2699) đến (1826, 2756), khoảng 1.1% diện tích ảnh; phần còn lại không thay đổi. Lần chỉnh sửa này dùng bậc 4K high vì chỉnh sửa độ chính xác cao giữ nguyên độ phân giải nguồn. Hướng dẫn chữ trên ảnh và chỉnh sửa chính xác đi qua từng bước của request đó.
Request Ideogram 4.6 API đầu tiên của bạn
curl https://api.poyo.ai/api/generate/submit \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v4.6",
"input": {
"prompt": "A minimalist poster titled \"SUMMER JAZZ NIGHTS\", bold typography",
"size": "2048x3072",
"quality": "high",
"n": 2
}
}'
2048x3072 là 6,291,456 pixel, nên request này được tính theo mức 4K high: 2 × 40 = 80 credit ($0.40). Response chứa data.task_id với trạng thái not_started. Hãy polling endpoint trạng thái cho đến khi là finished và đọc ảnh từ data.files, hoặc truyền callback_url ở cấp cao nhất. Luôn kiểm tra code trong body: một số lỗi xác thực trả về HTTP 200 kèm code: 400. Hướng dẫn API có vòng lặp polling Python có giới hạn thời gian và body cho mọi chế độ đầu vào.
Ideogram 4.6 có sẵn ở đâu
Ideogram cung cấp 4.6 trong ứng dụng và API của riêng họ, với hai endpoint: Generate và Precise Edit. Trên PoYo, bạn gọi nó bằng chính key bạn dùng cho mọi model khác, cùng luồng task và callback, cùng một Playground trên trang model hiển thị giá trước mỗi lần chạy. Trên PoYo, ảnh tham chiếu đi qua ideogram-v4.6-edit; ID text-to-image chỉ nhận prompt cùng các tùy chọn size, quality, n, background và seed.
Nên định tuyến request nào đi đâu
| Request | Model ID và thiết lập |
|---|---|
| Bản nháp và khám phá bố cục | ideogram-v4.6, very_low hoặc low, kích thước preset, n tối đa 8 |
| Poster hoàn chỉnh và ảnh mạng xã hội có diện tích tới 2048×2048 | ideogram-v4.6, high, kích thước tùy chỉnh như 1728x2304 |
| In ấn và tác phẩm khổ lớn | ideogram-v4.6, low đến high, kích thước tùy chỉnh trên 4,194,304 pixel |
| Thay đổi một chi tiết và giữ nguyên phần còn lại | ideogram-v4.6-edit, edit_precision: high |
| Vẽ lại một vùng của ảnh lớn | ideogram-v4.6-edit, mask_url, edit_precision: high, context_window: auto |
| Đổi phong cách theo ảnh tham chiếu, kích thước đầu ra mới | ideogram-v4.6-edit, edit_precision: regular, reference_image_urls, size tùy chỉnh |
Chuyển từ Ideogram 4.5 sang? Bài so sánh 4.6 với 4.5 liệt kê thay đổi về trường, quy tắc kích thước mới và giá cho cùng một request. Nếu đang cân nhắc các API hình ảnh khác trên PoYo, hãy xem tổng quan MAI Image 2.7 API và bài so sánh Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.
Câu hỏi thường gặp
Model ID của Ideogram 4.6 API là gì?
Dùng ideogram-v4.6 cho text-to-image và ideogram-v4.6-edit để chỉnh sửa. ideogram-4-6 chỉ là slug trang của PoYo, không phải model ID.
Ideogram 4.6 API có giá bao nhiêu?
Từ 1.6 credit ($0.008) mỗi ảnh ở very_low 2K. Một ảnh medium 2K mặc định là 12 credit ($0.06), high là 20 credit ($0.10) ở 2K và 40 credit ($0.20) ở 4K. Chỉnh sửa 4K chất lượng cao là 120 credit ($0.60).
Ảnh lớn nhất mà Ideogram 4.6 API có thể trả về là bao nhiêu? Kích thước tùy chỉnh lên tới 4096 pixel mỗi cạnh, là bội số của 32, với tỷ lệ khung hình từ 1:6 đến 6:1. Mọi ảnh trên 4,194,304 pixel được tính theo bậc 4K.
Ideogram 4.6 API có hiển thị chữ trên ảnh không? Có, hãy đặt chính xác các từ trong dấu ngoặc kép trong prompt. Trong bài thử ngày ra mắt của chúng tôi, một poster 2304×3072 hiển thị tiêu đề, dòng ngày và một dòng chữ nghiêng nhỏ đúng như đã viết. Ideogram vẫn khuyên kiểm tra chính tả và vị trí trong kết quả cuối cùng.
Ideogram 4.6 API có trả về ảnh nền trong suốt không?
Có. Đặt background thành transparent cho text-to-image hoặc chỉnh sửa thông thường. Chỉnh sửa độ chính xác cao từ chối background.
Ideogram 4.6 API có tương thích với OpenAI SDK không?
Không. Đây là API tác vụ bất đồng bộ: gửi tới /api/generate/submit, rồi polling /api/generate/status/{task_id} hoặc nhận callback.