소개
Ideogram Character는 Ideogram이 2025년 7월 29일 공개한 일관성 모델입니다. 이 엔드포인트는 그 생성 모드로, 인물 사진 한 장을 올리고 아직 없는 장면을 적으면 모델이 그 사람을 장면 속에 그려 넣습니다. 요청 사이에 학습이나 저장은 없으므로, 매번 보낸 사진에서 다시 얼굴을 읽습니다.
핵심 기능 및 하이라이트
한 장으로 닮게 그리기
모델은 참고 사진 한 장에서 얼굴형, 눈매, 헤어라인, 머리 모양을 읽어 새로운 빛, 의상, 카메라 각도로 옮깁니다. 테스트에서 턱선 길이의 검은 단발과 일자 앞머리를 가진 여성의 프로필 사진은 밤의 발코니에서도, 분장실 거울 앞에서도, 그림으로 그린 펄프 소설 표지에서도 그 머리 모양과 앞머리를 유지했습니다.
세 가지 속도 단계와 세 가지 스타일
Turbo, Balanced, Quality는 렌더링 시간, 디테일, 가격을 바꾸고, Auto, Realistic, Fiction은 가격은 그대로 두고 분위기를 바꿉니다. 테스트에서 Turbo 이미지는 약 20~35초, 두 장짜리 Balanced는 약 54초, Quality 한 장은 약 62초 만에 돌아왔습니다. 받은 결과는 모두 992×992 WebP였습니다.
한 번에 여러 장
num_outputs로 같은 프롬프트와 인물 사진에서 최대 4장을 받습니다. 닮은 정도는 장마다 조금씩 다르므로, Turbo로 2~4장을 뽑는 것이 최종 렌더링 전에 가장 닮은 한 장을 찾는 가장 저렴한 방법입니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 새 장면을 최대 5,000자로 적습니다. 장소, 옷차림, 포즈, 빛, 카메라. 1자 이상 · 5000자 이하 |
reference_image_urls | 예 | 유지할 인물의 사진 정확히 한 장. 얼굴을 가리지 않은 선명한 정면 사진이 가장 좋으며 JPEG, PNG, WebP 형식으로 10MB까지 받습니다. 1개 이상 · 1개 이하 |
quality | 아니요 | turbo, balanced(기본값), quality. 상위 단계일수록 오래 걸리고 장당 가격이 높습니다. |
style | 아니요 | auto(기본값)는 모델에 맡기고, realistic은 사진처럼, fiction은 일러스트와 양식화된 아트 쪽으로 이끕니다. 가격은 같습니다. |
num_outputs | 아니요 | 같은 프롬프트와 참고 사진으로 1~4장. 장마다 과금됩니다. |
enable_prompt_expansion | 아니요 | MagicPrompt는 기본으로 켜져 있어 짧은 프롬프트를 렌더링 전에 확장합니다. 긴 프롬프트를 그대로 따르게 하려면 끄세요. 기본값: |
negative_prompt | 아니요 | 빼고 싶은 요소를 최대 5,000자로 적는 선택 항목입니다. 본 프롬프트와 충돌하면 본 프롬프트가 우선합니다. 5000자 이하 |
seed | 아니요 | 선택 정수입니다. 같은 입력과 함께 다시 쓰면 한 가지만 바꾼 비교가 쉬워지지만, 같은 이미지가 나온다고 보장하지는 않습니다. |
요금
고른 단계(Turbo, Balanced, Quality)로 돌아온 이미지 한 장마다 과금합니다. 모델이 거부하거나 끝내지 못한 요청은 과금하지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.08 / 장 |
| $0.12 / 장 |
| $0.16 / 장 |
활용 사례
반복해서 등장하는 캐릭터
만화 컷, 동화책 펼침면, SNS 연재에는 매 장면 같은 주인공이 필요합니다. 확정한 인물 사진 한 장을 참고 사진으로 고정하고 이미지마다 장면 문장만 바꾸세요.
패션과 스타일링 초안
한 모델을 이브닝드레스, 맞춤 정장, 캐주얼한 거리 룩에 배치해 실제 촬영 전에 스타일링 방향을 비교하거나, 사진가에게 분위기와 빛을 전달할 수 있습니다.
피치와 스토리보드 컷
배우의 프로필 사진을 영화 기획의 주요 장면으로 옮깁니다. 밤의 발코니, 연기 자욱한 바, 비 내리는 거리. 그림으로 그린 보드에는 Fiction이, 스틸처럼 보여야 하는 무드 컷에는 Realistic이 어울립니다.
프롬프트 가이드 및 실전 팁
단어는 바뀌는 부분에 쓰기
얼굴은 이미 사진에서 오므로 프롬프트에서 묘사할 필요가 없습니다. 대신 장소, 의상, 포즈, 표정, 빛, 렌즈를 적고 인물은 the woman, the man, she로 부르세요. 다른 머리색이나 얼굴형을 적으면 참고 사진과 부딪혀 대개 닮은 정도가 떨어집니다.
깔끔한 참고 사진 준비
머리부터 어깨까지 자르고, 얼굴에 초점을 맞추고 빛을 고르게 하며, 선글라스, 마스크, 눈을 가리는 손이나 머리카락은 피하세요. 앞머리, 주근깨, 작은 점 같은 특징이 있으면 결과마다 확인할 기준이 됩니다.
저렴하게 반복한 뒤 올리기
Turbo로 2~4장을 뽑아 얼굴이 가장 잘 유지된 프롬프트와 시드를 고르고, 그 조합만 Balanced나 Quality로 다시 렌더링하세요. MagicPrompt는 기본으로 켜져 있으니, 길고 정확하게 쓴 프롬프트가 바뀌지 않기를 원하면 끄세요.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "ideogram/character/text-to-image",
"input": {
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "balanced",
"reference_image_urls": [
"https://example.com/reference.png"
],
"style": "auto"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.





