API v2 문서동영상
참조 동영상 생성 작업 생성
참조 이미지와, 모델에 따라 참조 동영상 및 오디오를 바탕으로 동영상을 생성합니다.
모델마다 받을 수 있는 참조가 다릅니다:
tbkv1.0.1,tbkv1.0(Tsubaki): 이미지 1–6개, 동영상 없음, 오디오 클립 최대 3개,duration5–15.v4.0,v4.0.1(Seedance 2, Seedance 2 Fast): 이미지 최대 9개, 동영상 최대 3개, 오디오 클립 최대 3개,duration4–15.v4.0.3(Seedance 2.5): 이미지 최대 30개, 동영상 최대 10개, 오디오 클립 최대 10개,duration4–30.v3.3(Vidu): 이미지 1–7개, 동영상·오디오 없음,duration3–16.
모든 모델에는 이미지나 동영상이 하나 이상 필요합니다. 단, v4.0.3은 오디오만으로도 생성할 수 있습니다.
참조 파일은 다음 제한을 충족해야 합니다:
- 동영상: MP4 또는 MOV, H.264 또는 HEVC, 24–60 fps, 클립당 2–15초, 합계 15초(
v4.0.3은 30초), 최대 50 MB(v4.0.3은 200 MB). - 오디오: WAV 또는 MP3, 클립당 2–15초, 합계 15초(
v4.0.3은 30초), 15 MiB 미만.
보내기 전에 GET /v2/media/{mediaId}/info로 파일을 확인하세요. v4.0과 v4.0.1에서는 개수와 클립 길이를 크레딧 차감 후에 검사하므로, 이를 위반한 작업은 거부되지 않고 실패합니다.
크레딧은 작업 생성 시 차감됩니다. 결과는 GET /v2/task/{id}를 폴링하여 확인하며, 완료된 작업의 동영상은 outputs.videoMediaId입니다.
Authorization
bearerAuth AuthorizationBearer <token>
인증이 필요한 모든 요청에는 HTTP 헤더에 다음을 추가하세요
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST https://api.pixai.art/v2/reference-video/create \ -H "Authorization: Bearer $PIXAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "tbkv1.0.1", "prompt": "the girl walks through the city at night", "referenceImageMediaIds": ["1943547603237249965"], "ratio": "9:16", "duration": 5 }'{
"id": "string",
"status": "waiting",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"startedAt": "2019-08-24T14:15:22Z",
"endAt": "2019-08-24T14:15:22Z",
"taskKind": "string",
"paidQuota": 0,
"taskStatusMsgI18n": {
"key": "string",
"defaultMessage": "string"
},
"outputs": {
"videoMediaId": "string",
"seed": "string",
"mediaIds": [
"string"
],
"mediaUrls": [
"string"
]
}
}{
"code": "string",
"status": 0,
"message": "string",
"data": {},
"defined": true
}{
"code": "string",
"status": 0,
"message": "string",
"data": {},
"defined": true
}{
"code": "string",
"status": 0,
"message": "string",
"data": {},
"defined": true
}{
"code": "string",
"status": 0,
"message": "string",
"data": {},
"defined": true
}{
"code": "string",
"status": 0,
"message": "string",
"data": {},
"defined": true
}