guides

Ideogram 4.6 API: czym jest Ideogram 4.6, ceny, limity i edycje w 4K

Poyo.ai Team
8 min read
Share:

Ideogram 4.6 API w PoYo

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.6Ideogram 4.5
Dokładny kolor: przemalowanie obiektu na firmowy kod hex83%46%
Detal produktu: naprawa drobnej wady na zdjęciu produktu86%61%
Zdjęcia produktowe: aranżacja, zmiana stylu i etykiet produktów88%66%
Spójność postaci: osoba pozostaje rozpoznawalna w nowej scenie85%69%
Edycje z maską: zmiana tylko zamalowanego obszaru90%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-obrazEdycja
ID modelu w PoYoideogram-v4.6ideogram-v4.6-edit
Endpoint wysyłaniaPOST https://api.poyo.ai/api/generate/submitTen sam
WynikOdpytuj GET /api/generate/status/{task_id} albo użyj callback_urlTak samo
Wejściepromptprompt + dokładnie jeden obraz w image_urls, opcjonalnie mask_url i reference_image_urls
Obrazów na żądanieOd 1 do 8 (n)Od 1 do 8 (n)
Poziomy jakościvery_low, low, medium (domyślnie), highTe same
Premiera u Ideogram19 listopada 202619 listopada 2026
DokumentacjaDokumentacja Ideogram V4.6 APIDokumentacja 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

PoleReguła w PoYo
promptWymagane, od 1 do 10,000 znaków, musi zawierać tekst inny niż białe znaki. Dokładny tekst na obrazie umieść w cudzysłowie.
sizeauto (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 rozmiarMała litera x, oba boki od 256 do 4096 pikseli i wielokrotności 32, proporcje w zakresie od 1:6 do 6:1
qualityvery_low, low, medium (domyślnie), high; very_low tylko do 4,194,304 pikseli
nLiczba całkowita od 1 do 8
backgroundtransparent lub opaque; tylko tekst-na-obraz i zwykłe edycje
seedLiczba 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 2KTekst-na-obraz 4KEdycja 2KEdycja 4K
very_low1.6 credits ($0.008)niedostępne1.6 credits ($0.008)niedostępne
low6 credits ($0.03)12 credits ($0.06)6 credits ($0.03)12 credits ($0.06)
medium12 credits ($0.06)24 credits ($0.12)12 credits ($0.06)40 credits ($0.20)
high20 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ŻądanieWynikPobrano
M4WA9OIQXVV80DHGideogram-v4.6, quality: high, size: 2304x3072, n: 1Jeden PNG 2304×3072, ok. 10.8 MB40 credits ($0.20)
BS7M64COKT80JSLXTen sam prompt, quality: very_low, size: 3:4PNG 768×10241.6 credits ($0.008)
672JRU198S22NS8Dideogram-v4.6-edit na pierwszym plakacie, edit_precision: high, context_window: none, size: auto, quality: highPNG 2304×3072120 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

ŻądanieID modelu i ustawienia
Szkice i szukanie układuideogram-v4.6, very_low lub low, rozmiar z presetu, n do 8
Finalne plakaty i grafiki social o powierzchni do 2048×2048ideogram-v4.6, high, własny rozmiar, np. 1728x2304
Druk i grafika wielkoformatowaideogram-v4.6, od low do high, własny rozmiar powyżej 4,194,304 pikseli
Zmiana jednego detalu z zachowaniem resztyideogram-v4.6-edit, edit_precision: high
Przemalowanie jednego obszaru dużego obrazuideogram-v4.6-edit, mask_url, edit_precision: high, context_window: auto
Zmiana stylu według referencji, nowy rozmiar wynikuideogram-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.

Share: