Video 1.0
이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.
Video 1.0은 Sume의 최적 비디오 모델 라우터입니다. 프롬프트(와 선택적
프레임·레퍼런스)만 보내면 Sume가 작업에 맞는 비디오 모델을 고릅니다. 조향은
routing_preset(cost, speed, quality, grok, kling)만 사용하세요 —
프로바이더 모델 id는 보내지 않습니다. Job receipt의 모델은 항상
sume/video-1.0입니다.
기본 실행 URL입니다.
model-run 별칭입니다(본문은 같습니다).
공개 모델 id는 sume/video-1.0입니다.
언제 사용하나요
| 목표 | 방법 |
|---|---|
| 텍스트 → 비디오 | prompt만 사용합니다 |
| 이미지 → 비디오 | prompt + image_url(첫 프레임) |
| 시작 + 끝 프레임 | image_url + end_image_url |
| 레퍼런스 기반 | reference_image_urls와/또는 reference_video_urls(이미지나 비디오 레퍼런스가 하나 이상 있을 때 선택적으로 reference_audio_urls) |
공개 HTTPS 미디어 URL만 사용하세요.
요청 필드
| 필드 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 비어 있지 않은 문자열입니다. |
image_url | 아니요 | 첫 프레임 이미지 URL입니다. DEPRECATED된 first_frame_url보다 이 필드를 사용하세요. |
end_image_url | 아니요 | 끝 프레임 이미지 URL입니다. image_url(또는 DEPRECATED된 first_frame_url)이 필요합니다. DEPRECATED된 last_frame_url보다 이 필드를 사용하세요. |
reference_image_urls | 아니요 | 이미지 URL 1~9개입니다. |
reference_video_urls | 아니요 | 비디오 URL 1~3개입니다. |
reference_audio_urls | 아니요 | 오디오 URL 1~3개입니다. 레퍼런스 이미지나 비디오가 하나 이상 있어야 합니다. |
resolution | 아니요 | 480p, 720p, 1080p입니다. 1080p는 고해상도 레인을 사용하며 15초로 제한됩니다. 4k는 예약돼 있으며 v1에서는 거부됩니다. |
duration | 아니요 | 정수 초입니다. 기본/quality 레인의 480p·720p에서는 4cost·speed·grok·kling 및 모든 1080p 요청에서는 4duration_seconds보다 이 필드를 사용하세요. 둘 다 설정하면 값이 같아야 합니다. |
duration_seconds | 아니요 | duration의 별칭입니다. |
bitrate_mode | 아니요 | standard, high입니다. |
aspect_ratio | 아니요 | auto, adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16입니다. |
generate_audio | 아니요 | 불리언입니다. |
routing_preset | 아니요 | Sume가 소유한 라우팅 힌트입니다: cost, speed, quality, grok, kling. 생략하면 quality와 동일하게 동작하고, cost와 speed는 같은 fast 레인을 씁니다. 프로바이더 모델 id가 아닙니다. |
metadata | 아니요 | Job에 저장되는 호출자 메타데이터입니다. 프로바이더로 전달되지 않습니다. |
mode | 아니요 | async, sync, subscribe, webhook입니다. |
webhook_url | 아니요 | 웹훅 모드를 위한 공개 HTTPS 콜백입니다. |
wait_timeout_seconds | 아니요 | sync / subscribe에서 0~30입니다. |
Video 1.0은 본문의 model 필드를 받지 않습니다. Sume 라우팅 힌트가
필요하면 routing_preset만 사용하세요.
비디오 Job 만들기
Generate a Video 1.0 job
POST /v1/video-1.0/generate
Required
이미지에서 비디오를 만드는 예제입니다.
폴링하고 결과 가져오기
제출 봉투의 next_action을 따르세요(poll_status 다음 fetch_result). 전체
라이프사이클은 Job과 결과에 있습니다.
산출물
완료된 Video 1.0 Job은 Sume가 호스팅하는 비디오(때로는 이미지) 산출물을 반환합니다.
산출물 URL은 불투명한 값으로 다루세요. 워크스페이스, Job, 프로바이더 식별자를 얻으려고 경로를 파싱하지 마세요.