
Ideogram 4.6 API daje dostęp do najnowszego modelu obrazów od Ideogram przez jeden endpoint REST w PoYo: ideogram-v4.6 do generowania tekst-na-obraz i ideogram-v4.6-edit do edycji jednego obrazu źródłowego z opcjonalną maską i obrazami referencyjnymi. Wyniki mają do 4096 pikseli na bok, ceny zaczynają się od 1.6 credits ($0.008) za obraz, a każde żądanie używa tego samego klucza API co reszta PoYo. Ta strona opisuje, czym jest Ideogram 4.6, dokładne limity, progi cenowe i to, co zmierzyliśmy w dniu premiery.
Czym jest Ideogram 4.6?
Ideogram 4.6 to model do generowania i edycji obrazów od Ideogram, wydany 19 listopada 2026. Ideogram nazywa go „naszym najprecyzyjniejszym modelem do edycji” i twierdzi, że „generuje obrazy w natywnym 4K”, „bez upscalingu”. Na swojej stronie modelu Ideogram pisze też, że model „pozostawia znacznie mniej dryfu pikseli poza edytowanym obszarem i dokładniej zachowuje kolory”.
Ideogram popiera to wynikami zadań przy wysokiej jakości, porównując 4.6 z 4.5:
| Zadanie (opis Ideogram) | Ideogram 4.6 | Ideogram 4.5 |
|---|---|---|
| Dokładny kolor: przemalowanie obiektu na firmowy kod hex | 83% | 46% |
| Detal produktu: naprawa drobnej wady na zdjęciu produktu | 86% | 61% |
| Zdjęcia produktowe: aranżacja, zmiana stylu i etykiet produktów | 88% | 66% |
| Spójność postaci: osoba pozostaje rozpoznawalna w nowej scenie | 85% | 69% |
| Edycje z maską: zmiana tylko zamalowanego obszaru | 90% | 82% |
To liczby Ideogram, nie pomiary PoYo. Przy integracji przez API wskazują one trzy rodzaje żądań, które warto tu wysyłać:
- Plakaty, etykiety i grafiki do social mediów z dokładnymi słowami: umieść tekst w cudzysłowie w prompcie.
- Edycje, które nie mogą ruszać reszty: nowa data na ulotce, przemalowany produkt, jeden zmieniony detal.
- Duże wydruki: własne rozmiary do 4096 pikseli na bok bez osobnego kroku upscalingu.
Ideogram 4.6 API w skrócie
| Tekst-na-obraz | Edycja | |
|---|---|---|
| ID modelu w PoYo | ideogram-v4.6 | ideogram-v4.6-edit |
| Endpoint wysyłania | POST https://api.poyo.ai/api/generate/submit | Ten sam |
| Wynik | Odpytuj GET /api/generate/status/{task_id} albo użyj callback_url | Tak samo |
| Wejście | prompt | prompt + dokładnie jeden obraz w image_urls, opcjonalnie mask_url i reference_image_urls |
| Obrazów na żądanie | Od 1 do 8 (n) | Od 1 do 8 (n) |
| Poziomy jakości | very_low, low, medium (domyślnie), high | Te same |
| Premiera u Ideogram | 19 listopada 2026 | 19 listopada 2026 |
| Dokumentacja | Dokumentacja Ideogram V4.6 API | Dokumentacja Ideogram V4.6 Edit |
Oba ID współdzielą uwierzytelnianie, odpytywanie i rozliczenia, więc aplikacja może generować jednym i dopracowywać drugim bez drugiej integracji.
Limity i pola żądania
| Pole | Reguła w PoYo |
|---|---|
prompt | Wymagane, od 1 do 10,000 znaków, musi zawierać tekst inny niż białe znaki. Dokładny tekst na obrazie umieść w cudzysłowie. |
size | auto (domyślnie), 1:1 (512×512), 1:1 HD (1024×1024), 4:3, 3:4, 16:9, 9:16 albo własny WIDTHxHEIGHT |
| Własny rozmiar | Mała litera x, oba boki od 256 do 4096 pikseli i wielokrotności 32, proporcje w zakresie od 1:6 do 6:1 |
quality | very_low, low, medium (domyślnie), high; very_low tylko do 4,194,304 pikseli |
n | Liczba całkowita od 1 do 8 |
background | transparent lub opaque; tylko tekst-na-obraz i zwykłe edycje |
seed | Liczba całkowita od 0 do 2,147,483,647 |
image_urls (edycja) | Dokładnie jeden obraz źródłowy, publiczny URL HTTP(S) lub base64 data URI, zawsze tablica |
mask_url (edycja) | Te same wymiary co źródło; czarne jest edytowane, białe zachowane; wymaga size: auto |
reference_image_urls (edycja) | Od 0 do 4 obrazów lub najwyżej 3 z maską |
edit_precision (edycja) | regular (domyślnie) lub high; high wymaga size: auto i odrzuca background |
context_window (edycja) | none (domyślnie) lub auto; auto wymaga mask_url i edit_precision: high |
Każde inne pole wewnątrz input jest odrzucane z błędem unsupported fields. Wygenerowane pliki są dostępne przez 3 dni, więc kopiuj je do własnego magazynu.
Cennik Ideogram 4.6 API
PoYo rozlicza każdy obraz wyjściowy według jakości i progu rozmiaru. „2K” oznacza wynik do 4,194,304 pikseli (powierzchnia 2048×2048); wszystko większe to „4K”. 1 credit = $0.005.
| Jakość | Tekst-na-obraz 2K | Tekst-na-obraz 4K | Edycja 2K | Edycja 4K |
|---|---|---|---|---|
very_low | 1.6 credits ($0.008) | niedostępne | 1.6 credits ($0.008) | niedostępne |
low | 6 credits ($0.03) | 12 credits ($0.06) | 6 credits ($0.03) | 12 credits ($0.06) |
medium | 12 credits ($0.06) | 24 credits ($0.12) | 12 credits ($0.06) | 40 credits ($0.20) |
high | 20 credits ($0.10) | 40 credits ($0.20) | 44 credits ($0.22) | 120 credits ($0.60) |
size: auto i sześć presetów to przy tekst-na-obraz zawsze 2K. Przy edycjach z size: auto wynik zachowuje geometrię źródła, więc duże źródło trafia do progu 4K. Te ceny zgadzają się z tabelą cen za obraz na stronie modelu Ideogram; rozbicie cen przelicza prawdziwe warianty żądań.
Co zmierzyliśmy w dniu premiery
Zespół PoYo wykonał te żądania na produkcyjnym API PoYo 20 listopada 2026. Prompt opisywał plakat w stylu sitodruku „NORTHBOUND JAZZ FESTIVAL” z wierszami „JUNE 12-14 · RIVERSIDE PARK” i „Three nights. Twenty-one bands. Free entry before 6 PM.”
| Zadanie | Żądanie | Wynik | Pobrano |
|---|---|---|---|
M4WA9OIQXVV80DHG | ideogram-v4.6, quality: high, size: 2304x3072, n: 1 | Jeden PNG 2304×3072, ok. 10.8 MB | 40 credits ($0.20) |
BS7M64COKT80JSLX | Ten sam prompt, quality: very_low, size: 3:4 | PNG 768×1024 | 1.6 credits ($0.008) |
672JRU198S22NS8D | ideogram-v4.6-edit na pierwszym plakacie, edit_precision: high, context_window: none, size: auto, quality: high | PNG 2304×3072 | 120 credits ($0.60) |
Cały tekst na dwóch pierwszych plakatach wyszedł zgodnie z zapisem, łącznie z małym wierszem kursywą; szkic miał inną kompozycję. Prompt edycji brzmiał: Change only the date line to "JULY 3-5 · RIVERSIDE PARK". Keep everything else exactly the same. Porównanie pikseli z oryginałem wykazało, że każdy zmieniony piksel leży w jednym prostokącie, od (471, 2699) do (1826, 2756), czyli ok. 1.1% obrazu; reszta pozostała bez zmian. Edycja poszła według stawki 4K high, bo edycja wysokiej precyzji zachowuje rozdzielczość źródła. Poradnik o tekście i precyzyjnych edycjach omawia to żądanie krok po kroku.
Twoje pierwsze żądanie do Ideogram 4.6 API
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 to 6,291,456 pikseli, więc to żądanie jest rozliczane według stawki 4K high: 2 × 40 = 80 credits ($0.40). Odpowiedź zawiera data.task_id ze statusem not_started. Odpytuj endpoint statusu, aż zwróci finished, i odczytaj obrazy z data.files, albo przekaż callback_url na najwyższym poziomie. Zawsze sprawdzaj code w ciele odpowiedzi: niektóre błędy walidacji zwracają HTTP 200 z code: 400. Poradnik API zawiera ograniczoną czasowo pętlę odpytywania w Pythonie i ciało żądania dla każdego trybu wejścia.
Gdzie Ideogram 4.6 jest dostępny
Ideogram udostępnia 4.6 we własnej aplikacji i API, z dwoma endpointami: Generate i Precise Edit. W PoYo wywołujesz go kluczem, którego używasz do każdego innego modelu, tym samym przepływem zadań i callbacków, a na stronie modelu jest Playground, który pokazuje cenę przed każdym uruchomieniem. W PoYo obrazy referencyjne przechodzą przez ideogram-v4.6-edit; ID tekst-na-obraz przyjmuje tylko prompt oraz parametry rozmiaru, jakości, n, background i seed.
Które żądania kierować dokąd
| Żądanie | ID modelu i ustawienia |
|---|---|
| Szkice i szukanie układu | ideogram-v4.6, very_low lub low, rozmiar z presetu, n do 8 |
| Finalne plakaty i grafiki social o powierzchni do 2048×2048 | ideogram-v4.6, high, własny rozmiar, np. 1728x2304 |
| Druk i grafika wielkoformatowa | ideogram-v4.6, od low do high, własny rozmiar powyżej 4,194,304 pikseli |
| Zmiana jednego detalu z zachowaniem reszty | ideogram-v4.6-edit, edit_precision: high |
| Przemalowanie jednego obszaru dużego obrazu | ideogram-v4.6-edit, mask_url, edit_precision: high, context_window: auto |
| Zmiana stylu według referencji, nowy rozmiar wyniku | ideogram-v4.6-edit, edit_precision: regular, reference_image_urls, własny size |
Przechodzisz z Ideogram 4.5? Porównanie 4.6 z 4.5 wymienia zmiany pól, nowe reguły rozmiarów i cenę tego samego żądania. Jeśli porównujesz inne API obrazów w PoYo, zobacz przegląd MAI Image 2.7 API oraz porównanie Kling Image 4.0, GPT Image 2.6 i Seedream 5.5.
Najczęściej zadawane pytania
Jakie jest ID modelu w Ideogram 4.6 API?
Użyj ideogram-v4.6 do tekst-na-obraz i ideogram-v4.6-edit do edycji. ideogram-4-6 to tylko slug strony w PoYo, a nie ID modelu.
Ile kosztuje Ideogram 4.6 API?
Od 1.6 credits ($0.008) za obraz przy very_low 2K. Domyślny obraz medium 2K kosztuje 12 credits ($0.06), high to 20 credits ($0.10) w 2K i 40 credits ($0.20) w 4K. Edycje 4K wysokiej jakości kosztują 120 credits ($0.60).
Jaki jest największy obraz, jaki może zwrócić Ideogram 4.6 API? Własne rozmiary sięgają 4096 pikseli na bok, w wielokrotnościach 32, z proporcjami od 1:6 do 6:1. Wszystko powyżej 4,194,304 pikseli jest rozliczane według progu 4K.
Czy Ideogram 4.6 API renderuje tekst na obrazach? Tak, umieść dokładne słowa w cudzysłowie w prompcie. W naszym teście z dnia premiery plakat 2304×3072 wyrenderował nagłówek, wiersz z datą i mały wiersz kursywą zgodnie z zapisem. Ideogram nadal radzi sprawdzać pisownię i rozmieszczenie w finalnym wyniku.
Czy Ideogram 4.6 API może zwracać obrazy z przezroczystym tłem?
Tak. Ustaw background na transparent przy tekst-na-obraz lub zwykłych edycjach. Edycje wysokiej precyzji odrzucają background.
Czy Ideogram 4.6 API jest zgodne z OpenAI SDK?
Nie. To asynchroniczne API zadań: wyślij żądanie do /api/generate/submit, a następnie odpytuj /api/generate/status/{task_id} albo odbierz callback.