AI 잡지 표지 생성 API: 글자 넣을 자리를 남긴 표지

Sume API로 잡지 표지 스타일 이미지를 생성하려면 카탈로그 Format sume-magazine-cover-campaign를 POST /v1/formats/sume/sume-magazine-cover-campaign/runs로 실행하면서, 브리프는 instruction에, 인물 사진이나 제품 사진은 attachments에 넣으세요. 이 Format의 설명에는 깔끔한 캠페인 타이포그래피 영역이 나오는데, 이는 글자가 들어갈 자리로 읽힙니다. 제호와 표지 문구는 직접 얹을 계획을 세우세요.

아래 내용은 2026-09-27에 확인한 Sume 문서 Format 카탈로그 (영문), Format 호출하기 (영문), 구조화 출력 (영문), Image API (영문) 페이지에서 가져왔습니다. Format의 설명은 카탈로그 항목에서 그대로 인용했습니다.

잡지 표지 Format은 무엇을 만드나요?

sume-magazine-cover-campaign(카탈로그 제목: Sume Magazine Cover Campaign)은 카탈로그의 이미지 Format입니다. 설명은 다음과 같습니다. "Create a finished magazine-cover-style campaign image with a bold portrait, designed negative space, and clean campaign typography zones. Use when the user asks for beauty launches, fashion campaigns, cover reveals, and branded editorial social posts. Not for: animated or motion deliverables."(대담한 인물 사진, 의도해서 설계한 여백, 깔끔한 캠페인 타이포그래피 영역을 갖춘 완성된 잡지 표지 스타일 캠페인 이미지를 만듭니다. 뷰티 출시, 패션 캠페인, 표지 공개, 브랜드 에디토리얼 소셜 게시물을 요청받았을 때 쓰며, 애니메이션이나 모션 결과물에는 쓰지 않습니다.)

이것은 Format이 내세우는 목표이지 특정 이미지에 대한 약속이 아니며, 이 Format은 움직이는 표지가 아니라 스틸을 만듭니다. GET /v1/formats/sume/sume-magazine-cover-campaign는 설명을 돌려주지만 레시피 본문은 돌려주지 않습니다. 본문은 호출자가 아니라 에이전트에게 전달되기 때문입니다. formats:write가 있는 키라면 어떤 키로든 이 Format을 호출할 수 있습니다.

표지 브리프는 어떻게 쓰나요?

표지 실행도 다른 Format 실행과 같은 필드를 씁니다. 그중 표지를 좌우하는 필드는 다음과 같습니다.

• 인물 사진과 제품 사진은 공개 HTTPS image_url을 담은 input_image 항목으로 첨부하세요. 실행당 최대 30장입니다. filename은 에이전트가 보는 라벨입니다.
• 글자가 들어갈 위치는 instruction에 적으세요. 예를 들어 제호를 위해 위쪽 삼분의 일을 비워 두라고 쓸 수 있습니다. 이 필드는 8000자까지 받으며, 앞의 약 4000자가 실행에 전달됩니다.
• Sume는 input의 필드 목록을 공개하지 않으며, Format의 레시피는 자기가 아는 키만 읽습니다. 제호 텍스트를 담는 문서화된 필드는 없으므로, 표지에 들어갈 글자는 여러분 쪽에서 관리하세요.
• 표지를 받을 SumeMediaFile# 필드가 있는 output_schema를 바인딩하고, 텍스트 필드는 모두 nullable로 두세요. projection 경로에서는 브리프에서 나왔을 텍스트가 null로 돌아옵니다.

curl -sS -X POST "https://api.sume.com/v1/formats/sume/sume-magazine-cover-campaign/runs" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: acme-spring-cover-v1" \
  -d '{
    "instruction": "Spring launch cover. Keep the top third clear for a masthead.",
    "attachments": [
      { "type": "input_image", "image_url": "https://example.com/model.jpg", "filename": "model.jpg" },
      { "type": "input_image", "image_url": "https://example.com/cream.png", "filename": "cream.png" }
    ],
    "output_schema": {
      "name": "acme/cover/v1",
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": ["cover_image", "alt_text"],
        "properties": {
          "cover_image": { "$ref": "SumeMediaFile#" },
          "alt_text": { "type": ["string", "null"] }
        }
      }
    },
    "primary_output_key": "cover_image",
    "generation_spend_cap_usd": 10
  }'

표지는 어떻게 받나요?

생성 요청은 실행 영수증과 함께 202로 응답합니다. GET /v1/format-runs/{run_id}를 폴링하거나, communication.webhook_url을 보내 서명된 format.run.terminal POST를 한 번 받으세요. 위 스키마를 쓰면 primary_output_url이 표지입니다. 이 media.sume.com URL은 만료되지 않으며, URL을 가진 사람이면 누구나 접근할 수 있습니다.

실행이 만든 것 중 스키마를 만족하는 것이 없으면 output은 null이고 output_error가 이유를 알려 주며, API에서는 실행이 failed로 끝납니다. 이때도 artifacts[]에는 실행이 만든 것이 나열됩니다. 그다음 자체 디자인 단계에서 제호와 표지 문구를 그 영역에 배치하세요.

대신 Image API로 표지를 생성할 수 있나요?

네, 모델을 직접 고르고 프롬프트를 직접 쓰고 싶을 때 쓸 수 있습니다. POST /v1/images는 인물 사진과 제품 사진을 공개 HTTPS URL로 된 input_references로 받으며, 아래 옵션이 표지의 모양을 잡습니다. 모델은 카탈로그 디스크립터에 나열된 값만 받으므로 먼저 GET /v1/images/models를 확인하세요. 모델이 나열하지 않은 파라미터는 400 unsupported_parameter로 거부됩니다.

화면 비율과 크기는 AI 이미지 생성 API 화면 비율에서, 4K와 이미지 수는 4K AI 이미지 생성 API에서 다룹니다.

어떤 제한이 있나요?

아래 제한은 같은 문서 페이지에서 가져왔습니다.

• 첨부는 JPEG, PNG, WebP, GIF, AVIF 중 하나이며, 이미지당 30 MB, 실행당 500 MB까지입니다. 첨부 타입은 input_image뿐입니다.
• Format의 생성은 generation_spend_cap_usd 한도 안에서 API 요금의 요율로 계량됩니다. 최대 $500이며, null은 $500으로 실행되고 0은 거부됩니다.
• Image API 과금은 전부 아니면 전무 방식입니다. 완료된 생성은 전액 과금되고, 실패한 생성은 과금되지 않습니다. 응답의 data[].url은 Sume가 호스팅하는 서명된 URL입니다.
• 이 Format의 설명은 애니메이션이나 모션 결과물을 제외합니다. 캠페인 영상이 필요하다면 AI 패션 에디토리얼 영상 API를 참고하세요.