how-tos

Ideogram 4.6 API: 10 body request prompt cho poster, nhãn và chỉnh sửa

Poyo.ai Team
10 min read
Share:

Prompt Ideogram 4.6 API kèm body request

Đây là bộ prompt cho Ideogram 4.6 API, được viết thành các body request hoàn chỉnh mà bạn có thể dán thẳng vào code: bảy cho text-to-image với ideogram-v4.6 và ba cho chỉnh sửa với ideogram-v4.6-edit. Mỗi body đều ghi bậc kích thước và giá, để bạn biết một lần chạy tốn bao nhiêu trước khi gửi. Mọi body đều tuân theo schema PoYo cho Ideogram 4.6 và được gửi tới POST https://api.poyo.ai/api/generate/submit.

Prompt 1 là request chính xác trong bài thử ngày ra mắt của chúng tôi vào ngày 20 tháng 11 năm 2026. Các prompt còn lại là mẫu chúng tôi chưa chạy; hãy coi chúng là điểm khởi đầu và kiểm tra mọi kết quả.

Cách viết prompt cho Ideogram 4.6 API

Schema cho phép tối đa 10,000 ký tự, nên có đủ chỗ để viết cụ thể. Một prompt hiệu quả cho typography thường có năm phần:

PhầnVí dụ
Định dạng"Screen-printed concert poster", "flat vector sticker", "product label"
Chữ chính xác, trong ngoặc kép, mỗi dòng một chuỗi"NORTHBOUND JAZZ FESTIVAL"
Thứ bậc và vị trí của từng dòng"big bold headline at the top", "a smaller line below the art"
Nội dung hình ảnh và bảng màu"upright bass and saxophone over a river at dusk, teal, burnt orange and cream"
Hoàn thiện"fine paper grain, crisp letterforms, generous margins"

Mở rộng prompt luôn bật, nên model có thể thêm chi tiết. Trong poster thử nghiệm của chúng tôi, nó thêm một dòng nhỏ "EST. 1987" và một địa chỉ web ở các góc. Hướng dẫn của chính Ideogram là "check spelling and placement in the final result".

Chọn thiết lập theo giai đoạn, không theo thói quen: very_low (1.6 credit, $0.008) cho bản nháp bố cục, medium (12 credit, $0.06) làm mặc định, high cho bản cuối. Hãy giữ ở mức 4,194,304 pixel trở xuống trừ khi bạn cần kích thước in; vượt ngưỡng đó, mọi mức chất lượng đều tốn gấp đôi.

Prompt text-to-image

1. Poster sự kiện ở 4K (đã thử)

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "Screen-printed concert poster for \"NORTHBOUND JAZZ FESTIVAL\". Big bold condensed headline at the top, a stylized upright bass and saxophone silhouette over a river at dusk in deep teal, burnt orange and cream. Below the art, the line \"JUNE 12-14 · RIVERSIDE PARK\" and a smaller line \"Three nights. Twenty-one bands. Free entry before 6 PM.\" Fine paper grain, crisp letterforms, generous margins.",
    "size": "2304x3072",
    "quality": "high",
    "n": 1
  }
}

Bậc: 4K high, 40 credit ($0.20). Đo được: task M4WA9OIQXVV80DHG trả về một PNG 2304×3072 với cả ba dòng hiển thị đúng như đã viết, kể cả dòng chữ nghiêng nhỏ. Ở dạng bản nháp, cùng prompt với "quality": "very_low" và "size": "3:4" trả về 768×1024 với giá 1.6 credit ($0.008), chữ đúng và bố cục khác.

2. Nhiều bản nháp bố cục trong một request

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "Minimal bookstore event flyer with the headline \"AUTHOR NIGHT\" in large serif capitals, the line \"Thursday 7 PM · Upstairs\" below it, and a simple line drawing of an open book. Off-white paper, black and brick red.",
    "size": "3:4",
    "quality": "very_low",
    "n": 8
  }
}

Bậc: 2K very_low, 8 × 1.6 = 12.8 credit ($0.064). Chọn bố cục bạn thích, rồi chạy lại ở high với kích thước lớn hơn.

3. Nhãn sản phẩm

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "Front label for a small-batch hot sauce bottle, flat design, centered. Top line \"CASA FUEGO\" in a hand-painted script, middle line \"SMOKED HABANERO\" in bold sans-serif capitals, bottom line \"5 FL OZ · 148 ML\" in small type. Red, cream and charcoal, with a small chili illustration.",
    "size": "1536x2048",
    "quality": "medium"
  }
}

Bậc: 2K medium (3,145,728 pixel), 12 credit ($0.06).

4. Sticker nền trong suốt có seed

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "A die-cut sticker of a cheerful cactus wearing sunglasses, with the words \"STAY SHARP\" on a curved banner underneath. Thick white outline, flat colors.",
    "size": "1:1 HD",
    "quality": "low",
    "background": "transparent",
    "seed": 42
  }
}

Bậc: 2K low, 6 credit ($0.03). transparent trả về ảnh có kênh alpha. Giữ nguyên seed và body để lặp lại kết quả.

5. Thẻ trích dẫn mạng xã hội tỷ lệ 4:5

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "Instagram quote card. Large centered quote \"Ship small. Ship often.\" in a modern grotesk typeface, and below it a small line \"— The Release Notes Podcast\". Solid sage green background with a thin cream border.",
    "size": "1024x1280",
    "quality": "medium",
    "n": 4
  }
}

Bậc: 2K medium, 4 × 12 = 48 credit ($0.24). 1024x1280 là kích thước 4:5 chính xác với cả hai cạnh là bội số của 32.

6. Thumbnail video tỷ lệ 16:9

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "YouTube thumbnail, bold and high contrast. Left half: the text \"I BUILT A TINY CABIN\" in thick white capitals with a black outline, stacked on three lines. Right half: a small wooden cabin in a snowy forest at blue hour, warm light in the windows.",
    "size": "2560x1440",
    "quality": "high"
  }
}

Bậc: 2K high (3,686,400 pixel), 20 credit ($0.10). Kích thước 16:9 chính xác lớn nhất phía trên nó, 4096x2304, sẽ tốn 40 credit.

7. Cảnh mặt tiền cửa hàng có biển hiệu

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "Photograph of a corner bakery at sunrise, wet cobblestones, a hand-painted wooden sign above the door reading \"MORNING CRUMB\", and a chalkboard by the door reading \"Fresh rye today\". Natural light, 35mm look.",
    "size": "16:9",
    "quality": "medium"
  }
}

Bậc: 2K medium, 12 credit ($0.06). Preset 16:9 trả về 1024×576; hãy dùng kích thước tùy chỉnh như 2048x1152 để có nhiều chi tiết hơn ở cùng bậc giá.

Prompt chỉnh sửa

Chỉnh sửa dùng ideogram-v4.6-edit với đúng một ảnh trong image_urls. Trang của Ideogram gợi ý sửa câu chữ theo từng bước riêng, nên hãy giao cho mỗi lần chỉnh sửa một việc và nói rõ những gì phải giữ nguyên.

8. Đổi một dòng chữ, giữ nguyên mọi thứ khác

{
  "model": "ideogram-v4.6-edit",
  "input": {
    "prompt": "Change only the date line to \"JULY 3-5 · RIVERSIDE PARK\". Keep everything else exactly the same.",
    "image_urls": [
      "https://example.com/northbound-poster.png"
    ],
    "edit_precision": "high",
    "context_window": "none",
    "size": "auto",
    "quality": "high",
    "n": 1
  }
}

Bậc: theo kích thước ảnh nguồn. Đo được: trên poster 2304×3072 của chúng tôi (task 672JRU198S22NS8D), ảnh đầu ra giữ nguyên 2304×3072, mọi pixel thay đổi đều nằm trong một khung quanh dòng ngày, khoảng 1.1% diện tích ảnh, và phí là 120 credit ($0.60). Với ảnh nguồn từ 4,194,304 pixel trở xuống, phí sẽ là 44 credit ($0.22).

9. Đổi màu sản phẩm sang màu thương hiệu

{
  "model": "ideogram-v4.6-edit",
  "input": {
    "prompt": "Recolor the ceramic mug to the exact brand blue #1E6FD9. Keep the mug's shape, handle, shadows, the table and the background exactly the same.",
    "image_urls": [
      "https://example.com/mug.png"
    ],
    "edit_precision": "high",
    "quality": "medium"
  }
}

Bậc: chỉnh sửa medium, 12 credit ($0.06) cho ảnh nguồn tối đa 4,194,304 pixel, 40 credit nếu lớn hơn. Ideogram báo cáo 83% kết quả dùng được ở tác vụ "exact color" của họ ở chất lượng cao, tăng từ 46% trên Ideogram 4.5.

10. Đổi chất liệu theo ảnh tham chiếu

{
  "model": "ideogram-v4.6-edit",
  "input": {
    "prompt": "Change the toy car's body to brushed copper like the reference image. Keep the scene, lighting and camera angle the same.",
    "image_urls": [
      "https://example.com/toy-car.png"
    ],
    "reference_image_urls": [
      "https://example.com/copper-swatch.png"
    ],
    "quality": "low",
    "n": 2
  }
}

Bậc: chỉnh sửa thông thường ở low, 2 × 6 = 12 credit ($0.06) cho ảnh đầu ra tối đa 4,194,304 pixel. Chỉnh sửa thông thường tạo lại ảnh, nên cho phép background và size tùy chỉnh; hãy chuyển sang edit_precision: high khi phần còn lại phải giữ chính xác đến từng pixel.

Biến prompt thành template

Phần lớn ứng dụng không gửi một prompt cố định; chúng điền vào template tên sự kiện, sản phẩm hoặc ngày tháng của người dùng. Hãy giữ các chuỗi trong ngoặc kép thành các biến riêng để bạn có thể xác thực chúng trước khi request được gửi đi, và để một lần chỉnh sửa sau đó (prompt 8) có thể nhắm vào một chuỗi bằng đúng câu chữ của nó. Một vài quy tắc giúp template rẻ và dễ đoán:

  • Escape dấu ngoặc kép trong văn bản người dùng. Prompt là một chuỗi JSON, nên một dấu " lạc chỗ sẽ làm hỏng body. Hãy dựng body bằng thư viện JSON thay vì nối chuỗi.
  • Giữ chữ ngắn gọn. Câu dài trên ảnh nhỏ khó đọc hơn và khó kiểm tra hơn. Chuyển chữ nhỏ xuống dòng thứ hai với mô tả kích thước riêng.
  • Cố định kích thước theo định dạng. Lưu một kích thước cho mỗi loại đầu ra (poster, thẻ, thumbnail) và đối chiếu nó với ngưỡng 4,194,304 pixel để giá bạn hiển thị cho người dùng khớp với hóa đơn.
  • Ghi log task ID, thiết lập và credits_amount. Khi một kết quả cần sửa, bạn có thể chạy lại cùng body hoặc gửi ảnh đầu ra sang chỉnh sửa mà không phải đoán thứ gì đã tạo ra nó.
  • Nháp bằng n, hoàn thiện bằng một ảnh. Một loạt bản nháp very_low tốn ít hơn một ảnh high 2K duy nhất, và chỉ bố cục được chọn mới đi tiếp sang bước render cuối.

Danh sách kiểm tra trước khi mở rộng một prompt

Kiểm traLý do
Mọi chuỗi trên ảnh đều nằm trong ngoặc képQuy tắc của tài liệu cho chữ chính xác
Kích thước tùy chỉnh là bội số của 32, từ 256 đến 4096 mỗi cạnhCác kích thước khác bị từ chối
very_low chỉ ở mức 4,194,304 pixel trở xuốngKích thước lớn hơn sẽ từ chối nó
edit_precision: high và mask dùng size: autoCác kích thước khác bị từ chối
Ảnh đầu ra được tải xuống trong vòng 3 ngàyFile được tạo sẽ hết hạn

Hướng dẫn Ideogram 4.6 API có vòng lặp polling chạy được bất kỳ body nào ở trên, và hướng dẫn chữ trên ảnh và chỉnh sửa chính xác đi sâu hơn vào các prompt 8 đến 10.

Câu hỏi thường gặp

Prompt Ideogram 4.6 API có thể dài bao nhiêu? 1 đến 10,000 ký tự, với ít nhất một ký tự không phải khoảng trắng.

Làm thế nào để có chữ chính xác trong ảnh Ideogram 4.6 API? Đặt mỗi dòng trong ngoặc kép trong prompt và mô tả vị trí của nó. Kiểm tra kết quả; mở rộng prompt có thể thêm những chi tiết nhỏ ngoài ý muốn.

Tôi có thể nhận nhiều biến thể từ một prompt Ideogram 4.6 API không? Có, đặt n từ 1 đến 8. Mỗi ảnh được tính theo giá của bậc.

Làm thế nào để lặp lại một kết quả Ideogram 4.6 API? Gửi cùng body với cùng seed, một số nguyên từ 0 đến 2,147,483,647.

Nên dùng chất lượng nào cho bản nháp Ideogram 4.6 API? very_low với 1.6 credit ($0.008) mỗi ảnh, ở kích thước tới 4,194,304 pixel. Bản nháp thử nghiệm của chúng tôi hiển thị đúng chữ trên poster ở 768×1024.

Share: