포맷

Sume Format API 한도: 상한, 크기, 타임아웃

문서화된 Sume Format API 한도를 한곳에 모았습니다. 요청과 입력 크기, 첨부 파일, 스키마, 지출 상한, 큐, 실행 기한, 웹훅, 요청 한도입니다.

읽는 시간 6분Sume
전체 글

Sume의 Format API는 instruction을 8000자, input을 최상위 키 64개와 2 MiB, 요청 본문을 4 MiB, 실행 한 번의 생성 비용을 $500으로 제한합니다. 기한이 될 때까지 끝나지 않은 실행은 failed로 강제 종료되며, 기한은 created_at부터 최대 90분입니다. 아래 표에 문서화된 상한, 크기, 타임아웃을 각각의 출처 문서 페이지와 함께 정리했습니다.

모든 행은 2026-09-26에 Format 문서에서 확인했습니다. 주로 Format 호출하기 (영문), 실행과 결과 (영문), 오류와 비용 (영문)이며, Sume API 레퍼런스도 함께 봤습니다. 미디어 입력을 가져오고 저장하는 방식은 영상 API 미디어 입출력에서 다루며, 이 페이지는 숫자만 정리합니다.

Format 실행 하나를 만드는 요청에는 어떤 한도가 있나요?

이 중 하나라도 어긴 생성 요청은 아무것도 실행되기 전에 실패하며, 생성 시점의 4xx는 비용이 전혀 청구되지 않았다는 뜻입니다.

생성 호출 한도, Format 호출하기 (영문), Format API (영문) 페이지, Sume API 레퍼런스 기준, 2026-09-26 확인.
한도값문서
instruction8000자까지 수락. 프롬프트 텍스트로 실행에 전달되는 것은 앞 ~4000자뿐Format 호출하기 (영문)
input 키최상위 키 64개. 중첩된 키는 세지 않음Format 호출하기 (영문)
input 크기2 MiB. compact 직렬화 기준 2097152 UTF-8 바이트Format 호출하기 (영문)
요청 본문4 MiB. 넘으면 413 payload_too_largeFormat 호출하기 (영문)
Idempotency-Key최대 255자. Format 하나 단위로 적용Format 호출하기 (영문)
primary_output_key최대 64자Format 호출하기 (영문)
generation_spend_cap_usd최대 $500. 0이나 500 초과는 400이고, null이면 $500으로 실행. 상한을 한 번도 설정하지 않은 Format은 $400으로 표시Format 호출하기 (영문)
attachments[]실행당 이미지 30개, 개당 30 MB, 실행당 500 MB. JPEG, PNG, WebP, GIF, AVIFFormat API (영문)
미디어 예산attachments[]와 input 안의 미디어 URL을 합쳐 실행당 파일 30개. 이미지 최대 30개, 영상 10개, 오디오 파일 10개Format API (영문)
URL과 이름 필드communication.webhook_url과 attachments[].image_url은 최대 2048자, attachments[].filename은 최대 180자Sume API 레퍼런스

출력 스키마에는 어떤 한도가 있나요?

크기와 중첩 한도를 넘는 스키마는 제출 시 400 output_schema_invalid로 거부되며, 문제마다 details.violations[] 항목이 하나씩 담깁니다. 아무것도 실행되지 않으므로 비용도 청구되지 않습니다.

구조화 출력 (영문) 기준, 2026-09-26 확인.
한도값문서
output_schema.name1–64자, ^[A-Za-z0-9._/-]+$ 형식구조화 출력 (영문)
중첩 깊이10단계(max_depth)구조화 출력 (영문)
속성문서 전체에서 세어 5000개(max_properties)구조화 출력 (영문)
enum 값enum 하나당 1000개(max_enum_values)구조화 출력 (영문)
문자열 총길이모든 속성 이름, 키, 문자열 값을 합쳐 120,000자(max_string_length)구조화 출력 (영문)
폴백 projection실행의 마무리 텍스트를 앞 8000자까지만 잘라서 읽음구조화 출력 (영문)

Format 실행은 얼마나 오래 걸릴 수 있나요?

종료되지 않은 영수증에는 expires_at이 담깁니다. 이 기한이 지나면 실행은 failed로 강제 종료됩니다. 기한은 created_at부터 90분이며, 25분을 넘긴 실행이 10분 동안 아무 활동이 없으면 기한이 앞당겨집니다(실행과 결과 (영문)). 타임아웃을 임의로 만들지 말고 이 값을 기준으로 정하세요. 실행이 종료되면 이 값은 null입니다.

Format API (영문) 페이지에 따르면 긴 호스트 영상은 보통 15~30분 안에 끝납니다. 그러니 처음부터 비동기 경로를 전제로 설계하세요.

웹훅 전달에는 어떤 한도가 있나요?

communication.webhook_url을 지정해 만든 실행은 서명된 format.run.terminal POST를 한 번 보냅니다. 전달 결과가 실행을 바꾸는 일은 없습니다.

실행과 결과 (영문) 기준, 2026-09-26 확인.
한도값문서
전달 횟수실행당 한 번, completed나 failed일 때. canceled나 skipped에서는 보내지 않음전달 규칙 (영문)
성공10초 안에 받은 2xx 응답이면 무엇이든전달 규칙 (영문)
재시도최대 10회 시도. 백오프는 지터를 더한 30 s × 2^(attempt−1)과 429/503에 담아 보낸 Retry-After 중 더 긴 쪽이며, 최대 한 시간전달 규칙 (영문)
payload 크기영수증이 1 MiB를 넘으면 null. 가져올 위치는 error.result_url에 있음웹훅 (영문)
서명 타임스탬프오 분 범위를 벗어난 타임스탬프는 거부모든 전달 검증하기 (영문)

실행은 몇 개까지 큐에 넣고 조회할 수 있고, 분당 몇 번 보낼 수 있나요?

요청 속도는 생성 용량이 아닙니다. 동시에 실행되는 생성 수는 요금제의 동시성 한도가 정하며, 요청 속도를 높여도 그 한도는 올라가지 않습니다.

대량 실행, 실행과 결과 (영문), 오류와 비용 (영문), Sume API 레퍼런스 기준, 2026-09-26 확인.
한도값문서
대량 실행 items요청당 1–100개대량 실행
대량 실행 concurrency큐당 동시에 진행되는 하위 실행 1–16개대량 실행
실행 목록 limit1–100, 기본값 20실행과 결과 (영문)
Format 목록 limit1–100, 기본값 50Sume API 레퍼런스
키당 분당 쓰기 / 읽기Free 120 / 4800, Pro 300 / 12000, Startup 600 / 24000, Scale 1200 / 48000. Enterprise는 계약값이며, 프로비저닝 전까지는 Scale과 같음오류와 비용 (영문)

Format 패키지와 주소에는 어떤 한도가 있나요?

API로 Format 만들기에서처럼 API로 Format을 만들거나 편집할 때 알아야 할 한도입니다.

Format 패키지 편집하기, Format API (영문) 페이지, Sume API 레퍼런스 기준, 2026-09-26 확인.
한도값문서
패키지 크기파일당 100 MiB, 패키지당 100 MiBFormat 패키지 편집하기
SKILL.md 본문파일당·패키지당 상한 외에 별도 한도 없음Format API (영문)
Contents 배치배치 커밋 하나에 경로 최대 1000개Format 패키지 편집하기
커밋 message모든 패키지 쓰기에서 1–500자Sume API 레퍼런스
새 Format 필드slug 1–64자, title 최대 80자, 한 줄짜리 description 최대 1024자Sume API 레퍼런스
{handle}Format 주소에서 2–39자Sume API 레퍼런스
이름을 바꾼 handle90일 동안 계속 해석됨. 불투명한 skl_… invoke_url은 이름을 바꿔도 영구적Format API (영문)

출처

관련 글

작성자 Sume