2026-09-26개발자

영상 생성 모델 목록 API: GET /v1/videos/models

GET /v1/videos/models는 Sume의 모든 영상 모델을 해상도, 화면 비율, 길이, 프레임·레퍼런스 유형, 오디오 여부, 가격 SKU와 함께 보여 줍니다.

읽는 시간 5분Sume

Sume의 영상 생성 모델 목록을 보려면 API 키로 GET /v1/videos/models를 호출하세요. 응답의 data 배열에는 모델마다 디스크립터가 하나씩 들어 있습니다. 디스크립터에는 id, 지원하는 해상도·화면 비율·길이, 프레임과 레퍼런스 유형, 오디오를 만드는지와 시드를 받는지, 가격 SKU가 담깁니다.

아래 내용은 Sume 영상 생성 (영문) 문서의 모델 탐색(Model Discovery) 섹션과 이 엔드포인트 뒤의 카탈로그 코드에서 가져왔으며, 2026-09-26에 확인했습니다. Job 제출과 폴링은 OpenRouter 호환 영상 API에서 다룹니다.

영상 모델 엔드포인트는 어떻게 호출하나요?

생성에 쓰는 키로 GET 요청을 보내세요. GET /v1/health, GET /v1/catalog 같은 몇 안 되는 공개 경로를 빼면 모든 /v1 엔드포인트에는 Sume API 키가 필요하며, 이 엔드포인트는 공개 경로가 아닙니다. API 레퍼런스에 따르면 Authorization: Bearer와 x-api-key 모두 쓸 수 있고, 키가 없거나 유효하지 않으면 401이 반환됩니다.

curl -s "https://api.sume.com/v1/videos/models" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  | jq '.data[] | {id, supported_durations, supported_resolutions}'

각 필드는 무엇을 알려 주나요?

표에는 모델마다 다른 필드를 정리하고, 필드마다 그 항목을 모델별로 비교한 글을 함께 달았습니다. pricing_skus는 공급사 정가 × 1.25로 매긴 청구 요율이며, 사용량은 모델의 공개 요율에 기본 5.5% 에이전트 수수료를 더해 청구됩니다. SKU 키마다 이름에 단위가 들어 있습니다. per-1000-video-tokens, per-video-second(오디오 요율이 따로 있으면 per-video-second-audio도), per-video-second-<resolution> 중 하나입니다.

영상 생성 (영문) 기준 모델마다 다른 필드, 2026-09-26 확인. 모델별 현재 값은 `GET /v1/videos/models`를 호출해 확인하세요.
필드	나열하는 값	더 보기
`id`	`model`로 보낼 slug	접두어 없는 카탈로그 ID, `org/slug` 형식은 쓰지 않음
`supported_durations`	허용되는 모든 길이(정수 초)	길이 한도
`supported_resolutions`	지원하는 출력 해상도	4K 영상
`supported_aspect_ratios`	허용되는 `aspect_ratio` 값	세로 9:16
`supported_frame_images`	허용되는 `frame_type` 값	첫 프레임과 마지막 프레임
`supported_input_references`	허용되는 `input_references` 유형	레퍼런스로 영상 만들기
`generate_audio`	오디오 트랙 생성 가능 여부	소리 있는 영상
`pricing_skus`	SKU별 청구 요율	API 요금

모든 모델에서 같은 필드는 무엇인가요?

created는 모든 행에서 같은 값으로, 모델 출시일이 아니라 카탈로그 게시일입니다. 영구 모델 식별자인 canonical_slug는 id와 같습니다. v1에서는 다음 세 필드도 고정되어 있습니다.

seed는 모든 모델에서 false이므로, seed를 보내는 요청은 거부됩니다.
supported_sizes는 null이므로, size 대신 resolution과 aspect_ratio를 보내세요.
allowed_passthrough_parameters는 비어 있으므로, provider.options는 생략하거나 비워 두어야 합니다.

호출하기 전에 모델을 어떻게 확인하나요?

한도는 모델마다 다르므로, 보낼 ID의 디스크립터를 읽고 요청의 각 값을 해당 목록과 비교하세요. 비교할 값은 duration, resolution, aspect_ratio, 모든 frame_images[].frame_type, 모든 input_references[].type입니다. generate_audio: true는 디스크립터의 generate_audio가 true일 때만 보내세요.

const res = await fetch("https://api.sume.com/v1/videos/models", {
  headers: { Authorization: `Bearer ${process.env.SUME_API_KEY}` },
});
const { data } = await res.json();
const model = data.find((m) => m.id === "wan-3.0");
const ok =
  model !== undefined &&
  model.supported_durations.includes(12) &&
  model.supported_resolutions.includes("1080p") &&
  model.supported_aspect_ratios.includes("16:9");
if (!ok) throw new Error("wan-3.0 does not accept this request");

확인을 건너뛰면 어떻게 되나요?

제출 요청이 Job 대신 오류를 반환합니다. 코드별 설명은 영상 생성 API 400 오류 글에 있으며, 디스크립터에서 비롯되는 오류는 다음 세 가지입니다.

카탈로그 ID도 아니고 sume/auto 같은 auto 별칭도 아닌 model: 404 model_not_found.
모델의 목록에 없는 값: 400 unsupported_capability이며, details.supported에 허용되는 값이 담깁니다.
size, seed, 또는 비어 있지 않은 provider.options: 400 unsupported_parameter.

현재 어떤 모델이 목록에 있나요?

2026-09-26 기준 프로덕션 카탈로그에 있는 영상 모델 ID는 10개로, seedance-2.5, seedance-2-mini, seedance-2, seedance-2-fast, kling-3, wan-3.0, grok-imagine-video-1.5, minimax-h3, minimax-h3-max, gemini-omni-flash-1.1입니다. 이 목록은 바뀔 수 있으므로 하드코딩하지 말고 런타임에 읽으세요. sume/auto는 행이 아닙니다. 카탈로그 계열이 아니라 model로 보낼 수 있는 라우팅 별칭입니다.

영상 카탈로그는 또 어디서 볼 수 있나요?

GET /v1/videos/models는 Video Router 카탈로그를 투영한 것이므로, 같은 모델이 다른 두 곳에도 나옵니다.

GET /v1/video-router/models와 GET /v1/video-router/models/{model_id}는 모델별 capabilities, constraints, 그리고 청구 마진이 함께 담긴 공급사 정가 pricing을 반환합니다. Video Router 문서 (영문)는 하나의 공통 한도를 가정하지 말고 그곳의 capabilities를 읽으라고 안내합니다. 알 수 없는 ID는 404 model_not_found입니다.
GET /v1/catalog는 공개 경로라 키가 필요 없습니다. 기능, 엔드포인트, 런타임 준비 상태, 모델, 가격 메타데이터를 나열하며, 자세한 내용은 Sume API 카탈로그 엔드포인트를 참고하세요.

출처

작성자 Sume