레퍼런스 이미지 한 장으로 일관된 캐릭터를 생성하는 모델입니다. 실사부터 픽션까지 다양한 스타일로 동일 캐릭터를 렌더링하고, 마스크 인페인팅으로 기존 사진에 캐릭터를 삽입할 수 있으며, Ideogram 특유의 강점인 정확한 텍스트 렌더링까지 지원합니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "ideogram-ai/ideogram-character",
"input": {
"prompt": "a close up photo of a woman in a fashion magazine photoshoot",
"resolution": "None",
"style_type": "Auto",
"aspect_ratio": "1:1",
"magic_prompt_option": "Auto",
"character_reference_image": "https://example.com/character.webp"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 이미지 생성을 위한 텍스트 프롬프트 |
mask | string | No | - | 흑백 마스크 이미지. 검은 픽셀은 인페인팅되고 흰 픽셀은 보존됨. 이미지 크기에 맞게 리사이즈됨 |
seed | integer | No | - | 랜덤 시드. 재현 가능한 생성을 위해 설정 |
image | string | No | - | 인페인팅에 사용할 이미지 파일. 반드시 mask와 함께 사용 |
resolution | string | No | None | 정확한 출력 해상도 (예: 1024x1024). 512x1536~1536x512 범위의 약 69개 프리셋 지원. aspect_ratio보다 우선하며 인페인팅 시 무시됨 None512x1536576x1408576x1472576x1536640x1344640x1408640x1472640x1536704x1152704x1216704x1280704x1344704x1408704x1472736x1312768x1088768x1216768x1280768x1344800x1280832x960832x1024832x1088832x1152832x1216832x1248864x1152896x960896x1024896x1088896x1120896x1152960x832960x896960x1024960x10881024x8321024x8961024x9601024x10241088x7681088x8321088x8961088x9601120x8961152x7041152x8321152x8641152x8961216x7041216x7681216x8321248x8321280x7041280x7681280x8001312x7361344x6401344x7041344x7681408x5761408x6401408x7041472x5761472x6401472x7041536x5121536x5761536x640 |
style_type | string | No | Auto | 캐릭터 스타일 타입 AutoFictionRealistic |
aspect_ratio | string | No | 1:1 | 화면 비율. resolution이나 인페인팅 이미지 지정 시 무시됨 1:33:11:22:19:1616:910:1616:102:33:23:44:34:55:41:1 |
rendering_speed | string | No | Default | 렌더링 속도. Turbo는 빠르고 저렴(300크레딧), Quality는 고품질·고가(600크레딧), Default는 균형형(450크레딧) DefaultTurboQuality |
magic_prompt_option | string | No | Auto | Magic Prompt가 프롬프트를 해석·최적화해 다양성과 품질을 높임. 다른 언어로 프롬프트 작성도 가능 AutoOnOff |
character_reference_image | string | Yes | - | 캐릭터 레퍼런스로 사용할 이미지 |
이 모델의 maskimagecharacter_reference_image 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=ideogram-ai/ideogram-character" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:mask=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "ideogram-ai/ideogram-character",
"input": {
"prompt": "your prompt here",
"mask": "https://example.com/image.jpg"
}
}POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
레퍼런스 캐릭터를 패션 매거진 화보 스타일로 렌더링
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "ideogram-ai/ideogram-character",
"input": {
"prompt": "a close up photo of a woman in a fashion magazine photoshoot",
"resolution": "None",
"style_type": "Auto",
"aspect_ratio": "1:1",
"magic_prompt_option": "Auto",
"character_reference_image": "https://example.com/character.webp"
}
}'Turbo 렌더링으로 장당 300크레딧까지 비용 절감
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "ideogram-ai/ideogram-character",
"input": {
"prompt": "the character as a barista pouring latte art in a cozy cafe, warm lighting",
"rendering_speed": "Turbo",
"style_type": "Realistic",
"aspect_ratio": "3:4",
"character_reference_image": "https://example.com/character.webp"
}
}'