핵심 개념

이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.

이 페이지는 Job과 접수 맵입니다 — 카탈로그, Job, artifact, 사용량. Agents, Formats, Models, 클라이언트 제품 맵은 Sume 기초를 보세요.

Sume 생성 워크플로는 작은 공개 객체 집합으로 구성됩니다. 카탈로그 항목, 미디어 입력, Job, artifact, 사용량 항목, 대시보드 리소스입니다.

플랫폼 도메인

Domain / URL	Role
`www.sume.com/dashboard`	대시보드 홈과 운영자 표면입니다.
`www.sume.com/dashboard/api-keys`	API 키 관리입니다.
`www.sume.com/dashboard/jobs`	Job 조회입니다.
`www.sume.com/dashboard/usage`	사용량과 잔액 요약입니다.
`www.sume.com/dashboard/subscription`	결제·구독 / 크레딧 충전입니다.
`www.sume.com/playground`	Avatar playground입니다.
`api.sume.com`	공개 Developer API(`/v1`)와 OpenAPI(`/reference/json`)입니다.
`media.sume.com`	1st-party 생성 미디어 artifact입니다.

Catalog

프로그램 방식 탐색의 출발점은 GET /v1/catalog입니다. 사용 가능한 능력, 모델 id, 엔드포인트 경로, 런타임 준비 상태, 가격 메타데이터를 나열합니다.

Jobs

생성 요청은 내구성 있는 Job을 만듭니다. Job은 요청 메타데이터, 상태, 공개 provider 모델, 결과, 공개 오류, 이벤트, 웹훅 전달 상태를 추적합니다.

지원 상태:

생성 수명주기

클라이언트가 끊기거나 로컬에서 타임아웃돼도 job_id를 유지하고 Jobs API로 복구하세요. 유료 작업을 중복 제출하지 마세요.

Artifacts

완료된 Job은 https://media.sume.com 아래 공개 artifact를 포함할 수 있습니다. Sume 소유의 artifact URL이 공개 계약입니다. 원본 provider URL은 아닙니다.

생성 요청은 input.image_url, product_image, scene.image_url, video_url(페이스 스왑/캡션)처럼 스키마에 정의된 필드에 공개 HTTPS 미디어 URL을 받습니다. 일반적인 연동에는 별도 asset 업로드 단계가 필요 없습니다. 생성 출력은 media.sume.com의 Sume 호스팅 artifact로 돌아옵니다. 미디어 입력을 참고하세요.

Usage

provider 기반 생성은 예상 USD 사용량을 예약하고, 성공 시 실제 비용을 확정하며, 확정 전 실패·취소 시 환불할 수 있습니다. 현재 잔액과 원장 항목은 /v1/balance와 /v1/usage로 확인하세요.

Dashboard

대시보드는 사람을 위한 API 표면 미러입니다.