# Pixverse C1 API Pixverse C1 동영상 생성 모델의 전체 API 레퍼런스입니다. 모든 변형은 통합 동영상 작업 엔드포인트를 사용합니다. ## 모델 변형 | 모델 | ID | 설명 | | ----- | --- | ----------- | | **Pixverse C1 Text to Video** | `pixverse-c1-text-to-video` | 텍스트 프롬프트에서 동영상 생성 | | **Pixverse C1 Image to Video** | `pixverse-c1-image-to-video` | 단일 첫 프레임 이미지에서 애니메이션 생성 | | **Pixverse C1 Transition** | `pixverse-c1-transition` | 첫 프레임과 마지막 프레임 이미지 사이의 전환 생성 | ## 빠른 비교 | 기능 | Text to Video | Image to Video | Transition | | ------- | ------------- | -------------- | ---------- | | `prompt` | 필수 | 필수 | 필수 | | `aspect_ratio` | 선택 사항(기본값 `16:9`); 지원 비율은 아래 참조 | 사용 안 함(입력 이미지 따름) | 사용 안 함(입력 이미지 따름) | | `image_url` | — | 필수 | 필수(첫 프레임) | | `image_end_url` | — | — | 필수(마지막 프레임) | | 길이 | 1–15초 | 1–15초 | 1–15초 | | 해상도 | `360p`, `540p`, `720p`, `1080p` | 동일 | 동일 | | 오디오 | `sound`로 선택 가능 | `sound`로 선택 가능 | `sound`로 선택 가능 | Text-to-video 모델은 다음 화면 비율을 지원합니다: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`. ## Pixverse C1 Text to Video ### 엔드포인트 ``` POST /api/v1/video/task ``` ### 요청 파라미터 #### 필수 | 파라미터 | 타입 | 설명 | | --------- | ---- | ----------- | | `model_name` | string | 반드시 `"pixverse-c1-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-c1-text-to-video', prompt: 'A drone shot over coastline at golden hour', duration: 5, resolution: '720p', aspect_ratio: '16:9', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse C1 Image to Video ### 요청 파라미터 #### 필수 | 파라미터 | 타입 | 설명 | | --------- | ---- | ----------- | | `model_name` | string | 반드시 `"pixverse-c1-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-c1-image-to-video', prompt: 'Slow zoom in; soft natural motion', duration: 5, resolution: '720p', image_url: 'https://example.com/first-frame.jpg', sound: false, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse C1 Transition **첫** 키프레임 이미지와 **마지막** 키프레임 이미지 사이의 움직임을 생성합니다. ### 요청 파라미터 #### 필수 | 파라미터 | 타입 | 설명 | | --------- | ---- | ----------- | | `model_name` | string | 반드시 `"pixverse-c1-transition"` 이어야 합니다 | | `prompt` | string | 두 프레임 사이의 움직임을 설명합니다 | | `duration` | integer | 동영상 길이(초) (`1`–`15`) | | `resolution` | string | `360p`, `540p`, `720p`, `1080p` 중 하나 | | `image_url` | string | 첫 프레임 이미지의 URL | | `image_end_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-c1-transition', prompt: 'Smooth cinematic morph between the two scenes', duration: 6, resolution: '720p', image_url: 'https://example.com/start.jpg', image_end_url: 'https://example.com/end.jpg', sound: true, }), }); 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. **해상도**: 품질과 생성 시간의 균형을 위해 `720p` 또는 `1080p`를 사용하고, 더 빠른 반복에는 `360p` 또는 `540p`를 사용하세요. 2. **전환**: 모델이 움직임을 안정적으로 보간할 수 있도록 선명하고 조명이 좋은 첫 프레임과 마지막 프레임을 사용하세요. 3. **오디오**: 동기화된 주변 오디오가 필요하면 `sound`를 설정하고, 무음 출력은 생략하거나 `false`로 설정하세요. 4. **폴링**: `task_status`가 `succeed` 또는 `failed`가 될 때까지 5–10초마다 폴링하세요.