# Pixverse V6 API Pixverse V6 동영상 생성 모델의 전체 API 레퍼런스입니다. 모든 변형은 통합 동영상 작업 엔드포인트를 사용합니다. ## 모델 변형 | 모델 | ID | 설명 | | ----- | --- | ----------- | | **Pixverse V6 Text to Video** | `pixverse-v6-text-to-video` | 텍스트 프롬프트에서 동영상 생성 | | **Pixverse V6 Image to Video** | `pixverse-v6-image-to-video` | 단일 첫 프레임 이미지에서 애니메이션 생성 | | **Pixverse V6 Transition** | `pixverse-v6-transition` | 첫 프레임과 마지막 프레임 이미지 사이의 전환 생성 | | **Pixverse V6 Extend** | `pixverse-v6-extend` | `prompt`의 안내에 따라 새 프레임으로 기존 동영상 확장 | ## 빠른 비교 | 기능 | Text to Video | Image to Video | Transition | Extend | | ------- | ------------- | -------------- | ---------- | ------ | | `prompt` | 필수 | 필수 | 필수 | 필수 | | `aspect_ratio` | 선택 사항(기본값 `16:9`); 지원 비율은 아래 참조 | 사용 안 함(입력 이미지 따름) | 사용 안 함(입력 이미지 따름) | 사용 안 함(입력 동영상 따름) | | `image_url` | — | 필수 | 필수(첫 프레임) | — | | `image_end_url` | — | — | 필수(마지막 프레임) | — | | `video_url` | — | — | — | 필수(소스 동영상) | | `negative_prompt` | — | — | 선택 사항 | 선택 사항 | | `seed` | — | — | 선택 사항(`0`은 제품 기본값으로 처리) | 선택 사항 | | 길이 | 1–15초 | 1–15초 | 1–15초 | 1–15초 | | 해상도 | `360p`, `540p`, `720p`, `1080p` | 동일 | 동일 | 동일 | | 오디오 | `sound`로 선택 가능 | `sound`로 선택 가능 | `sound`로 선택 가능 | `sound`로 선택 가능 | Text-to-video 모델은 다음 화면 비율을 지원합니다: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`. ## Pixverse V6 Text to Video ### 엔드포인트 ``` POST /api/v1/video/task ``` ### 요청 파라미터 #### 필수 | 파라미터 | 타입 | 설명 | | --------- | ---- | ----------- | | `model_name` | string | 반드시 `"pixverse-v6-text-to-video"` 이어야 합니다 | | `prompt` | string | 동영상 생성 프롬프트 | | `duration` | integer | 동영상 길이(초) (`1`–`15`) | | `resolution` | string | `360p`, `540p`, `720p`, `1080p` 중 하나 | #### 선택 사항 | 파라미터 | 타입 | 설명 | | --------- | ---- | ----------- | | `aspect_ratio` | string | 기본값 `16:9`. `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` 중 하나 | | `sound` | boolean | 동영상용 오디오를 생성할지 여부 | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-text-to-video', prompt: 'A cinematic street scene at night with neon reflections', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Image to Video ### 요청 파라미터 #### 필수 | 파라미터 | 타입 | 설명 | | --------- | ---- | ----------- | | `model_name` | string | 반드시 `"pixverse-v6-image-to-video"` 이어야 합니다 | | `prompt` | string | 동영상 생성 프롬프트 | | `duration` | integer | 동영상 길이(초) (`1`–`15`) | | `resolution` | string | `360p`, `540p`, `720p`, `1080p` 중 하나 | | `image_url` | string | 첫 프레임 이미지의 URL | #### 선택 사항 | 파라미터 | 타입 | 설명 | | --------- | ---- | ----------- | | `sound` | boolean | 동영상용 오디오를 생성할지 여부 | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-image-to-video', prompt: 'Fluid camera pan; maintain subject identity', duration: 6, resolution: '720p', image_url: 'https://example.com/first-frame.jpg', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Transition **첫** 키프레임 이미지와 **마지막** 키프레임 이미지 사이의 움직임을 생성합니다. 선택적인 negative prompting과 seed를 지원합니다. ### 요청 파라미터 #### 필수 | 파라미터 | 타입 | 설명 | | --------- | ---- | ----------- | | `model_name` | string | 반드시 `"pixverse-v6-transition"` 이어야 합니다 | | `prompt` | string | 두 프레임 사이의 움직임을 설명합니다 | | `duration` | integer | 동영상 길이(초) (`1`–`15`) | | `resolution` | string | `360p`, `540p`, `720p`, `1080p` 중 하나 | | `image_url` | string | 첫 프레임 이미지의 URL | | `image_end_url` | string | 마지막 프레임 이미지의 URL | #### 선택 사항 | 파라미터 | 타입 | 설명 | | --------- | ---- | ----------- | | `sound` | boolean | 동영상용 오디오를 생성할지 여부 | | `negative_prompt` | string | 출력에서 줄이고 싶은 콘텐츠 | | `seed` | integer | 무작위성 시드; `0`은 플랫폼 기본 무작위 동작을 따릅니다 | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-transition', prompt: 'Seamless blend with natural lighting continuity', duration: 6, resolution: '720p', image_url: 'https://example.com/start.jpg', image_end_url: 'https://example.com/end.jpg', sound: true, negative_prompt: 'blur, watermark, text overlay', seed: 0, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Extend 기존 클립을 이어서 생성합니다. 소스 동영상 URL과 이야기가 어떻게 진행되어야 하는지 설명하는 프롬프트를 제공하세요. ### 요청 파라미터 #### 필수 | 파라미터 | 타입 | 설명 | | --------- | ---- | ----------- | | `model_name` | string | 반드시 `"pixverse-v6-extend"` 이어야 합니다 | | `prompt` | string | 동영상이 어떻게 이어져야 하는지 설명합니다 | | `duration` | integer | 동영상 길이(초) (`1`–`15`) | | `resolution` | string | `360p`, `540p`, `720p`, `1080p` 중 하나 | | `video_url` | string | 확장할 소스 동영상의 URL | #### 선택 사항 | 파라미터 | 타입 | 설명 | | --------- | ---- | ----------- | | `sound` | boolean | 동영상용 오디오를 생성할지 여부 | | `negative_prompt` | string | 출력에서 줄이고 싶은 콘텐츠 | | `seed` | integer | 무작위성 시드; `0`은 플랫폼 기본 무작위 동작을 따릅니다 | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-extend', prompt: 'Continue the walk into the forest clearing', duration: 5, resolution: '720p', video_url: 'https://example.com/source-clip.mp4', sound: false, negative_prompt: 'low quality, jitter', seed: 0, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## 응답 형식 ### 초기 응답 ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### 폴링 응답 상태를 확인하려면 `GET /api/v1/video/{taskId}` 를 폴링하세요: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### 상태 값 - `submitted`: 작업이 접수되어 처리 대기 중입니다 - `processing`: 동영상 생성이 진행 중입니다 - `succeed`: 동영상 생성이 완료되었습니다 - `failed`: 동영상 생성에 실패했습니다 ## 모범 사례 1. **Extend**: 모델이 아티팩트 없이 움직임을 이어갈 수 있도록 깨끗하고 안정적인 소스 동영상을 사용하세요. 2. **Transition**: 반복 가능한 전환 테스트가 필요할 때 `negative_prompt`와 `seed`를 함께 사용하세요. 3. **해상도**: `resolution`을 제공 대상에 맞추세요. 더 높은 해상도는 처리 시간이 더 오래 걸립니다. 4. **폴링**: `task_status`가 `succeed` 또는 `failed`가 될 때까지 5–10초마다 폴링하세요.