Hermes Agent에서 Ideogram V3를 사용하세요.
Ideogram V3는 업계 최고 수준의 텍스트 렌더링으로 이미지를 생성합니다 — 다른 이미지 모델이 어려워하는 포스터, 로고, 간판의 읽기 쉬운 타이포그래피. text_to_image, edit_image, remix_image 세 가지 엔드포인트와 생성 시간을 절반으로 줄이는 turbo 속도 티어를 제공합니다. Hermes Agent는 채팅에 사용하는 동일한 RunAPI 커스텀 프로바이더와 API key로 호출합니다 — 추가 플러그인 설치가 필요 없습니다.
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"
}
Hermes Agent에서 Ideogram V3를 세 단계로 사용하기
RunAPI 설정
쉘 프로필에 RUNAPI_API_KEY 환경 변수를 설정하세요. Hermes Agent에서 채팅용 custom:runapi 프로바이더가 이미 설정되어 있다면, 동일한 key가 Ideogram V3에도 작동합니다 — 추가 설정이 필요 없습니다.
export RUNAPI_API_KEY=runapi_xxx
Ideogram V3 호출
model을 ideogram-v3-text-to-image로 설정하여 text_to_image 엔드포인트에 POST 요청을 보내세요. 이미지에 렌더링하고 싶은 텍스트를 포함한 프롬프트를 작성하세요. 포스터와 로고 작업에는 style을 design으로, 사진 출력에는 realistic으로 설정하세요. 낮은 비용으로 빠른 결과를 얻으려면 rendering_speed turbo를 사용하세요.
POST /v1/text_to_image
결과 가져오기
API는 즉시 task_id를 반환합니다. 상태가 completed로 변경될 때까지 작업 상태 엔드포인트를 폴링한 후 응답에서 출력 이미지 URL을 가져오세요. output_count로 한 번의 호출당 최대 4개의 이미지를 요청하세요.
task_id: tsk_abc123
Ideogram V3 API 파라미터
| 파라미터 | 유형 | 설명 |
|---|---|---|
model |
string |
필수. ideogram-v3-text-to-image, ideogram-v3-edit, 또는 ideogram-v3-remix. |
prompt |
string |
원하는 이미지의 텍스트 설명. 렌더링하고 싶은 특정 텍스트를 포함하세요. |
style |
string |
선택 사항. auto, general, realistic, 또는 design. 포스터와 로고에는 design을 사용하세요. |
rendering_speed |
string |
선택 사항. turbo (가장 빠름, 최저 비용), balanced (기본값), 또는 quality (최고 디테일). |
aspect_ratio |
string |
선택 사항. 1:1, 3:4, 9:16, 4:3, 또는 16:9. |
output_count |
integer |
선택 사항. 요청당 생성할 이미지 수. 1~4. |
source_image_url |
string |
편집 및 리믹스 엔드포인트에 필수. 소스 이미지의 URL. |
Hermes Agent의 Ideogram V3이란?
Ideogram V3은 상업적 작업에 적합한 실용적인 디자인 도구로 깔끔하고 상업적으로 사용 가능한 이미지를 만들어냅니다. 편집·리믹스·Turbo 속도 티어를 지원하며 작업별로 비용과 품질을 조정할 수 있습니다. Hermes Agent는 RunAPI custom provider를 통해 호출합니다.
Ideogram V3 활용 사례
클라이언트 납품물을 위한 상업 디자인
배너·커버 이미지·마케팅 소재의 클라이언트에게 직접 납품 가능한 전문 디자인을 생성하며, 너무 예술적인 출력물을 대량으로 수동 조정할 필요가 없습니다.
텍스트 오버레이가 있는 소셜 미디어 콘텐츠
정확한 텍스트 오버레이가 있는 Instagram·LinkedIn·Twitter SNS 게시물 비주얼을 일괄 생성하며, Ideogram의 높은 텍스트 정확도가 한 번에 성공을 보장합니다.
멀티 포맷 브랜드 스위트
Hermes Agent 워크플로에서 동일한 브랜드 에셋에 대해 여러 포맷——가로·세로·정사각형——을 생성하며, Ideogram의 리믹스 모드로 포맷 간 비주얼 일관성을 유지합니다.
Ideogram V3 + Hermes Agent 자주 묻는 질문
Ideogram V3는 타이포그래피 렌더링에 특화되어 있습니다. Flux나 Imagen 같은 모델이 자주 뭉개는 읽기 가능한 다줄 텍스트, 스타일화된 헤딩, 로고 품질의 레터링을 생성할 수 있습니다. 포스터, 간판, 제품 라벨에 정확한 텍스트가 필요한 경우 Ideogram V3가 RunAPI 카탈로그에서 가장 강력한 옵션입니다.
Turbo는 balanced 비용의 약 절반으로 가장 빠르게 생성합니다. Quality는 가장 높은 디테일의 출력을 생성하지만 더 오래 걸립니다. Balanced는 기본값인 중간 지점입니다. 세 티어 모두 동일한 Ideogram V3 모델을 사용합니다 — 차이는 컴퓨팅 시간과 품질이지, 모델 버전이 아닙니다.
Hermes Agent 프로바이더 설정에 base_url https://runapi.ai/v1과 RUNAPI_API_KEY를 사용하여 커스텀 프로바이더를 추가하세요. 설정이 완료되면 동일한 프로바이더를 통해 모든 RunAPI 엔드포인트 — text_to_image, edit_image, remix_image — 를 호출하세요. hermes doctor를 실행하여 연결을 확인하세요.
네. model을 ideogram-v3-remix로 설정하여 remix_image 엔드포인트를 사용하세요. 스타일 참조 이미지와 함께 source_image_url을 전달한 후 프롬프트에서 새 구성을 설명하세요. 출력은 텍스트 프롬프트의 콘텐츠를 따르면서 소스의 시각적 스타일을 상속합니다. style을 design, realistic, 또는 general로 설정하여 출력을 더 세밀하게 가이드할 수도 있습니다.
생성된 각 이미지는 별도로 청구됩니다. output_count를 4로 설정하면 4개의 이미지에 대해 요금이 부과됩니다. 이미지당 요금은 rendering_speed 설정에 따라 다릅니다 — turbo는 balanced의 약 절반 비용입니다. 현재 요금은 RunAPI 가격 페이지를 확인하세요. 실패한 생성은 청구되지 않습니다.
지금 Hermes Agent에서 Ideogram V3를 사용해보세요.
무료 RunAPI key를 발급받고, custom:runapi 프로바이더를 설정하여 Ideogram V3로 정확한 타이포그래피 이미지 생성을 시작하세요.