APIMart
이미지

Muse Image API

Muse Image API는 프롬프트 또는 최대 9장의 참조 이미지로 이미지를 생성합니다. 지원 비율을 선택하거나 참조 화면 비율를 따르고, 작업 API에서 WebP 이미지 한 장을 받으세요.

이미지 생성

서비스 하이라이트

  • 공식 할인
  • 종량제
  • 고속 & 저지연
Input
참조 이미지

선택 사항: 참고 이미지 최대 9장, 총 11 MiB. 자동 비율은 참고 이미지 비율을 따릅니다.

출력

아직 생성 기록이 없습니다.

Muse Image API 요금

숨겨진 수수료 없는 투명한 요금제. 사용한 만큼만 지불하세요.

모델골드 가격현재 가격플래티넘 가격다이아몬드 가격공식 가격절약률
muse-image-ext0.048Credits(~$0.0048)/장0.0456Credits(~$0.0046)/장0.0432Credits(~$0.0043)/장0.06Credits(~$0.006)/장20%

* 실제 비용은 최종 출력에 따라 달라집니다.

Muse Image API로 제작 시작

Muse Image API는 프롬프트 또는 최대 9장의 참조 이미지로 이미지를 생성합니다. 지원 비율을 선택하거나 참조 화면 비율를 따르고, 작업 API에서 WebP 이미지 한 장을 받으세요.

Muse Image API 지원 기능

생성 모드, 입력 조건과 출력 사양을 확인하세요.

Muse Image API 텍스트 이미지 생성

프롬프트에 피사체, 배경, 구도와 조명을 설명하세요. 참조 이미지 없이 텍스트로 이미지를 생성할 수 있습니다.

Muse Image API 참조 이미지

프롬프트와 함께 최대 9장을 전송하세요. URL, Data URI, base64를 지원하며 원본 이미지의 총 크기는 11 MiB 이하여야 합니다.

Muse Image의 7가지 화면 비율

1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3을 지원합니다. 자동 선택 시 aspect_ratio를 생략하여 참조 이미지의 화면 비율를 따릅니다.

Muse Image Model의 WebP 출력

요청마다 이미지 한 장을 생성합니다. 크기는 모델이 결정하며 픽셀 크기나 해상도 등급을 지정할 수 없습니다.

muse-image-ext 모델 호출

전체 모델 ID muse-image-ext를 /v1/images/generations에 보내 생성 작업을 시작하세요.

Muse Image API 비동기 작업

한 번 제출한 뒤 작업 ID를 저장하고 상태를 조회하세요. 중단된 제출을 재시도할 때는 같은 멱등 키와 요청 본문을 사용합니다.

Muse Image API 가격

생성 전에 계정의 실시간 가격을 확인하세요. 최종 작업 비용과 계정 청구서가 기준입니다. 각 요청은 이미지 한 장 단위로 과금됩니다.

Muse Image 결과 다운로드 및 보관

작업이 completed가 되면 결과 URL을 읽으세요. 응답에 expires_at이 있으면 해당 시간 전에 다운로드하거나 저장하세요.

Muse Image API 활용 사례

제작 목적에 맞는 브리프를 작성하고 결과를 검토하세요.

Muse Image API 상품 장면

상품 배경, 조명과 구도를 설명하고 필요하면 참조 이미지를 추가하세요. 게시 전에 상품 세부 사항을 확인하세요.

Muse Image 캠페인 콘셉트

피사체, 색상과 스타일로 캠페인 방향을 탐색하고 결과를 브리프와 비교하세요.

Muse Image API 기사 이미지

기사 주제를 시각적 브리프로 바꾸고 나중에 편집 도구에서 넣을 텍스트 공간을 계획하세요.

muse-image-ext 참조 기반 디자인

텍스트와 참조 이미지로 원하는 장면을 설명하고 중요한 디자인 세부 사항을 검토하세요.

Muse Image 소셜 이미지

게시 위치에 맞게 세로, 정사각형 또는 가로 비율을 선택하고 최종 이미지를 편집하세요.

Muse Image API 이미지 도구

프롬프트 제출, 작업 추적과 이미지 가져오기를 앱에 통합하고 API 키는 서버에 보관하세요.

Muse Image API 키 발급 및 시작 방법

키를 만들고 브리프를 준비한 뒤 제작 결과를 정리하세요.

1

Muse Image API 키 받기

APIMart에 로그인하고 API Keys에서 키를 만드세요. 키는 서버에 보관하고 브라우저 코드나 공개 저장소에 넣지 마세요.

2

명확한 제작 지침 준비

원하는 결과와 사용 맥락을 설명하세요. 수정본을 비교할 수 있도록 지침을 요청과 함께 저장하세요.

3

결과 검토 및 통합

사용 전에 제작 지침과 결과를 비교하세요. 다음 제작 단계에 활용할 소재를 정리하세요.

Muse Image API 예제와 통합

muse-image-ext를 /v1/images/generations에 제출하고 작업 ID를 저장한 뒤 GET /v1/tasks/{task_id}로 결과를 조회하세요.

  1. 1

    Muse Image API 인증

    키를 서버에 보관하고 Authorization: Bearer <key>를 보내세요. 새 생성 작업마다 Idempotency-Key를 만드세요.

  2. 2

    muse-image-ext 작업 제출

    /v1/images/generations에 model과 prompt를 POST하고 기본 응답의 data[0].task_id를 저장하세요. 중단 후 재시도할 때 같은 키와 본문을 사용하세요.

  3. 3

    Muse Image 결과 가져오기

    GET /v1/tasks/{task_id}로 completed 또는 failed까지 조회하세요. 성공 시 data.result.images[0].url[0], 실패 시 data.error.message를 읽습니다. 로컬 시간 초과는 작업 실패가 아닙니다.

    요청과 응답 상세 내용은 Muse Image API 문서를 확인하세요.

POST /v1/images/generations
IDEMPOTENCY_KEY="${IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.apimart.ai/v1/images/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
    "model": "muse-image-ext",
    "prompt": "A red ceramic cup on a white table, soft studio lighting, product photograph, no text",
    "n": 1,
    "aspect_ratio": "1:1"
  }'

Muse Image API 매개변수

매개변수타입필수 여부기본값설명
modelstring필수기본값: —필수 모델 식별자: muse-image-ext.
promptstring필수기본값: —앞뒤 공백 제거 후 비어 있지 않은 문자열. 중국어와 영어를 지원하며 참조 이미지 유무와 무관하게 필수입니다.
image_urlsstring[]선택기본값: —최대 9개의 이미지 URL, Data URI 또는 base64. 원본 합계는 11 MiB 이하이며 참조가 없으면 생략하세요.
aspect_ratiostring선택기본값: —1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3. 자동은 생략하며 "auto"를 보내지 않습니다. 참조가 없으면 1:1, 있으면 참조 화면 비율를 따릅니다.
ninteger선택기본값: 1숫자 1만 지원합니다. 요청마다 결과 하나를 반환합니다.
nsfw_checkboolean선택기본값: false제출 전 플랫폼 콘텐츠 검사를 활성화합니다. 제출 성공이 모든 심사 통과를 보장하지는 않습니다.

Muse API 둘러보기

프로젝트에 필요한 콘텐츠 유형에 맞는 Muse 페이지를 선택하세요.

Muse Video API

Muse Image API 자주 묻는 질문

Muse Image API란 무엇인가요?

APIMart에서 텍스트나 참조 이미지로 이미지를 생성하는 API입니다. muse-image-ext는 비동기 작업당 WebP 이미지 한 장을 반환합니다.

Muse Image API는 어떤 모델 ID를 사용하나요?

요청의 model 값에 -ext를 포함한 전체 muse-image-ext를 사용하세요.

Muse Image API 키는 어떻게 받나요?

APIMart에 로그인하고 API Keys에서 키를 만드세요. 서버에 보관하고 제출과 조회에 Authorization: Bearer <key>를 사용하세요.

Muse Image은 참조 이미지를 몇 장 지원하나요?

0~9장, 원본 합계 11 MiB까지 지원합니다. image_urls로 URL, Data URI 또는 base64를 보내며 참조 이미지가 있어도 프롬프트는 필수입니다.

Muse Image API는 어떤 비율을 지원하나요?

1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3입니다. 자동은 aspect_ratio 생략을 뜻하며 참조 이미지가 있으면 그 화면 비율를, 없으면 1:1를 사용합니다.

Muse Image 해상도나 픽셀 크기를 선택할 수 있나요?

아니요. 크기는 모델이 결정하고 WebP로 반환합니다. 해상도 등급이나 1024x1024 같은 픽셀 크기를 보내지 마세요.

Muse Image API에서 여러 장이나 마스크를 사용할 수 있나요?

요청마다 한 장이며 n은 숫자 1만 가능합니다. 마스크, 참조 동영상과 참조 오디오는 지원하지 않습니다.

Muse Image API 작업이 페이지 대기 시간을 넘으면 어떻게 하나요?

작업 ID를 보관하고 나중에 다시 조회하세요. 브라우저 시간 초과나 폴링 중지는 서버 작업 취소가 아니므로 자동으로 새 생성 요청을 보내지 마세요.

Muse Image API 가격은 어떻게 계산하나요?

생성 전에 계정의 실시간 가격을 확인하세요. 최종 작업 비용과 계정 청구서가 기준입니다. 각 요청은 이미지 한 장 단위로 과금됩니다.

Muse Image 결과를 보관할 수 있나요?

필요한 파일을 다운로드하거나 저장하세요. expires_at이 반환되면 해당 시간 전에 보관하고, 링크 만료 시 자동으로 새 유료 생성을 요청하지 마세요.