메인 콘텐츠로 건너뛰기
POST

인증

Authorization
string
필수
모든 API 엔드포인트는 Bearer Token 인증이 필요합니다API 키 받기:API 키 관리 페이지를 방문하여 API 키를 받으세요요청 헤더에 추가하세요:

생성 모드

SkyReels V4는 요청 필드에 따라 자동으로 해당 모드로 라우팅됩니다. mode 필드를 지정할 필요가 없습니다:
엄격한 상호 배타성: I2V 필드(first_frame_image / end_frame_image / mid_frame_images)와 Omni 필드(ref_images / ref_videos)는 동시에 사용할 수 없으며, 위반 시 422를 반환합니다.
@tag 메커니즘: mid_frame_images / ref_images / ref_videos를 사용할 때 각 요소는 @로 시작하는 tag(예: @image1, @Actor-1, @video1)를 선언해야 하며, 해당 tag반드시 prompt에 나타나야 합니다.prompt를 “대본”으로, tag를 구체적인 소재(이미지 / 비디오)를 가리키는 “캐릭터 포인터”로 이해할 수 있습니다. 예를 들어 prompt에 "@Actor-1이 @video1 장면에 들어간다"라고 쓰면, 시스템은 @Actor-1에 해당하는 참조 이미지의 주체와 @video1에 해당하는 모션 참조를 생성 과정에 주입합니다.

요청 매개변수

공통 필드

model
string
필수
다음 두 가지 등급을 지원합니다:
model 필드는 명시적으로 전달해야 하며 기본값이 없습니다.
요금은 해상도 및 ref_videos 사용 여부와 밀접한 관련이 있습니다: 1080p는 480p / 720p보다 현저히 비싸며, ref_videos(비디오 입력 포함)는 비디오 입력이 없는 경우의 약 1.5 ~ 2배입니다. 오디오와 비디오 동시 출력은 아직 지원되지 않습니다.
prompt
string
필수
텍스트 프롬프트, 최대 1280 tokens장면, 주체, 동작, 스타일 등을 자세히 설명하면 더 나은 생성 결과를 얻을 수 있습니다.ref_images / ref_videos / mid_frame_images를 사용할 때 prompt에는 해당하는 @tag(예: @Actor-1, @video1, @image1)가 반드시 포함되어야 합니다.예시: "@Actor-1 walks through a neon-lit street at night."
duration
integer
기본값:"5"
출력 비디오 길이(초)
  • 범위: [3, 15]
  • 기본값: 5
ref_videos.type=reference를 전달하면 duration은 참조 비디오 길이로 덮어씌워집니다(상한 10초).
resolution
string
기본값:"1080p"
비디오 해상도옵션:
  • 480p
  • 720p
  • 1080p (기본값)
aspect_ratio
string
기본값:"16:9"
종횡비옵션:
  • 16:9 (기본값)
  • 4:3
  • 1:1
  • 9:16
  • 3:4
I2V 모드에서는 aspect_ratio가 무시됩니다(출력 비율은 입력 이미지로 결정됨); Omni가 ref_videos를 포함할 때도 무시됩니다.
prompt_optimizer
boolean
기본값:"true"
prompt 자동 최적화 여부활성화하면 시스템이 자동으로 프롬프트를 최적화하여 더 나은 생성 결과를 얻을 수 있습니다.

I2V 전용 필드

first_frame_image
string
비디오 시작 프레임 이미지 URL (jpg / jpeg / png / gif / bmp)전달하면 해당 이미지가 비디오의 시작 화면으로 사용됩니다.
end_frame_image
string
비디오 끝 프레임 이미지 URL (jpg / jpeg / png / gif / bmp)전달하면 해당 이미지가 비디오의 끝 화면으로 사용됩니다. first_frame_image와 결합하여 첫/끝 프레임 제어가 가능합니다.
mid_frame_images
object[]
중간 키프레임 목록, 최대 6개. 각 요소의 구조는 다음과 같습니다:

Omni 전용 필드

ref_images
object[]
참조 이미지 목록(모든 요소의 type은 일치해야 함). 각 요소의 구조는 다음과 같습니다:
ref_videos
object[]
참조 비디오 목록, 최대 1개. 각 요소의 구조는 다음과 같습니다:

지원 생성 시나리오

다음 시나리오는 skyreels-v4-fastskyreels-v4-std 모두 지원합니다:

매개변수 제약

다음 제약 중 하나라도 위반하면 요청이 거부되어 422를 반환하며, 과금되지 않습니다:

응답

code
integer
응답 상태 코드, 성공 시 200
data
array
응답 데이터 배열

요청 예시

케이스 1: 텍스트-비디오 (최소)

케이스 2: 텍스트-비디오 (전체 매개변수)

케이스 3: 이미지-비디오 - 첫 프레임

케이스 4: 이미지-비디오 - 첫/끝 프레임 + 중간 키프레임

케이스 5: Omni - 단일 주체 참조

케이스 6: Omni - 다중 주체 + 비디오 모션 참조

이 케이스는 ref_videos.type=reference를 사용하므로 요청의 duration은 참조 비디오의 실제 길이로 덮어씌워집니다(상한 10초). 여기서 "duration": 5를 전달해도 최종 비디오 길이는 참조 비디오에 따릅니다.

케이스 7: Omni - 그리드 콜라주 (grid)

케이스 8: Omni - 비디오 확장 (extend)

케이스 9: Omni - 보이스 입력 (음향 동기화)

작업 결과 조회비디오 생성은 비동기 작업으로, 제출 후 task_id가 반환됩니다. 작업 상태 가져오기 엔드포인트를 사용하여 생성 진행 상황과 결과를 조회하세요.