콘텐츠로 건너뛰기

Ideogram V3 Character Remix

통합

모델 id ideogram/character/remix
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/character/remix?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청: $0.15 150 API 크레딧 이 페이지에서 실행

API 키 받기
Ideogram 이미지 편집 참조 입력 #character-consistency

참조 캐릭터를 유지하면서 입력 이미지를 새로운 스타일이나 장면으로 리믹스하는 Ideogram V3

Ideogram · 이미지

첫 번째 결과가 여기에 표시됩니다

아래에서 요청을 작성하고 API 키로 실행하세요. 출력은 스토리지에 복사되며, 영구 보관하거나 7일 동안 무료로 보관할 수 있습니다.

요청 만들기

컨트롤은 모델 스키마에서 생성됩니다. 값을 변경하면 코드와 가격이 업데이트됩니다.

•필수

이미지 리믹스를 안내하는 데 사용하는 프롬프트입니다.

•필수 image_url
파일을 끌어다 놓거나

리믹스할 이미지의 URL입니다.

•필수
파일을 끌어다 놓거나

JPEG, PNG 또는 WebP 형식의 캐릭터 참조 이미지입니다. 모든 캐릭터 참조의 합산 제한은 10 MB입니다. 현재는 이미지 1개만 지원하며 추가 이미지는 무시됩니다.

rendering_speed 기본값 BALANCED

렌더링 속도 설정입니다.

image_size 기본값 square_hd

출력 이미지에 사용할 해상도입니다.

num_images 기본값 1

생성할 이미지 수입니다.

고급 negative_prompt · images · reference_mask_urls · style · strength · seed · expand_prompt · style_codes · color_palette
기본값

원하지 않는 이미지 콘텐츠를 지정합니다. 기본 프롬프트의 설명이 이러한 네거티브 프롬프트 설명보다 우선합니다.

image_urls
파일을 끌어다 놓거나

JPEG, PNG 또는 WebP 형식의 스타일 참조 이미지입니다. 전체 크기는 10 MB를 초과할 수 없습니다.

파일을 끌어다 놓거나

JPEG, PNG 또는 WebP 형식의 캐릭터 참조 마스크입니다. 모든 캐릭터 참조의 총 크기는 10 MB를 초과할 수 없습니다. 현재는 마스크 1개만 사용되며 추가 마스크는 무시됩니다.

style 기본값 AUTO

생성에 사용하는 스타일 유형이며, style_codes와 함께 사용할 수 없습니다.

기본값 0.8

리믹스에서 소스 이미지가 미치는 영향입니다.

난수 생성에 사용하는 시드 값입니다.

각각 8자의 16진수 문자열로 제공하는 이미지 스타일 코드입니다. 이 목록을 사용할 때는 style_reference_images와 style을 모두 생략하세요.

생성 중 사용하는 색상 팔레트입니다. 이름으로 프리셋을 지정하거나, 선택적으로 가중치를 포함한 members로 16진수 색상을 직접 지정할 수 있습니다.

POST /run/ideogram/character/remix?wait=20 견적 → $0.15
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/character/remix?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청 실행

키는 이 브라우저에 유지됩니다. Doitong API로만 전송되며, 기억하기를 선택한 경우에만 localStorage에 저장됩니다. API 키 받기

Ideogram V3 Character Remix 정보

`prompt`를 사용해 `image_url`을 리믹스하면서 `reference_image_urls`의 캐릭터(이미지 1개 사용)를 유지합니다. `strength`(0.01-1, 기본값 0.8)는 입력 이미지의 영향력을 제어합니다. `image_size` 프리셋, 스타일 참조, AUTO, REALISTIC 또는 FICTION 값의 `style`, 최대 8개의 이미지를 지원합니다.

매개변수

표준 이름이나 네이티브 이름 중 하나만 보내세요. 표준 이름

이름유형 기본값허용됨 설명
image_urls선택 사항 images
유형url[] · image
JPEG, PNG 또는 WebP 형식의 스타일 참조 이미지입니다. 전체 크기는 10 MB를 초과할 수 없습니다.
rendering_speed선택 사항
유형enum
기본값BALANCED
TURBOBALANCEDQUALITY
렌더링 속도 설정입니다.
color_palette선택 사항
유형object
생성 중 사용하는 색상 팔레트입니다. 이름으로 프리셋을 지정하거나, 선택적으로 가중치를 포함한 members로 16진수 색상을 직접 지정할 수 있습니다.
color_palette.members선택 사항
유형object[]
팔레트의 색상을 정의하는 팔레트 구성원 목록입니다.
color_palette.members[].rgb필수
유형object
RGB로 표현한 팔레트 구성원의 색상입니다.
color_palette.members[].color_weight선택 사항
유형number | null
기본값0.5
0.05 – 1
팔레트에서 이 색상에 할당된 가중치입니다.
color_palette.name선택 사항
유형enum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
색상 팔레트의 프리셋 선택입니다.
style_codes선택 사항
유형string[]
각각 8자의 16진수 문자열로 제공하는 이미지 스타일 코드입니다. 이 목록을 사용할 때는 style_reference_images와 style을 모두 생략하세요.
style선택 사항
유형enum
기본값AUTO
AUTOREALISTICFICTION
생성에 사용하는 스타일 유형이며, style_codes와 함께 사용할 수 없습니다.
expand_prompt선택 사항
유형boolean
기본값true
요청 생성에 사용하는 MagicPrompt 전환입니다.
num_images선택 사항 num_outputs
유형integer
기본값1
1 – 8
생성할 이미지 수입니다.
seed선택 사항
유형integer | null
난수 생성에 사용하는 시드 값입니다.
prompt필수
유형string
이미지 리믹스를 안내하는 데 사용하는 프롬프트입니다.
image_url필수 image
유형url · image
리믹스할 이미지의 URL입니다.
strength선택 사항
유형number
기본값0.8
0.01 – 1
리믹스에서 소스 이미지가 미치는 영향입니다.
image_size선택 사항
유형object
기본값square_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
출력 이미지에 사용할 해상도입니다.
negative_prompt선택 사항
유형string
기본값
원하지 않는 이미지 콘텐츠를 지정합니다. 기본 프롬프트의 설명이 이러한 네거티브 프롬프트 설명보다 우선합니다.
reference_image_urls필수
유형url[] · image
JPEG, PNG 또는 WebP 형식의 캐릭터 참조 이미지입니다. 모든 캐릭터 참조의 합산 제한은 10 MB입니다. 현재는 이미지 1개만 지원하며 추가 이미지는 무시됩니다.
reference_mask_urls선택 사항
유형url[] · image
JPEG, PNG 또는 WebP 형식의 캐릭터 참조 마스크입니다. 모든 캐릭터 참조의 총 크기는 10 MB를 초과할 수 없습니다. 현재는 마스크 1개만 사용되며 추가 마스크는 무시됩니다.
필수 표준 이름, 사용 가능

파일 매개변수에는 공개 https:// URL, 최대 10 MB의 data: URI 또는 업로드의 file_url을 사용할 수 있습니다. 파일

출력

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/character/remix",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 150,
    "usd": "0.15",
    "charged": 150,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    ],
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
파일 보관 방식 선택모든 outputs[].url은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 type, url, content_type, width, height 및 duration을 사용합니다. output은 모델 자체의 결과 객체입니다.
출력 필드
images
array of object {url, content_type, file_name, file_size}
seed
integer난수 생성에 사용하는 시드 값입니다.

더 많은 모델: 이미지 편집

AI 에이전트용: 이 페이지의 Markdown 버전: https://doitong.com/ko/developers/models/ideogram/character/remix.md. 모든 모델 및 가이드: https://doitong.com/developers/llms.txt