Używaj Ideogram V3 w Hermes Agent.
Ideogram V3 generuje obrazy z wiodącym w branży renderowaniem tekstu — czytelna typografia na plakatach, logotypach i szyldach, z którą inne modele obrazów sobie nie radzą. Oferuje trzy punkty końcowe (text_to_image, edit_image, remix_image) oraz tryb turbo, który skraca czas generowania o połowę przy niższych kosztach. Hermes Agent wywołuje go przez tego samego niestandardowego dostawcę RunAPI i klucz API używany do czatu, bez konieczności instalowania dodatkowych wtyczek.
Use RunAPI to generate an image with accurate text rendering using Ideogram V3.
Requirements:
- Use the RunAPI API at https://runapi.ai/v1/text_to_image.
- Read the API key from RUNAPI_API_KEY environment variable.
- Use the custom:runapi provider already configured in Hermes Agent.
- Set the model to "ideogram-v3-text-to-image".
- Write a prompt that includes specific text you want rendered in the image.
- Optionally set rendering_speed to turbo for faster generation, or quality for best results.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the output URL.
curl -X POST https://runapi.ai/v1/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v3-text-to-image",
"prompt": "A minimalist cafe menu poster, cream background, the text FRESH BREWED written in elegant serif font at the top, three coffee cup illustrations below, warm earth tones",
"style": "design",
"aspect_ratio": "3:4",
"rendering_speed": "balanced"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "ideogram-v3-text-to-image"
}
Używaj Ideogram V3 w Hermes Agent w trzech krokach
Skonfiguruj RunAPI
Ustaw zmienną środowiskową RUNAPI_API_KEY w profilu powłoki. Jeśli dostawca custom:runapi jest już skonfigurowany w Hermes Agent do czatu, ten sam klucz działa dla Ideogram V3 — nie jest potrzebna żadna dodatkowa konfiguracja.
export RUNAPI_API_KEY=runapi_xxx
Wywołaj Ideogram V3
Wyślij żądanie POST do punktu końcowego text_to_image z modelem ustawionym na ideogram-v3-text-to-image. Dołącz swój prompt z dowolnym tekstem, który chcesz wyrenderować na obrazie. Ustaw style na design do pracy z plakatami i logotypami lub realistic do wyjścia fotograficznego. Użyj rendering_speed turbo, aby uzyskać szybsze wyniki przy niższym koszcie.
POST /v1/text_to_image
Pobierz wynik
API natychmiast zwraca task_id. Odpytuj punkt końcowy statusu zadania, aż status zmieni się na completed, a następnie pobierz adres URL wyjściowego obrazu z odpowiedzi. Żądaj do 4 obrazów na wywołanie za pomocą output_count.
task_id: tsk_abc123
Parametry API Ideogram V3
| Parametr | Typ | Opis |
|---|---|---|
model |
string |
Wymagane. ideogram-v3-text-to-image, ideogram-v3-edit lub ideogram-v3-remix. |
prompt |
string |
Opis tekstowy pożądanego obrazu. Uwzględnij konkretny tekst, który chcesz wyrenderować. |
style |
string |
Opcjonalne. auto, general, realistic lub design. Użyj design do plakatów i logotypów. |
rendering_speed |
string |
Opcjonalne. turbo (najszybszy, najniższy koszt), balanced (domyślny) lub quality (najwyższa szczegółowość). |
aspect_ratio |
string |
Opcjonalne. 1:1, 3:4, 9:16, 4:3 lub 16:9. |
output_count |
integer |
Opcjonalne. Liczba obrazów do wygenerowania w jednym żądaniu. Od 1 do 4. |
source_image_url |
string |
Wymagane dla punktów końcowych edit i remix. Adres URL obrazu źródłowego. |
Czym jest Ideogram V3 w Hermes Agent?
Ideogram V3 to praktyczne narzędzie projektowe, które użytkownicy określają jako "sweet spot" dla dokładności typografii i jakości wizualnej. Hermes Agent wywołuje go przez RunAPI custom provider dla zadań projektowych w zautomatyzowanych workflow'ach.
Zastosowania Ideogram V3
Projekt koszulek i merchandisingu
Generuj gotowe do druku projekty merchandisingu ze sloganami, cytatami i graficznymi elementami tekstowymi.
Wsadowa produkcja materiałów marketingowych
Twórz zestawy materiałów marketingowych — plakaty, karty społecznościowe, banery — ze spójnym stylem marki.
Projektowanie ikon i infografik
Generuj zestawy ikon i bogate w dane infografiki, gdzie każdy element tekstowy jest precyzyjny.
Pytania o Ideogram V3 + Hermes Agent
Ideogram V3 jest specjalnie zoptymalizowany pod kątem renderowania typografii. Może generować czytelny tekst wieloliniowy, stylizowane nagłówki i napisy o jakości logo, z którymi modele takie jak Flux czy Imagen często sobie nie radzą. Jeśli Twoje zastosowanie wymaga precyzyjnego tekstu na plakatach, szyldach lub etykietach produktów, Ideogram V3 jest najmocniejszą opcją w katalogu RunAPI.
Turbo generuje najszybciej i kosztuje mniej więcej połowę ceny trybu balanced. Quality daje najwyższą jakość, ale trwa dłużej. Balanced to domyślny kompromis. Wszystkie trzy tryby korzystają z tego samego modelu Ideogram V3 — różnica dotyczy czasu obliczeń i wierności, nie wersji modelu.
Dodaj niestandardowego dostawcę z base_url https://runapi.ai/v1 i swoim RUNAPI_API_KEY w konfiguracji dostawcy Hermes Agent. Po skonfigurowaniu wywołuj dowolny punkt końcowy RunAPI — text_to_image, edit_image, remix_image — przez tego samego dostawcę. Uruchom hermes doctor, aby zweryfikować połączenie.
Tak. Użyj punktu końcowego remix_image z modelem ustawionym na ideogram-v3-remix. Przekaż source_image_url z obrazem referencyjnym stylu, a następnie opisz nową kompozycję w prompcie. Wyjście dziedziczy styl wizualny źródła, podążając jednocześnie za promptem tekstowym w kwestii treści. Możesz również ustawić style na design, realistic lub general, aby dalej kierować wyjściem.
Każdy wygenerowany obraz jest rozliczany oddzielnie. Jeśli ustawisz output_count na 4, zostaniesz obciążony za 4 obrazy. Cena za obraz zależy od ustawienia rendering_speed — tryb turbo kosztuje mniej więcej połowę trybu balanced. Sprawdź stronę cenową RunAPI, aby zobaczyć aktualne stawki. Nieudane generowania nie są rozliczane.
Ogólna konfiguracja Hermes Agent
Nie skonfigurowano jeszcze? Zacznij od przewodnika konfiguracji RunAPI dla Hermes Agent.
Przewodnik konfiguracji Hermes Agent →Katalog modeli Ideogram V3
Zobacz wszystkie warianty Ideogram V3, ceny i dokumentację API.
Modele Ideogram V3 →Wypróbuj Ideogram V3 w Hermes Agent już dziś.
Zdobądź darmowy klucz RunAPI, skonfiguruj dostawcę custom:runapi i zacznij generować obrazy z precyzyjną typografią za pomocą Ideogram V3.