TokenLab

미디어 가이드

비디오 생성

텍스트, 이미지, 오디오 또는 기존 클립에서 비디오 생성

비디오 생성은 비동기식으로 처리됩니다. POST /v1/videos/generations는 작업 ID와 일반적으로 poll_url을 반환합니다. 비디오 생성이 완료될 때까지 해당 ID로 GET /v1/tasks/{id}를 폴링(poll)하십시오.

선택한 모델에서 허용하는 이미지 필드에 공개 HTTP(S) URL 또는 지원되는 데이터 URL을 전송하십시오. 이러한 입력은 일반적인 미디어 경로를 따르며 재사용 가능한 머티리얼 ID를 자동으로 생성하지 않습니다.

명시적 머티리얼이 아직 준비 중인 경우, POST /v1/videos/generations는 inactive_asset_ids와 함께 409 seedance_material_preparing을 반환합니다. 해당 에셋이 ACTIVE 상태가 될 때까지 폴링한 후, 동일한 머티리얼 ID로 다시 시도하십시오. 에셋이 FAILED 상태라면 error_message를 확인하고 수정하거나 재임포트한 후 다시 시도하십시오.

API 선택

새로운 비디오 통합에는 /v1/videos/generations를 사용하십시오. 이미 Volcengine content[] 또는 Action 요청을 전송 중인 기존 Seedance 2.0 클라이언트는 /api/v3를 통해 해당 형식을 유지할 수 있습니다. 두 API 모두 TokenLab Bearer 키를 사용하지만, 필드와 상태 값은 서로 다릅니다.

생성할 작업 선택

API가 작업에 적합한 필드를 검증할 수 있도록 operation을 명시적으로 설정하십시오.

작업 (Operation)필수 또는 일반적인 입력사용 사례
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"

TokenLab에서 반환된 모델 ID를 사용한 다음, operation과 해당 미디어 입력을 사용하여 생성 유형을 선택하십시오. 작업 이름을 모델 ID로 사용하지 마십시오.

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": "A calm cinematic shot of a cat walking through a sunlit garden",
    "resolution": "720p",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

인터넷에서 가져올 수 있는 미디어에는 https URL을 사용하십시오. 임시 URL은 TokenLab이 작업을 생성할 때까지 유효해야 합니다.

모델별 필드

오디오 동작은 선택한 모델 및 작업에 따라 달라집니다. 오디오 선택기가 노출되지 않더라도 비디오에 소리가 포함될 수 있습니다. 선택기를 생략하는 것은 false를 보내는 것과는 다릅니다.

  • veo3.1, veo3.1-fast 및 veo3.1-lite는 항상 오디오를 생성합니다. output_audio를 생략하거나 true를 보내십시오. false는 거부됩니다.
  • wan-2.6 및 wan-2.7은 항상 오디오를 포함합니다. output_audio를 생략하거나 true를 보내십시오. wan-3.0 및 wan-3.0-prime 또한 항상 오디오를 포함하며 오디오 선택기를 사용하지 않습니다.
  • hailuo-h3는 네이티브 오디오를 생성하며 음소거 스위치가 없습니다. 모델 세부 정보에 나열되지 않은 오디오 선택기를 보내지 마십시오.
  • viduq3-pro 및 viduq3-turbo는 기본적으로 오디오를 생성합니다. 무음 출력을 원하면 output_audio: false (또는 audio: false)를 보내십시오. Seedance 및 PixVerse 모델은 output_audio를 사용합니다. 기본값에 의존하지 말고 명시적으로 보내십시오. 해당 항목이 나열된 작업에만 사용하십시오.
  • audio_url / audio_urls는 입력 또는 참조 오디오를 제공합니다. 이는 오디오 출력 스위치가 아닙니다. 비디오 편집, 모션 전송 및 스타일 전송은 입력 사운드트랙을 유지할 수 있으며, 소스 오디오를 보존하는 것이 반드시 음소거를 의미하지는 않습니다.

허용된 값과 오디오 관련 가격은 모델 세부 정보를 확인하십시오. 모델에 나열된 경우, outputAudio, generate_audio 및 불리언 audio 별칭은 결합 시 output_audio와 일치해야 합니다. 모델 제품군의 모든 버전이나 작업이 동일한 오디오 제어 기능을 공유한다고 가정하지 마십시오.

  • Seedance 2.0 제품군의 경우, 4K 출력, Fast/Mini 해상도 제한 또는 멀티모달 참조 입력을 사용하기 전에 Seedance 2.0 비디오 모델 가이드를 읽어보십시오.
  • grok-imagine-video 비디오-투-비디오의 경우, prompt와 공개 HTTPS .mp4 video_url을 전송하십시오. 이전 작업에서 생성된 TokenLab .mp4 결과 URL도 사용할 수 있습니다. 이 작업은 duration, resolution 또는 aspect_ratio 선택기를 사용하지 않습니다.

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
  }'

완료된 비디오 가져오기

작업이 completed 또는 failed 상태가 될 때까지 생성 응답의 id 또는 task_id를 사용하여 GET /v1/tasks/{id}를 호출하십시오.

완료된 비디오 작업은 모델 및 출력 개수에 따라 video_url, video 또는 videos를 반환할 수 있습니다. billing_transaction_id는 작업 식별자가 아닌 결제 식별자로 취급하십시오.

비디오 결과 URL은 .mp4와 같이 파일 유형으로 끝나는 TokenLab 미디어 결과 URL이며 30일 동안 유효합니다. media_retention.items는 각 항목의 저장 상태와 expires_at을 보고합니다. 저장 상태를 제시간에 알 수 없는 경우 응답에서 media_retention이 생략될 수 있으며, URL은 여전히 작동합니다. 실패했거나 진행 중인 작업은 빈 비디오 URL 필드를 반환합니다. 비동기 작업 스냅샷은 별도의 수명 주기를 가집니다. 데이터 보존을 참조하십시오.

일반적인 주의 사항

  • 새 코드에서는 /v1/videos/generations/{id}와 같은 모달리티별 상태 경로를 사용하지 마십시오. GET /v1/tasks/{id}를 폴링하십시오.
  • 모델 세부 정보에서 허용하지 않는 한, 첫 프레임 필드를 전용 참조 이미지 흐름과 결합하지 마십시오.
  • duration이 입력 참조 비디오의 길이를 설명한다고 가정하지 마십시오. 일반적으로 생성된 출력 길이를 제어합니다.
  • POST /v1/videos/generations와 함께 Idempotency-Key를 전송하십시오. 타임아웃 후에는 동일한 키로 동일한 요청을 보내 원래 작업을 가져오십시오. 키가 없으면 재시도하기 전에 작업이 이미 생성되었는지 확인하십시오.

API 참조

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

Hailuo H3-Max는 텍스트, 첫 프레임 또는 첫 프레임과 마지막 프레임으로부터 480p 또는 768p 해상도의 5~15초 비디오를 생성합니다. 속도 중심의 워크플로우는 촬영 아이디어를 짧은 클립으로 빠르게 전환하는 데 유용합니다.

{
  "model": "hailuo-h3-max",
  "operation": "text-to-video",
  "prompt": "A slow camera move through a quiet garden",
  "resolution": "768p",
  "duration": 5,
  "aspect_ratio": "16:9"
}

이 페이지의 내용