Muse Image

Muse Image로 프롬프트 또는 최대 9장의 참조 이미지에서 7가지 화면비의 이미지를 생성하세요. 요청당 이미지 한 장, 이미지당 과금으로 태스크를 통해 전달됩니다.

Muse Image는 Meta Superintelligence Labs의 이미지 모델입니다. 요청 한 번으로 프롬프트, 또는 프롬프트와 최대 9장의 참조 이미지에서 7가지 화면비 중 하나로 이미지 한 장을 만듭니다. 요청을 보내고 반환된 태스크 ID를 보관한 뒤 완성된 이미지를 태스크에서 읽어 오세요. 참조 이미지는 URL로 전달합니다.

모델 ID	입력	화면비	요청당 이미지 수
`muse-image`	텍스트, 이미지 0–9장	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`	1

간단한 예제

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-image",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "aspect_ratio": "1:1"
  }'

엔드포인트

POST https://api.seedrouter.ai/v1/images/generations

헤더	값
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

응답은 완성된 이미지가 아니라 태스크({"id": "task_...", "status": "processing"})입니다. 결과는 GET /v1/tasks/{task_id}를 폴링해서 받으세요. API 키는 서버 측 코드에 보관하세요. 참조 이미지는 같은 요청의 image_urls로 전달하며, 이 모델에서는 /v1/images/edits를 사용하지 않습니다.

파라미터

필드	타입	기본값	설명
`model`	string	필수	`muse-image`
`prompt`	string	필수	앞뒤 공백을 제거한 뒤 비어 있으면 안 됩니다. 참조 이미지가 있어도 필수입니다.
`image_urls`	URL 목록	없음	공개 이미지 URL 0–9개, 합계 11 MB. 없으면 텍스트로 이미지 생성입니다.
`aspect_ratio`	enum	auto	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2` 또는 `2:3`. 생략하면 자동으로 참조 이미지의 화면 형태를 따르며, 텍스트만 있으면 `1:1`입니다. `"auto"`를 보내지 마세요.
`size`	enum	없음	`aspect_ratio`의 호환 별칭으로 위 화면비 또는 `auto`입니다. `1024x1024` 같은 픽셀 크기는 거부됩니다. 둘 다 유효하면 `aspect_ratio`가 우선합니다.
`n`	integer	`1`	`1`만 허용합니다. 요청마다 이미지 한 장을 반환합니다.

이 목록에 없는 필드는 요청을 전달하기 전에 삭제되며, 오류를 일으키거나 출력에 영향을 주지 않습니다. 해상도, 시드, 네거티브 프롬프트, 마스크, 출력 형식 설정은 없습니다. callback_url은 사용할 수 없으니 태스크를 폴링하세요.

참조 이미지

image_urls에 이미지 최대 9장을 전달하고 prompt에 유지할 부분과 바꿀 부분을 설명하세요. Muse Image는 이를 새 이미지의 참조 이미지로 사용합니다. aspect_ratio를 생략하면 결과는 참조 이미지의 화면 형태를 따릅니다.

{
  "model": "muse-image",
  "prompt": "Keep this exact jacket; show it folded in a flat lay of hiking gear on pine boards, soft morning light.",
  "image_urls": ["https://example.com/jacket.png"],
  "aspect_ratio": "9:16"
}

미디어 입력

각 참조 이미지는 공개 HTTP(S) URL로 전달합니다. Base64 data URI는 받지 않습니다. 파일을 자체 스토리지에 업로드하고 그 URL을 전달하세요. PNG, JPEG 또는 WebP 이미지를 사용하며, 모든 참조 이미지의 원본 파일 크기 합계가 11 MB 이하여야 합니다. 이 제한을 넘으면 접수 후 태스크가 실패하며 과금되지 않습니다.

과금에 영향을 주는 요소

현재 요율은 모델 가격 섹션에서 확인하세요. Muse Image는 이미지당 단일 요금입니다:

cost = price per image × 1

텍스트만 있는 요청과 참조 이미지가 있는 요청, 모든 화면비의 비용이 같습니다. 태스크 접수 시 예약된 금액이 곧 과금되는 금액입니다. 최종 과금액은 계정의 사용 내역에서 확인하세요. 실패한 태스크는 과금되지 않습니다.

출력 스키마

제출하면 태스크가 반환됩니다:

{"id": "task_...", "model": "muse-image", "status": "processing", "created_at": 1789689600}

태스크 조회

GET https://api.seedrouter.ai/v1/tasks/{task_id}

status가 completed 또는 failed가 될 때까지 10~20초마다 폴링하세요. 폴링 중 네트워크 타임아웃이 났다고 생성이 실패한 것은 아닙니다. 태스크 ID를 보관하고 다시 확인하세요. 진행 상황을 보려고 태스크를 새로 만들지 마세요.

완료된 태스크

{
  "id": "task_...",
  "model": "muse-image",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689680,
  "output": {
    "created": 0,
    "data": [
      { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.webp" }
    ]
  }
}

이미지는 모델 고유 형식인 WebP로 전달되며 출력 형식 설정은 없습니다. 픽셀 크기는 모델이 정합니다. 저희 테스트에서 텍스트만 있는 요청은 1600 × 1600, 16:9는 2048 × 1152, 3:4는 1344 × 1792, 9:16은 1152 × 2048로 제출 후 약 50–180초 만에 도착했습니다.

오류

태스크가 생성되기 전에 거부된 요청은 HTTP 오류와 error 객체를 반환하며 과금되지 않습니다. 접수된 뒤 실패한 태스크는 조회 시 HTTP 200과 함께 status: "failed" 및 error 객체를 반환합니다.

코드, HTTP 상태, 재시도 지침은 공통 오류 카탈로그를 참고하세요.

{
  "id": "task_...",
  "model": "muse-image",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

제출 자체가 타임아웃된 경우에는 다시 보내기 전에 태스크 목록을 확인하세요. 첫 번째 요청이 이미 접수되었을 수 있습니다.

팁

피사체, 장소, 조명, 구도를 지정하세요. Muse Image는 구체적인 요구 사항을 충실히 따릅니다.
참조 이미지가 있으면 제품의 색상이나 형태처럼 반드시 유지해야 할 부분을 정확히 설명하세요.
참조 이미지의 화면 형태에 맞추려면 aspect_ratio를 생략하고, 채널에 맞춰 자르려면 값을 지정하세요.
지어낸 표시가 들어가지 않도록 no text, no logos를 추가하세요.

모델 ID