PixAI Platform
API v2 문서미디어

이미지 업로드 URL 발급

입력으로 사용할 이미지(contextImages 항목, 동영상 프레임, 인페인트 베이스 이미지 등)를 업로드하는 1단계입니다.

  1. 이 엔드포인트를 호출하여 uploadUrl과 externalId를 받습니다.
  2. 원시 이미지 바이트를 HTTP PUT으로 uploadUrl에 보내고, 파일의 실제 Content-Type(예: image/png)을 지정합니다. 멀티파트 폼은 사용하지 마세요.
  3. externalId로 POST /v2/media/image/register를 호출합니다. 응답의 id가 다른 엔드포인트에 전달할 미디어 ID입니다.
POST
/media/image/upload-url

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

# 1. 업로드 URL 발급UPLOAD=$(curl -s -X POST https://api.pixai.art/v2/media/image/upload-url \  -H "Authorization: Bearer $PIXAI_API_KEY" \  -H "Content-Type: application/json" -d '{}')URL=$(echo "$UPLOAD" | jq -r .uploadUrl)EXTERNAL_ID=$(echo "$UPLOAD" | jq -r .externalId)# 2. 바이트 업로드curl -X PUT "$URL" -H "Content-Type: image/png" --data-binary @input.png# 3. 등록하고 미디어 ID 확인curl -s -X POST https://api.pixai.art/v2/media/image/register \  -H "Authorization: Bearer $PIXAI_API_KEY" \  -H "Content-Type: application/json" \  -d "{\"externalId\": \"$EXTERNAL_ID\"}" | jq -r .id
{
  "uploadUrl": "string",
  "externalId": "string"
}
{
  "code": "string",
  "status": 0,
  "message": "string",
  "data": {},
  "defined": true
}

오디오 파일 업로드 URL 발급 POST

`POST /v2/reference-video/create`의 `referenceAudioMediaIds`에 사용할 오디오 클립을 업로드하는 1단계입니다. 흐름은 이미지와 같습니다. 파일의 `Content-Type`(`audio/mpeg` 또는 `audio/wav`)을 지정해 바이트를 `uploadUrl`에 `PUT`한 다음 `POST /v2/media/audio/register`를 호출하세요.

동영상·오디오 파일 정보 조회 GET

동영상 또는 오디오 미디어 항목의 길이, 크기, 컨테이너, 코덱을 반환합니다. 참조 동영상 작업을 생성하기 전에 참조 파일이 모델의 제한을 충족하는지 확인할 수 있습니다.