메인 콘텐츠로 건너뛰기
비디오 생성은 비동기입니다. POST /v1/videos/generations는 공개 작업 ID를 반환하며 일반적으로 poll_url을 포함합니다; 최종 비디오는 이후 상태 응답에서 나타납니다. 선택한 Seedance 모델이 TokenLab 소재 라이브러리를 사용할 수 있으면 이미지 URL과 지원되는 인라인 data URL이 생성 전에 재사용 가능한 TokenLab 소재로 준비됩니다. 준비가 60초를 넘으면 반환된 auto_material_asset_ids가 ACTIVE가 된 후 다시 시도하세요. 선택한 모델이 소재 라이브러리를 사용할 수 없으면 일반 이미지 입력은 일반 이미지 경로로 계속 처리됩니다.

​
모델 세부정보

생산 환경에서는 명시적인 operation을 사용하십시오. TokenLab은 입력에서 일부 작업을 유추할 수 있지만, 명시적인 작업 값은 검증, 지원 및 재시도를 더 명확하게 만듭니다.
작업필수 또는 일반 입력사용 사례
text-to-videoprompt텍스트만으로 생성
image-to-videoimage_url 또는 호환 가능한 image시작 이미지를 애니메이션화
reference-to-videoreference_images 및 선택적 video_urls / audio_urls (지원되는 모델에서)정체성, 스타일 또는 자산 참조 유지
start-end-to-videostart_image, end_image첫 번째 및 마지막 프레임 제어
video-to-videovideo_url 또는 모델별 task_id기존 클립 변환 또는 업스케일
motion-controlimage_url 및 video_url주제에 모션 참조 적용
audio-to-videoaudio_url오디오 조건 비디오 흐름
video-extensiontask_id, extend_at 또는 모델별 확장 필드생성된 비디오 계속하기

​
모델 발견

curl "https://api.tokenlab.sh/v1/models?recommended_for=video" \\
  -H "Authorization: Bearer sk-your-api-key"
model에는 TokenLab에 표시되는 모델 ID를 사용하고, 기능 변형은 operation과 해당 미디어 입력으로 선택하세요. 예: wan-2.7, happyhorse-1.0, viduq3, viduq3-mix, pixverse-v6, kling-3.0-video, veo3.1, seedance-2.0. 작업별 접미사를 TokenLab 모델명으로 사용하지 마세요. reference_images, kling_elements, output_audio, duration, resolution, 또는 aspect_ratio와 같은 전문 필드에 의존하기 전에 선택한 모델 세부정보를 읽으십시오.

​
요청 생성

curl https://api.tokenlab.sh/v1/videos/generations \\
  -H "Authorization: Bearer sk-your-api-key" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "veo3.1",
    "operation": "text-to-video",
    "prompt": "햇빛이 비치는 정원을 걷는 고양이의 차분한 영화 장면",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'
프로덕션 미디어 입력에는 인라인 data: URL보다 공개 https URL을 권장합니다. 임시 URL을 사용하는 경우 TokenLab이 작업 생성을 완료할 때까지 유효하게 유지하세요.

​
입력 및 모델별 필드

  • Veo 3 계열 요청은 output_audio가 생략될 경우 기본적으로 오디오가 켜집니다. 모델이 토글을 지원하고 사용자 경험이 사운드에 의존하는 경우 명시적으로 설정하십시오.
  • kling_elements는 kling-3.0-video 이미지 조건 요청을 위한 것입니다. 각 요소를 prompt에서 @name으로 참조하십시오; output_audio=true와 결합하지 마십시오.
  • Seedance 2.0 패밀리의 4K 출력, Fast/Mini 해상도 제한, 멀티모달 참조 입력을 사용하기 전에 Seedance 2.0 비디오 모델 가이드를 읽으세요.
  • grok-imagine-video의 경우, video-to-video는 공개 .mp4 video_url을 사용합니다; 모델별 제한 사항인 duration 및 resolution은 모델 계약에서 제공되어야 합니다.

​
PixVerse 및 HappyHorse

모델작업입력해상도지속 시간오디오 선택기
pixverse-c1, pixverse-v6text-to-video, image-to-video, start-end-to-video, reference-to-videoprompt; image_url; start_image + end_image; reference_images360p, 540p, 720p, 1080p1초에서 15초 사이의 정수output_audio, 기본값 false
pixverse-v5.6text-to-video, image-to-video, start-end-to-video, reference-to-videoC1 및 V6와 동일한 필드360p, 540p, 720p, 1080p5초, 8초 또는 10초; 1080p는 5초 또는 8초 지원output_audio, 기본값 false
happyhorse-1.0text-to-video, image-to-video, reference-to-video, video-to-videoprompt; image_url; reference_images; video_url + reference_images720p, 1080p생성 작업의 경우 3초에서 15초; video-to-video 출력은 최대 15초로 제한됨output_audio를 전송하지 마십시오
TokenLab에서 위의 PixVerse 모델은 operation=video-extension을 허용하지 않습니다. 
curl https://api.tokenlab.sh/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "operation": "image-to-video",
    "prompt": "A slow camera move through a neon-lit street",
    "image_url": "https://example.com/start.jpg",
    "resolution": "1080p",
    "duration": 5,
    "output_audio": true
  }'

​
결과 폴링

반환된 poll_url을 먼저 사용하십시오. 고정 엔드포인트가 필요한 경우, 생성 응답에서 동일한 id / task_id로 GET /v1/tasks/{id}를 사용하십시오. 완료된 비디오 작업은 모델 및 출력 수에 따라 video_url, video 또는 videos를 반환할 수 있습니다. billing_transaction_id는 작업 식별자가 아닌 청구 식별자로 취급하십시오.

​
일반적인 함정

  • 오래된 비디오 상태 경로를 하드코딩하지 마십시오; poll_url을 선호하십시오.
  • 모델 계약이 허용하지 않는 한 첫 번째 프레임 필드를 전용 참조 이미지 흐름과 결합하지 마십시오.
  • duration이 입력 참조 비디오 길이를 설명한다고 가정하지 마십시오; 일반적으로 생성된 출력 길이를 제어합니다.
  • 타임아웃 후 작업이 이미 생성되었는지 확인하지 않고 생성 요청을 재시도하지 마십시오.

​
API 참조

주제참조
비디오 생성비디오 생성
비디오 상태 가져오기비디오 상태 가져오기
작업 상태 가져오기작업 상태 가져오기
작업 취소작업 취소
청구 및 가격 책정청구 및 가격 책정

​
OpenAI 스타일 및 Volc 호환 비디오 API

모델 전반의 TokenLab 통합 비디오 API에는 /v1/videos/generations를 사용하세요. 기존 Seedance 2.0 통합이 Volc 스타일 content[] 또는 Action 요청을 이미 사용한다면 /api/v3 아래의 Seedance 호환 엔드포인트를 사용할 수 있습니다. 두 방식 모두 TokenLab Bearer API Key와 비동기 폴링을 사용하지만 요청과 응답 형식은 다릅니다.