TokenLab

비디오 및 자료

비디오 생성

비디오 생성 작업 시작

POST
/v1/videos/generations

개요

비디오 생성은 비동기 방식으로 진행됩니다. 생성 요청이 성공하면 작업 id(task_id와 동일한 값)와 poll_url이 반환됩니다. status가 completed 또는 failed가 될 때까지 해당 ID로 GET /v1/tasks/{id}를 호출한 다음, video_url을 확인하십시오. 비디오 상태 가져오기를 참조하십시오.

  • 결과 파일은 30일 동안 저장됩니다. 더 오래 보관해야 할 경우 다운로드하십시오. 데이터 보존을 참조하십시오.
  • 대기 중인 Seedance 작업은 작업 취소를 통해 취소할 수 있습니다.
  • 비용은 작업이 수락될 때 예약되며, 작업이 완료되거나 실패할 때 정산됩니다. 결제 및 요금을 참조하십시오.
  • 타임아웃 후 생성 요청을 안전하게 재시도하려면 Idempotency-Key 헤더를 전송하십시오.

각 모델은 고유한 작업과 필드를 지원합니다. GET /v1/models/{model}(모델 가져오기)은 모든 작업에 대해 허용되는 필드, 해상도, 지속 시간 및 화면 비율을 나열합니다. 해당 목록에 없는 필드나 값을 설정하면 허용되는 값과 함께 400 오류가 반환됩니다. duration, resolution, aspect_ratio 및 output_audio를 직접 설정하십시오. 하나라도 생략하면 TokenLab은 해당 작업에 대한 모델의 기본값을 사용하며, 일치하는 기본값이 없으면 요청은 400 오류를 반환하고 설정해야 할 필드 이름을 알려줍니다.

오디오 및 미디어 입력

오디오 동작은 선택한 모델 및 작업에 따라 달라집니다. 오디오 선택기가 노출되지 않더라도 비디오에 소리가 포함될 수 있습니다. 선택기를 생략하는 것은 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와 일치해야 합니다. 모델 제품군의 모든 버전이나 작업이 동일한 오디오 제어 기능을 공유한다고 가정하지 마십시오.

이미지, 비디오 및 오디오에는 공개적으로 접근 가능한 https URL을 사용하고, 작업이 시작될 때까지 해당 URL이 유효하도록 유지하십시오. 미디어 URL은 최대 8,192자까지 가능합니다. 일부 모델은 인라인 data: 이미지 URL(필드당 최대 2,000,000자)도 허용하지만, 대용량 파일의 경우 URL 방식이 더 안정적입니다. 동일한 요청 내에서 인라인 base64와 원격 URL을 혼용하지 마십시오.

요청 본문

modelstring기본값: veo3.1

비디오 모델 ID입니다. 모델 목록(recommended_for=video)을 통해 현재 비디오 모델을 확인한 후, 모델을 명시적으로 전송하십시오.

PixVerse

  • 모델: pixverse-c1, pixverse-v6, pixverse-v5.6
  • 작업: text-to-video, image-to-video, start-end-to-video, reference-to-video
  • 오디오 선택기: output_audio, 기본값 false

TokenLab에서 위의 PixVerse 모델은 operation=video-extension을 허용하지 않습니다.

HappyHorse

  • 모델: happyhorse-1.0
  • 작업: text-to-video, image-to-video, reference-to-video, video-to-video
  • 오디오 선택기: output_audio를 전송하지 마십시오
promptstring

비디오에 대한 텍스트 설명으로, 최대 10,000자까지 가능합니다. 대부분의 작업에서 필요하지만, 모델 상세 정보에서 필요하지 않은 작업을 확인할 수 있습니다.

operationstring

생성 모드: text-to-video, image-to-video, reference-to-video, start-end-to-video, video-to-video, video-extension 또는 motion-control. 각 모델은 이 중 일부만 지원하며, 지원하지 않는 모드를 사용할 경우 400 unsupported_operation을 반환합니다. 이 값을 생략하면 TokenLab이 입력값을 바탕으로 추론합니다. extend_at 또는 extend_times가 포함된 task_id는 video-extension으로, 참조 이미지나 자료가 있으면 reference-to-video로, end_image가 있으면 start-end-to-video로, 비디오 입력이 있으면 video-to-video로, 이미지 입력(image, image_url, image_urls 또는 start_image)이 있으면 image-to-video로, 그 외의 경우에는 text-to-video로 설정됩니다. 필드 불일치로 인한 오류를 조기에 방지하려면 명시적으로 값을 전송하십시오.

image_urlstring

첫 번째 프레임 이미지의 공개 접근 가능한 URL입니다. Seedance 2.0 모델은 ACTIVE 상태인 TokenLab 자료를 첫 번째 프레임으로 사용하기 위해 asset://asset-YYYYMMDDHHMMSS-xxxxx도 허용합니다. 가장 폭넓은 모델 지원을 위해 https URL을 사용하는 것을 권장합니다.

imagestring

데이터 URL 형식의 인라인 이미지입니다(예: data:image/jpeg;base64,...). 일부 모델만 허용하며, image_url이 더 많은 모델에서 작동합니다.

image_urlsarray

이 필드를 나열하는 모델을 위한 이미지 URL입니다. 개수 제한은 reference_images를 참조하십시오.

reference_imagesarray

reference-to-video를 위한 참조 이미지로, https URL 또는 데이터 URL로 제공합니다. 개수 제한은 모델에 따라 다릅니다:

  • seedance-2.0, seedance-2.0-fast 및 seedance-2.0-mini: 자료 자산을 포함하여 총 9개까지의 이미지 참조가 가능합니다. 초과 시 400 too_many_seedance_reference_images가 반환됩니다.
  • seedance-2.5: image_urls와 reference_images를 합쳐 총 30개까지의 이미지 입력이 가능합니다.
  • grok-imagine-video: 최대 7개까지 가능하며, duration은 10초로 제한됩니다. grok-imagine-video-1.5 및 grok-imagine-video-1.5-preview는 참조 이미지를 허용하지 않습니다.
  • 기타 모델: 모델 상세 정보를 참조하십시오. 제한을 초과하는 요청은 400 too_many_items를 반환합니다.

Seedance 2.0 모델은 ACTIVE 상태인 TokenLab 자료에 대해 asset://asset-YYYYMMDDHHMMSS-xxxxx도 허용합니다. 모델 선택, 4K 경계 및 Mini 관련 참고 사항은 Seedance 2.0 비디오 모델 가이드를 참조하십시오. grok-imagine-video의 경우, 참조 이미지를 image_url 또는 image와 함께 사용하지 마십시오.

start_imagestring

첫 번째 프레임 이미지입니다. end_image와 함께 사용하면 요청은 start-end-to-video가 됩니다. end_image가 없으면 image-to-video가 되며, start_image는 해당 계약에 명시된 모델에서 image와 동일하게 작동합니다. 공개 URL 또는 데이터 URL을 허용하며, Seedance 2.0 모델은 asset://asset-YYYYMMDDHHMMSS-xxxxx 형식도 허용합니다.

end_imagestring

start-end-to-video를 위한 마지막 프레임 이미지입니다. start_image와 동일한 입력을 허용합니다.

material_asset_idstring

자료 자산 생성을 통해 반환된 TokenLab Seedance 자료 자산 ID입니다. Seedance 2.0 모델에서만 허용되며, 다른 모델은 400 unsupported_seedance_material_asset_model을 반환합니다. 자산은 ACTIVE 상태여야 하며 귀하의 계정에 속해야 합니다. 이 필드는 일반적인 참조 입력입니다. 첫 번째 프레임, 마지막 프레임 또는 참조 이미지의 의미를 명시적으로 지정하려면 start_image, end_image 또는 reference_images에 asset://<material_asset_id>를 대신 넣으십시오.

material_asset_idsarray

최대 9개의 TokenLab Seedance 자료 자산 ID입니다. 이는 Seedance 2.0 모델의 9개 이미지 참조 제한에 포함됩니다.

일반 이미지 URL은 이미지 입력으로 전달되며 재사용 가능한 자료 자산을 생성하지 않습니다. 자료 API를 통해 재사용 가능한 자산을 생성한 다음, 해당 TokenLab ID 또는 asset://asset-YYYYMMDDHHMMSS-xxxxx URI를 사용하십시오. 명시적 자료가 409 seedance_material_preparing을 반환하면, 반환된 inactive_asset_ids를 확인하고 해당 자료가 ACTIVE 상태가 된 후 재시도하십시오.

video_urlstring

이 필드를 나열하는 모델에서 video-to-video, video-extension 및 motion-control 작업을 수행할 때 사용하는 소스 비디오의 공개 접근 가능한 URL입니다.

video_urlsarray

이 필드를 나열하는 모델을 위한 소스 또는 참조 비디오입니다. seedance-2.5는 video_url과 video_urls를 합쳐 총 10개까지의 비디오 입력을 허용합니다. 다른 모델은 모델 상세 정보를 참조하십시오.

audio_urlstring

이 필드를 나열하는 모델에서 오디오 참조 또는 오디오 기반 작업을 위한 공개 오디오 URL입니다. 이는 입력값이며 오디오 출력 스위치가 아닙니다.

audio_urlsarray

이 필드를 나열하는 모델을 위한 참조 오디오입니다. seedance-2.5는 audio_url과 audio_urls를 합쳐 총 10개까지의 오디오 입력을 허용하며, 프롬프트 없이 오디오 참조만으로 요청하는 것을 허용합니다. seedance-2.5의 경우, 참조 오디오와 참조 비디오를 합쳐 최대 30초까지 가능합니다.

task_idstring

이 필드를 나열하는 모델에서 video-extension 작업을 수행하기 위한 워크스페이스 내 이전 작업의 ID입니다. 워크스페이스에 속하지 않은 작업 ID를 사용하면 403 task_not_owned가 반환됩니다.

extend_atinteger

video-extension이 시작되는 소스 비디오의 초 단위 시점입니다. grok-imagine-video에서 필수입니다.

extend_timesstring

이 필드를 나열하는 모델에서 video-extension으로 추가할 시간(초)입니다. grok-imagine-video는 6 또는 10을 허용합니다.

durationinteger

출력 지속 시간(초)입니다. 허용되는 값은 모델과 작업에 따라 다르며, 다른 값을 입력하면 400 invalid_duration이 반환됩니다. Seedance 모델은 모델의 범위 내에서 모델이 선택하도록 -1을 허용합니다. 이 경우 작업이 완료될 때까지 비용이 보수적으로 추정됩니다. motion-control 및 grok-imagine-video의 비디오-투-비디오 작업과 같이 지속 시간이 필요 없는 작업도 있습니다.

secondsinteger

duration에 대한 호환성 별칭입니다. 둘 다 전송할 경우 값이 동일해야 합니다.

aspect_ratiostring

화면 비율(예: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 또는 Seedance의 경우 adaptive)입니다. 허용되는 값은 모델과 작업에 따라 다르며, 다른 값을 입력하면 400 invalid_aspect_ratio가 반환됩니다.

resolutionstring

출력 해상도(예: 480p, 720p, 1080p 또는 4k)입니다. 허용되는 값은 모델과 작업에 따라 다르며, 일부 모델은 360p, 540p 또는 768p를 사용하기도 합니다. 다른 값을 입력하면 400 invalid_resolution이 반환됩니다.

output_audioboolean

이 필드를 나열하는 작업에 대한 오디오 출력 선택기입니다. 생략 시 모델 기본값을 따르며, false는 모델이 허용하는 경우에만 무음 출력을 요청합니다. 위의 오디오 참고 사항과 선택한 모델의 상세 정보를 참조하십시오.

output_formatstring

seedance-2.5와 같이 이 필드를 나열하는 모델을 위한 컨테이너 형식(mp4 또는 mov)입니다. 이 필드를 나열하지 않는 모델에서는 생략하십시오.

return_last_frameboolean

마지막으로 생성된 프레임을 last_frame_url로도 반환합니다. Seedance 모델 전용입니다.

watermarkboolean

이 필드를 나열하는 모델(Seedance 모델)에 대한 워터마크 토글입니다.

negative_promptstring

이 필드를 나열하는 모델에서 생성된 비디오에서 피해야 할 요소로, 최대 5,000자까지 가능합니다.

seedinteger

이 필드를 나열하는 모델에서 재현 가능한 생성을 위한 시드 값입니다. Seedance 2.0 모델은 무작위 시드를 위해 -1을 허용하지만, seedance-2.5는 이 필드를 허용하지 않습니다.

fpsinteger

이 필드를 나열하는 모델에 대한 초당 프레임 수(1-120)입니다.

framesinteger

이 필드를 나열하는 모델에 대한 프레임 수입니다. Seedance 모델은 허용하지 않습니다.

execution_expires_afterinteger

Seedance 모델에서 작업이 대기열에서 만료되기 전까지 대기할 수 있는 시간(3600~259200초)입니다.

priorityinteger

Seedance 모델에 대한 작업 우선순위(0~9)입니다. service_tier=flex와 함께 사용하지 마십시오.

service_tierstring

Seedance 2.0 및 2.5 모델에서 default는 호환성을 위해 허용되며 아무 작업도 수행하지 않습니다. flex는 해당 모델에서 거부됩니다.

safety_identifierstring

Seedance 모델에 대한 최종 사용자 안전 식별자(최대 128자)입니다. 생략 시 TokenLab은 제공된 경우 user를 사용합니다.

toolsarray

Seedance 2.0 및 2.5 모델에서 생성 중에 모델이 사용할 수 있는 도구입니다. 지원되는 도구는 {"type": "web_search"}입니다.

userstring

최종 사용자를 위한 고유 식별자입니다. Seedance 모델의 경우, 해당 필드가 생략되면 TokenLab은 이를 safety_identifier로도 사용합니다.

호환 가능한 필드 이름

  • 기본 필드는 snake_case를 사용합니다: aspect_ratio, output_audio, reference_images.
  • 호환성을 위해 TokenLab은 ratio, generate_audio, outputAudio, seconds, referenceImages도 허용합니다.
  • 기본 필드와 별칭이 모두 전송된 경우, 값은 일치해야 합니다. 불일치 시 conflicting_audio_selector, conflicting_duration 또는 conflicting_aspect_ratio와 함께 400 오류가 반환됩니다.

Seedance 매개변수

Seedance 모델(seedance-2.0, seedance-2.0-fast, seedance-2.0-mini 및 seedance-2.5)은 위의 TokenLab 필드 이름과 seconds, ratio, generate_audio 별칭을 사용합니다. 버전별 차이점은 다음과 같습니다:

Seedance 2.0 모델seedance-2.5
해상도seedance-2.0: 480p, 720p, 1080p, 4k. seedance-2.0-fast 및 seedance-2.0-mini: 480p, 720p480p, 720p
지속 시간-1, 4~15초-1, 4~30초
화면 비율1:1, 3:4, 4:3, 9:16, 16:9, 21:9, adaptive텍스트-투-비디오 및 참조-투-비디오는 동일. 이미지-투-비디오, 시작-끝, 비디오 편집 및 확장은 adaptive 필요; 비디오 편집은 duration=-1도 필요
출력 형식mp4mp4 또는 mov
seed허용허용 안 됨
참조 입력자료를 포함한 9개의 이미지 참조(자료는 이 모델에서만 허용)총 30개의 이미지, 10개의 비디오, 10개의 오디오 파일

모델 상세 정보가 이러한 값에 대한 현재 기준입니다. 기본값에 의존하는 대신 duration, resolution, aspect_ratio 및 output_audio를 명시적으로 전송하십시오. 모델의 recommended_request는 일반적인 요청 예시를 보여줍니다.

duration=-1 또는 seconds=-1을 설정하면 Seedance가 모델 범위 내에서 출력 지속 시간을 선택합니다. TokenLab은 작업이 완료되기 전에 비용을 보수적으로 추정하며, 작업이 완료되면 실제 사용량에 따라 정산합니다. service_tier=flex 및 frames는 이 모델들에서 거부됩니다.

Seedance 예시

cURL
curl -X POST "https://api.tokenlab.sh/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A sleek product reveal with cinematic camera movement",
    "operation": "text-to-video",
    "duration": -1,
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "output_audio": true
  }'

응답

결과, 오류, 타임스탬프 및 모델을 설명하는 필드는 작업에 대해 사용 가능한 경우 반환됩니다.

idstring

작업 ID입니다. task_id와 동일합니다.

task_idstring

GET /v1/tasks/{id}로 폴링할 작업 ID입니다.

poll_urlstring

이 작업에 대한 상태 URL인 /v1/tasks/{id}입니다. API 키와 함께 호출하십시오.

statusstring

작업 상태: pending, processing, completed, failed. 새 작업은 일반적으로 pending 상태입니다.

createdinteger

작업이 생성된 Unix 타임스탬프입니다.

modelstring

사용된 모델입니다.

billing_transaction_idstring

정산이 이미 완료된 경우의 결제 거래 ID입니다. 작업 ID와는 별개입니다.

video_urlstring

생성 응답에 결과가 이미 포함된 경우에만 제공되는 비디오 URL입니다. 일반적으로 상태 응답에서 읽어옵니다.

errorstring | object

작업 실패 시 오류 메시지 또는 구조화된 오류 객체입니다.

오류

상태 및 코드의미
400 invalid_request필드가 잘못되었거나, 범위를 벗어났거나, 누락되었습니다. error.param이 해당 필드를 명시합니다. "Set aspect_ratio explicitly"와 같은 메시지는 생략된 필드에 대해 이 요청에 대한 기본값이 없음을 의미합니다.
400 unsupported_operation, unsupported_parameter, invalid_resolution, invalid_duration, invalid_aspect_ratio, invalid_parameter_value, too_many_items, prompt_too_long요청이 해당 작업에 대해 모델이 허용하는 것과 일치하지 않습니다. 오류 메시지에 보통 허용되는 값이 나열됩니다.
400 invalid_parameter입력값이 작업에 맞지 않습니다(예: text-to-video와 함께 전송된 이미지).
400 conflicting_audio_selector, conflicting_duration, conflicting_aspect_ratio별칭과 기본 필드의 값이 일치하지 않습니다.
400 unpriceable_selection선택한 조합에 대한 가격이 없습니다. resolution, duration, aspect_ratio 또는 오디오 설정을 변경하십시오.
400 too_many_seedance_reference_images, unsupported_seedance_material_asset_modelSeedance 2.0 모델에 대한 이미지 참조가 너무 많거나, 다른 모델에 자료가 전송되었습니다.
402잔액 부족입니다.
403 task_not_ownedtask_id가 다른 워크스페이스에 속해 있습니다.
409 seedance_material_preparing, seedance_material_route_unavailable자료가 아직 ACTIVE 상태가 아니거나, 선택한 모델이 제공된 자료를 사용할 수 없습니다.
429속도 제한 초과입니다. 속도 제한을 참조하십시오.

요청

curl -X POST "https://api.tokenlab.sh/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1",
    "prompt": "A cat walking through a garden, cinematic lighting",
    "operation": "text-to-video",
    "duration": 4,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

응답

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "veo3.1",
  "created": 1706000000
}

이미지-투-비디오

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "hailuo-2.3",
        "prompt": "The scene begins from the provided image and adds gentle natural motion.",
        "operation": "image-to-video",
        "image_url": "https://example.com/image.jpg",
        "duration": 6,
        "resolution": "768p"
    }
)

참조-투-비디오

모델이 전용 참조 컨디셔닝을 지원하는 경우 operation=reference-to-video를 사용하십시오. 이미지 참조는 reference_images에 넣고, 참조 비디오와 오디오를 사용하는 모델은 video_urls와 audio_urls를 사용합니다. duration은 생성된 출력 길이를 설정할 뿐이며, 참조 비디오 입력의 길이를 제한하지 않습니다. 모델별 개수 제한은 위의 reference_images를 참조하십시오.

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "veo3.1",
        "prompt": "Keep the same subject identity, palette, and framing while adding subtle natural motion.",
        "operation": "reference-to-video",
        "reference_images": [
            "https://example.com/ref-a.jpg",
            "https://example.com/ref-b.jpg"
        ],
        "duration": 8,
        "resolution": "720p",
        "aspect_ratio": "9:16"
    }
)

키프레임 제어

첫 번째 프레임과 마지막 프레임을 제어하려면 start_image와 end_image를 사용하십시오:

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "viduq2-pro",
        "operation": "start-end-to-video",
        "start_image": "https://example.com/day.jpg",
        "end_image": "https://example.com/night.jpg",
        "duration": 5,
        "resolution": "720p"
    }
)

비디오-투-비디오

모델이 기존 비디오를 기본 입력으로 허용하는 경우 operation=video-to-video를 사용하십시오. grok-imagine-video의 경우, video_url에 공개 HTTPS .mp4 URL과 편집 prompt를 전송하고 resolution, duration, aspect_ratio는 생략하십시오.

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "grok-imagine-video",
        "operation": "video-to-video",
        "video_url": "https://example.com/source.mp4",
        "prompt": "Enhance the clip while preserving the original motion."
    }
)

비디오 확장

이전 결과를 이어가려면 operation=video-extension을 사용하십시오. 워크스페이스의 작업 task_id와 prompt를 전송하십시오. 다른 필드는 모델에 따라 다릅니다. grok-imagine-video는 extend_at이 필요하며 extend_times로 6 또는 10을 허용합니다. veo3.1 및 veo3.1-fast는 task_id와 prompt를 사용합니다. Seedance 모델은 이 작업에 대해 video_url, video_urls 및 task_id를 나열합니다.

모션 제어

모델이 피사체 이미지와 모션 참조 비디오를 모두 필요로 하는 경우 operation=motion-control을 사용하십시오. image_url과 video_url을 전송하십시오. resolution은 필수입니다.

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "kling-3.0-motion-control",
        "operation": "motion-control",
        "prompt": "Keep the subject identity stable while following the motion reference.",
        "image_url": "https://example.com/subject.png",
        "video_url": "https://example.com/motion.mp4",
        "resolution": "720p"
    }
)

모델 탐색

공개 비디오 인벤토리와 지원되는 작업은 시간이 지남에 따라 변경됩니다. 모델별 흐름을 구성하기 전에 모델 API를 사용하여 현재 지원 여부를 확인하십시오:

curl "https://api.tokenlab.sh/v1/models?recommended_for=video"

curl "https://api.tokenlab.sh/v1/models/veo3.1"

모델별 작업이나 필드에 의존하기 전에 모델 상세 응답을 읽어보십시오. video-extension 및 motion-control과 같은 작업은 모델별로 다르므로, 이 페이지의 정적 예시에 의존하지 말고 현재 가용성을 확인하십시오.

인증

BearerAuth
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

헤더

X-TokenLab-Delivery-Policy?string

요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.

허용 값

  • "auto"
  • "verified"
  • "official"
Idempotency-Key?string

생성 요청을 안전하게 재시도할 수 있게 하는 선택적 키입니다. 각 작업마다 UUID와 같은 새로운 고유 값을 전송하십시오. 동일한 키와 동일한 본문으로 재시도하면 원래 생성 요청의 결과(일반적으로 원래 작업)가 반환되며, 두 번째 작업이 생성, 발송 또는 청구되지 않습니다. 이미 수락된 키와 다른 본문을 전송하면 409 오류가 발생합니다. 255자를 초과하는 키는 무시되며, 해당 요청은 멱등성 보호를 받지 못합니다. 멱등성 키를 사용한 안전한 재시도를 참조하십시오.

길이1 <= length <= 255

요청 본문

application/json

응답

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json