PixVerse V6 Max 동영상 생성

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "pixverse-v6-max",
    "prompt": "A blue glass marble rolls across a clean white table in morning light",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "audio": true
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "pixverse-v6-max",
        "prompt": "A blue glass marble rolls across a clean white table in morning light",
        "duration": 5,
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "audio": True
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "pixverse-v6-max",
    prompt: "A blue glass marble rolls across a clean white table in morning light",
    duration: 5,
    resolution: "720p",
    aspect_ratio: "16:9",
    audio: true
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

POST

videos

generations

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "pixverse-v6-max",
    "prompt": "A blue glass marble rolls across a clean white table in morning light",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "audio": true
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "pixverse-v6-max",
        "prompt": "A blue glass marble rolls across a clean white table in morning light",
        "duration": 5,
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "audio": True
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "pixverse-v6-max",
    prompt: "A blue glass marble rolls across a clean white table in morning light",
    duration: 5,
    resolution: "720p",
    aspect_ratio: "16:9",
    audio: true
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

이 엔드포인트는 비동기로 처리됩니다. 제출 후 반환된 task_id를 사용하여 GET /v1/videos/generations/{task_id}로 작업 상태와 결과를 조회하세요.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "pixverse-v6-max",
    "prompt": "A blue glass marble rolls across a clean white table in morning light",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "audio": true
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "pixverse-v6-max",
        "prompt": "A blue glass marble rolls across a clean white table in morning light",
        "duration": 5,
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "audio": True
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "pixverse-v6-max",
    prompt: "A blue glass marble rolls across a clean white table in morning light",
    duration: 5,
    resolution: "720p",
    aspect_ratio: "16:9",
    audio: true
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

모델 기능

PixVerse V6 Max는 PixVerse V6의 고화질 버전입니다. 텍스트 및 단일 이미지 기반 동영상 생성만 지원하며, 두 모드 모두 pixverse-v6-max 모델 이름을 사용합니다.

모드	입력 방법	화면비
텍스트로 동영상 생성	`image_urls`를 생략하고 `prompt`를 필수로 제공	`aspect_ratio` 사용, 기본값 `16:9`
이미지로 동영상 생성	`image_urls`에 이미지 1장 제공, `prompt`는 선택 사항	입력 이미지를 따르며 `aspect_ratio`는 적용되지 않음

첫 프레임과 마지막 프레임 간 전환, 여러 이미지 융합, 동영상 연장에는 PixVerse V6를 사용하세요.

요청 헤더

string

필수

Bearer 인증: Bearer <token>. <token>은 APIMart API Key입니다.

요청 매개변수

string

필수

pixverse-v6-max로 지정해야 합니다.

string

생성할 내용에 대한 설명입니다. 텍스트로 동영상 생성 시 필수이며 최대 5000자, 이미지로 동영상 생성 시 선택 사항이며 최대 2048자입니다.

string[]

입력 이미지 URL 목록입니다. 이미지로 동영상 생성 시 정확히 1장만 허용하며, 2장 이상을 전달하면 동기적으로 HTTP 400을 반환합니다. 텍스트로 동영상을 생성하려면 이 필드를 생략하세요.이미지는 HTTP(S)로 공개 접근 가능해야 합니다. JPEG, PNG, WebP를 지원하며, 파일은 20 MB 미만이고 각 변은 10000픽셀 이하여야 합니다.

integer

기본값:"5"

출력 길이(초)는 1–15이며 기본값은 5입니다.

string

기본값:"540p"

출력 해상도는 360p, 540p, 720p, 1080p를 지원하며 기본값은 540p입니다.출력에는 상위 모델의 기본 픽셀 크기가 사용되며, 실제 반환된 크기를 기준으로 합니다. 테스트에서 확인된 대표 크기는 640×360, 1108×832입니다(너비 × 높이, 단위: 픽셀).quality 필드도 허용합니다. 두 필드를 모두 전달하면 resolution이 우선합니다.

string

해상도 호환 필드로, 허용 값은 resolution과 같습니다. resolution이 없을 때만 사용하며, 두 필드를 모두 생략하면 540p를 사용합니다.

string

기본값:"16:9"

텍스트로 동영상 생성 시에만 적용됩니다. 16:9, 9:16, 4:3, 3:4, 1:1, 2:3, 3:2, 21:9를 지원하며 기본값은 16:9입니다.이미지로 동영상을 생성할 때는 항상 입력 이미지의 화면비를 따르므로 이 필드는 적용되지 않습니다.

boolean

기본값:"false"

true를 전달하면 네이티브 오디오를 생성하며 기본값은 무음입니다. 오디오가 있는 동영상은 초당 단가가 더 높습니다.요청 본문의 최상위 audio만 인식합니다. metadata.generate_audio_switch는 오디오를 활성화하지 않으며 오디오 요금도 적용하지 않습니다.

integer

랜덤 시드로, 범위는 0–2147483647입니다.

이미지로 동영상 생성 예제

{
  "model": "pixverse-v6-max",
  "prompt": "Make the subject walk forward slowly",
  "image_urls": ["https://example.com/start.png"],
  "duration": 5,
  "resolution": "1080p"
}

예시 URL을 실제로 공개 접근 가능한 이미지 URL로 바꾸세요. 이미지 1장만 제공할 수 있으며 출력 화면비는 해당 이미지를 따릅니다.

작업 조회

다음 요청의 작업 ID를 제출 시 반환된 task_id로 바꾸세요.

curl --request GET \
  --url 'https://api.apimart.ai/v1/videos/generations/<task_id>' \
  --header 'Authorization: Bearer <token>'

요금

요금은 출력 초에 해당 해상도 및 오디오 설정의 초당 단가를 곱해 계산합니다. 오디오 유무에 따라 단가가 다르며, 오디오가 있으면 단가가 더 높습니다. resolution과 quality를 모두 생략하면 출력과 과금에 모두 540p를 사용합니다. 현재 단가는 모델 가격 조회 엔드포인트를 기준으로 합니다.

오디오 설정	가격 필드
무음	`resolution_paid_prices`의 해당 해상도 가격
오디오 포함	`billing_tier_paid_prices`의 해당 `<resolution>-audio` 등급

지원하지 않는 기능 및 매개변수 오류

다음 요청은 동기적으로 HTTP 400을 반환하며 작업을 생성하거나 요금을 부과하지 않습니다.

요청	오류 메시지
`extend_from_task_id` 전달	`pixverse-v6-max does not support video extend …; use pixverse-v6 instead`
`img_references` 전달	`pixverse-v6-max does not support multi-image reference …`
`first_frame_image` 또는 `last_frame_image` 전달	`pixverse-v6-max does not support first/last frame transition …`
`image_urls`에 이미지 2장 이상 전달	`pixverse-v6-max image-to-video takes exactly 1 image in image_urls (got N)`
`resolution`이 위의 4개 등급에 해당하지 않음	`invalid resolution …`
`duration`이 15초를 초과	`invalid duration …`
텍스트로 동영상 생성 시 `aspect_ratio`가 위의 8개 화면비에 해당하지 않음	`invalid aspect_ratio …`

개요

모델

텍스트 시리즈

이미지 시리즈

비디오 시리즈

오디오 시리즈

모더레이션 시리즈

업로드 관리

작업 관리

계정 관리

PixVerse V6 Max 동영상 생성

모델 기능

요청 헤더

요청 매개변수

이미지로 동영상 생성 예제

작업 조회

요금

지원하지 않는 기능 및 매개변수 오류

​모델 기능

​요청 헤더

​요청 매개변수

​이미지로 동영상 생성 예제

​작업 조회

​요금

​지원하지 않는 기능 및 매개변수 오류

모델 기능

요청 헤더

요청 매개변수

이미지로 동영상 생성 예제

작업 조회

요금

지원하지 않는 기능 및 매개변수 오류