> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# PixVerse V6 Max 동영상 생성

> 텍스트 및 단일 이미지로 동영상을 생성합니다. 360p / 540p / 720p / 1080p, 1–15초 길이를 지원하며 네이티브 오디오를 선택할 수 있습니다.

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

```bash cURL theme={null}
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
  }'
```

```python Python theme={null}
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())
```

```javascript JavaScript theme={null}
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](/ko/api-reference/videos/pixverse-v6/generation.md)를 사용하세요.

## 요청 헤더

**Authorization** `string` *required*

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

## 요청 매개변수

**model** `string` *required*

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

**prompt** `string`

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

**image\_urls** `string[]`

입력 이미지 URL 목록입니다. 이미지로 동영상 생성 시 정확히 1장만 허용하며, 2장 이상을 전달하면 동기적으로 HTTP 400을 반환합니다. 텍스트로 동영상을 생성하려면 이 필드를 생략하세요.

이미지는 HTTP(S)로 공개 접근 가능해야 합니다. JPEG, PNG, WebP를 지원하며, 파일은 20 MB 미만이고 각 변은 10000픽셀 이하여야 합니다.

**duration** `integer` (default: 5)

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

**resolution** `string` (default: 540p)

출력 해상도는 `360p`, `540p`, `720p`, `1080p`를 지원하며 기본값은 `540p`입니다.

출력에는 상위 모델의 기본 픽셀 크기가 사용되며, 실제 반환된 크기를 기준으로 합니다. 테스트에서 확인된 대표 크기는 `640×360`, `1108×832`입니다(너비 × 높이, 단위: 픽셀).

`quality` 필드도 허용합니다. 두 필드를 모두 전달하면 `resolution`이 우선합니다.

**quality** `string`

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

**aspect\_ratio** `string` (default: 16:9)

텍스트로 동영상 생성 시에만 적용됩니다. `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `2:3`, `3:2`, `21:9`를 지원하며 기본값은 `16:9`입니다.

이미지로 동영상을 생성할 때는 항상 입력 이미지의 화면비를 따르므로 이 필드는 적용되지 않습니다.

**audio** `boolean` (default: false)

`true`를 전달하면 네이티브 오디오를 생성하며 기본값은 무음입니다. 오디오가 있는 동영상은 초당 단가가 더 높습니다.

요청 본문의 최상위 `audio`만 인식합니다. `metadata.generate_audio_switch`는 오디오를 활성화하지 않으며 오디오 요금도 적용하지 않습니다.

**seed** `integer`

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

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

```json theme={null}
{
  "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`로 바꾸세요.

```bash theme={null}
curl --request GET \
  --url 'https://api.apimart.ai/v1/videos/generations/<task_id>' \
  --header 'Authorization: Bearer <token>'
```

## 요금

요금은 출력 초에 해당 해상도 및 오디오 설정의 초당 단가를 곱해 계산합니다. 오디오 유무에 따라 단가가 다르며, 오디오가 있으면 단가가 더 높습니다.

`resolution`과 `quality`를 모두 생략하면 출력과 과금에 모두 `540p`를 사용합니다.

현재 단가는 [모델 가격 조회 엔드포인트](https://api.apimart.ai/api/pricing/model?model=pixverse-v6-max)를 기준으로 합니다.

| 오디오 설정 | 가격 필드 |
| - | - |
| 무음 | `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 …` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.