비디오 생성 API

텍스트, 이미지, 비디오 참조, 오디오 입력으로부터 AI 비디오를 생성합니다 — 모두 하나의 통합 엔드포인트를 통해 처리됩니다. 생성 모드는 제공하는 파라미터 조합에 따라 자동으로 결정됩니다.

엔드포인트

POST https://api.evolink.ai/v1/videos/generations

요청 파라미터

파라미터타입필수기본값설명
modelstring예—모델 ID. seedance-2.0을 사용합니다
promptstring예—원하는 비디오에 대한 텍스트 설명 (최대 2000 토큰). @ 태그를 사용하여 업로드된 파일을 참조할 수 있습니다
image_urlsarray아니오—참조 이미지 URL (최대 9개). 입력 파일 요구사항 참조
video_urlsarray아니오—참조 비디오 URL (최대 3개). 입력 파일 요구사항 참조
audio_urlsarray아니오—참조 오디오 URL (최대 3개). 입력 파일 요구사항 참조
durationinteger아니오5비디오 길이(초). 4에서 15 사이의 정수. 길이가 길수록 비용이 증가합니다
qualitystring아니오720p비디오 해상도: 480p, 720p, 또는 1080p. 높은 화질일수록 비용이 증가합니다
aspect_ratiostring아니오16:9화면 비율: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 또는 adaptive
generate_audioboolean아니오true동기화된 오디오 생성 여부. 활성화 시 비용이 증가합니다
callback_urlstring아니오—작업 완료 콜백을 위한 HTTPS URL. 웹훅 참조

생성 모드

API는 제공된 입력 파라미터에 따라 생성 모드를 자동으로 감지합니다:

제공된 입력모드설명
prompt만텍스트-비디오텍스트 설명으로 비디오를 생성합니다
prompt + image_urls (이미지 1개)이미지-비디오참조 이미지를 애니메이션화합니다
prompt + image_urls (이미지 2개)첫-끝 프레임두 키프레임 사이의 전환을 생성합니다
prompt + image_urls, video_urls, audio_urls의 조합멀티모달프롬프트에서 @ 태그를 사용하여 각 입력에 역할을 지정합니다. 멀티모달 레퍼런스 참조

입력 파일 요구사항

이미지

속성제한
최대 개수요청당 9개
최대 파일 크기이미지당 30MB
지원 형식.jpeg, .png, .webp, .bmp, .tiff, .gif

비디오

속성제한
최대 개수요청당 3개
최대 파일 크기비디오당 50MB
지원 형식.mp4, .mov
길이2~15초
픽셀 범위409,600 (480p) – 927,408 (720p)

오디오

속성제한
최대 개수요청당 3개
최대 파일 크기오디오당 15MB
지원 형식.mp3, .wav
총 길이15초 이하

총 파일 제한: 요청당 모든 모달리티를 합쳐 최대 12개 파일까지 가능합니다.

얼굴 제한: 사실적인 인물 얼굴 업로드는 지원되지 않으며 자동으로 거부됩니다.

모든 파일 URL은 서버에서 직접 접근 가능해야 합니다.

예제

텍스트-비디오

import requests

response = requests.post(
    "https://api.evolink.ai/v1/videos/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "seedance-2.0",
        "prompt": "A luxury watch rotating slowly on a marble surface, soft studio lighting, product showcase, cinematic 4K",
        "duration": 8,
        "quality": "1080p",
        "aspect_ratio": "16:9",
        "generate_audio": False
    }
)

print(response.json())
얼리 액세스 신청