WAND wiki
최근 문서

검색 결과가 없습니다. 모델명이나 다른 키워드로 검색해 보세요.

↑ ↓ 이동 ↵ 열기전체 결과 보기 →
Tokenhub APILast Updated 2026-10-03

Vega VideoHOT

On this page

화이트리스트 등록이 필요한 모델입니다.

사용 전 Vega Video 모델과 소재 관리 기능의 접근 권한을 신청하십시오.

Endpoint: POST https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-videos/tasks

Vega Video는 텍스트와 참조 이미지·영상·오디오로 영상을 생성합니다. 요청 후 작업 ID로 상태와 결과를 조회합니다.

기본 정보

항목 값
호출 방식 TokenHub API / Bearer 인증
입력 텍스트 / 첫·마지막 프레임 / 참조 이미지·영상·오디오
결과 조회 GET /v1/wand/vega-videos/tasks/{id}
결과 필드 content.video_url

버전별 지원 규격

버전 해상도 비율 길이
wand-vega-video-1.5-pro 720P / 1080P / 2K / 4K 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive 4~15초 / -1
wand-vega-video-1.0-pro 720P / 1080P / 2K / 4K 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive 4~15초 / -1
wand-vega-video-1.0-lite 768P / 1080P / 2K / 4K 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive 4~15초

duration=-1은 Pro에서 모델이 길이를 결정하도록 지정합니다. 기본 길이는 5초, 기본 비율은 adaptive입니다. Lite에는 -1을 사용하지 않습니다.

요청 파라미터

파라미터 필수 타입 설명
model 필수 String 버전별 모델 ID
content 필수 Array 텍스트와 참조 미디어. type=text 요소를 하나 이상 포함
content[].type 필수 String text / image_url / video_url / audio_url
content[].text 조건부 필수 String type=text일 때 비어 있지 않은 프롬프트. 여러 요소는 순서대로 연결
content[].image_url.url 조건부 필수 String type=image_url일 때 이미지 URL
content[].video_url.url 조건부 필수 String type=video_url일 때 영상 URL
content[].audio_url.url 조건부 필수 String type=audio_url일 때 오디오 URL
content[].role 조건부 필수 String 미디어 요소의 역할. 아래 조합표 참조
resolution 선택 String 출력 해상도 등급
ratio 선택 String 출력 비율. 기본 adaptive
duration 선택 Integer 길이(초). 기본 5
options.return_last_frame 선택 Boolean 마지막 프레임 반환 요청. 기본 false

참조 입력

type role 용도
image_url first_frame 첫 프레임
image_url last_frame 마지막 프레임
image_url reference_image 참조 이미지
video_url reference_video 참조 영상
audio_url reference_audio 참조 오디오

미디어 요소에는 role을 지정합니다. URL은 공개 HTTP/HTTPS 주소 또는 유효한 서명 URL을 사용하며 Base64 인라인 입력은 사용하지 않습니다.

참조 입력은 이미지 9장, 영상 3개, 오디오 3개 이내이면서 합계 12개 이하로 구성하는 것을 권장합니다. 오디오만 입력하기보다 참조 이미지나 영상을 함께 전달하십시오.

요청 예시

텍스트 기반 생성

LANGUAGE
{
  "model": "wand-vega-video-1.0-lite",
  "content": [
    {"type": "text", "text": "A red ceramic cup on a white table, slow camera push in."}
  ],
  "resolution": "768P",
  "ratio": "16:9",
  "duration": 4
}

참조 이미지 기반 생성

LANGUAGE
{
  "model": "wand-vega-video-1.5-pro",
  "content": [
    {"type": "text", "text": "Preserve the reference product and slowly orbit the camera."},
    {
      "type": "image_url",
      "image_url": {"url": "https://example.com/reference.jpg"},
      "role": "reference_image"
    }
  ],
  "resolution": "720P",
  "ratio": "16:9",
  "duration": 4,
  "options": {"return_last_frame": true}
}

응답 및 결과 조회

생성 응답의 id로 GET /v1/wand/vega-videos/tasks/{id}를 조회합니다. 상태 조회는 3~5초 간격으로 수행합니다.

LANGUAGE
{
  "id": "<task_id>",
  "model": "wand-vega-video-1.0-lite",
  "status": "queued"
}
상태 의미 처리
queued 대기 조회 계속
running 생성 중 조회 계속
succeeded 완료 결과 다운로드
failed 실패 error.code / error.message 확인
필드 타입 설명
id String 작업 ID
model String 요청에 사용한 모델 ID
status String 작업 상태
content.video_url String 완료 영상의 임시 다운로드 주소. 유효기간 12시간
content.last_frame_url String 마지막 프레임 주소. 반환 옵션을 켜고 결과가 생성된 경우에만 포함
error.code String 작업 오류 코드
error.message String 실패 사유
LANGUAGE
{
  "id": "<task_id>",
  "model": "wand-vega-video-1.5-pro",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/result.mp4",
    "last_frame_url": "https://example.com/last-frame.jpg"
  }
}

Pro / 소재 라이브러리 참조

asset://<id> 참조는 Pro에서만 지원합니다. Lite는 원본 이미지의 HTTP/HTTPS URL을 사용하십시오.

소재 등록

POST /v1/wand/vega-video-assets에 action=create를 전달합니다. 등록 응답은 소재 ID를 즉시 반환하며, 소재 처리는 별도로 진행됩니다.

파라미터 필수 타입 설명
action 필수 String create
url 필수 String 원본 소재의 HTTP/HTTPS URL. Base64 입력 미지원
asset_type 필수 String 대소문자를 구분하는 Image / Video / Audio
asset_name 선택 String 관리용 소재 이름
group_id 선택 String 소재 그룹 ID. 생략하면 자동 생성
is_real_person 선택 Boolean 실사 인증 소재 여부. true는 실사 인증으로 발급된 그룹 ID 필요
LANGUAGE
{
  "action": "create",
  "url": "https://example.com/product.jpg",
  "asset_type": "Image",
  "asset_name": "reference-product"
}

소재 조회와 주소

GET /v1/wand/vega-video-assets/{id}를 조회합니다. status=DONE이 되면 생성 요청에 소재 ID를 사용할 수 있습니다.

필드 설명
id 소재 ID. 생성 요청에서 asset://<id>로 참조
status WAIT / DONE / FAIL
url TOS의 임시 서명 다운로드 주소. 반환된 경우에만 사용하며 유효기간은 약 11.5시간
group_id 소재 그룹 ID. 반환된 경우에 포함
message 실패 사유 또는 추가 설명

asset://<id>는 다운로드 주소가 아닙니다. 파일을 내려받을 때는 조회 응답의 url을 사용하고, 생성 요청에서는 asset://<id>를 사용합니다. 서명 URL의 쿼리 문자열을 제거하지 마십시오.

LANGUAGE
{
  "id": "<asset_id>",
  "status": "DONE",
  "url": "https://example.com/reference.jpg?signature=...",
  "group_id": "<group_id>"
}

등록 소재로 영상 생성

LANGUAGE
{
  "model": "wand-vega-video-1.5-pro",
  "content": [
    {"type": "text", "text": "Preserve the reference subject and create natural motion."},
    {
      "type": "image_url",
      "image_url": {"url": "asset://<asset_id>"},
      "role": "reference_image"
    }
  ],
  "resolution": "720P",
  "ratio": "16:9",
  "duration": 4
}

소재 삭제

POST /v1/wand/vega-video-assets에 action=delete를 전달합니다. id와 group_id 중 하나만 지정합니다. 그룹 삭제는 그룹 전체 소재에 적용됩니다.

LANGUAGE
{
  "action": "delete",
  "id": "<asset_id>"
}

정상 삭제 응답의 deleted는 true입니다. 선택적인 request_id 추적이 필요한 경우 X-Request-Id 헤더를 전달합니다.

Contact us about WAND