PixAI Platform
API v2 문서동영상

이미지 기반 동영상 생성 작업 생성

PixAI의 Tsubaki 동영상 모델로 이미지를 동영상으로 만듭니다. 동영상은 firstFrameMediaId에서 시작하며, lastFrameMediaId를 보내면 그 프레임에서 끝납니다. 출력은 첫 프레임의 종횡비를 유지합니다.

프레임은 이미지 미디어 ID입니다. POST /v2/media/image/upload-url로 직접 업로드하거나 생성한 이미지를 재사용하세요. 다른 사용자가 소유한 미디어는 거부됩니다.

이미지 기반 동영상 생성에는 PixAI 멤버십이 필요합니다. 크레딧은 작업 생성 시 차감됩니다. 결과는 GET /v2/task/{id}를 폴링하여 확인하며, 완료된 작업의 동영상은 outputs.videoMediaId입니다.

POST
/frame-video/create

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

curl -X POST https://api.pixai.art/v2/frame-video/create \  -H "Authorization: Bearer $PIXAI_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "tbkv1.0.1",    "firstFrameMediaId": "1943547603237249965",    "prompt": "she turns around and smiles, hair blowing in the wind",    "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
}