# Seedance 1.5 Pro API

Seedance 1.5 Pro 비디오 생성 모델의 완전한 API 참조 문서.

## 모델 변형

이 API는 두 가지 모델 변형을 지원합니다:

| 모델 | ID | 설명 |
|-------|-----|-------------|
| **Seedance 1.5 Pro Text to Video** | `seedance-v1.5-pro-text-to-video` | 고품질 텍스트-비디오 생성 |
| **Seedance 1.5 Pro Image to Video** | `seedance-v1.5-pro-image-to-video` | 모션 컨트롤이 포함된 이미지 애니메이션 |

## 빠른 비교

| 기능 | Text to Video | Image to Video |
|---------|---------------|----------------|
| 입력 | 텍스트 프롬프트 | 이미지 + 텍스트 프롬프트 |
| 길이 범위 | 4-12 seconds | 4-12 seconds |
| 해상도 옵션 | 480p, 720p, 1080p | 480p, 720p, 1080p |
| 시작 프레임 | 미지원 | 필수 |
| 종료 프레임 | 미지원 | 미지원 |
| 오디오 지원 | 선택 사항 | 선택 사항 |
| 오디오 URL | 미지원 | 미지원 |

### 지원되는 화면 비율

`21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`

### 해상도 옵션

| 해상도 | 설명 |
|------------|-------------|
| `480p` | 표준 화질, 빠른 처리 속도 |
| `720p` | 고화질, 품질과 속도의 균형 |
| `1080p` | 풀 HD, 최고 품질 출력 |

## Seedance 1.5 Pro Text to Video

### 엔드포인트

```
POST /api/v1/video/task
```

### 요청 파라미터

#### 필수

| 파라미터 | 타입 | 설명 |
|-----------|------|-------------|
| `model_name` | string | `"seedance-v1.5-pro-text-to-video"` 이어야 합니다 |
| `prompt` | string | 비디오 생성 프롬프트 |
| `duration` | number | 비디오 길이(초 단위, 4-12) |
| `resolution` | string | 출력 해상도: `"480p"`, `"720p"`, 또는 `"1080p"` |
| `aspect_ratio` | string | 비디오 화면 비율: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, 또는 `"3:4"` |

#### 선택 사항

| 파라미터 | 타입 | 설명 |
|-----------|------|-------------|
| `sound` | boolean | 비디오에 대한 주변 음향 생성 |
| `camera_fixed` | boolean | 카메라 위치 고정, 카메라 움직임 비활성화 |
| `seed` | number | 재현 가능한 생성을 위한 랜덤 시드 |

### 요청 예시

```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: 'seedance-v1.5-pro-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '1080p',
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

**선택적 파라미터를 포함한 바디 전용 예시:**

```javascript
{
  model_name: 'seedance-v1.5-pro-text-to-video',
  prompt: 'A golden retriever running through a sunlit meadow',
  duration: 6,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  camera_fixed: false,
  seed: 42
}
```

## Seedance 1.5 Pro Image to Video

### 요청 파라미터

#### 필수

| 파라미터 | 타입 | 설명 |
|-----------|------|-------------|
| `model_name` | string | `"seedance-v1.5-pro-image-to-video"` 이어야 합니다 |
| `prompt` | string | 비디오 생성 프롬프트 |
| `duration` | number | 비디오 길이(초 단위, 4-12) |
| `resolution` | string | 출력 해상도: `"480p"`, `"720p"`, 또는 `"1080p"` |
| `aspect_ratio` | string | 비디오 화면 비율: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, 또는 `"3:4"` |
| `image_url` | string | 비디오의 첫 번째 프레임 |

#### 선택 사항

| 파라미터 | 타입 | 설명 |
|-----------|------|-------------|
| `sound` | boolean | 비디오에 대한 주변 음향 생성 |
| `camera_fixed` | boolean | 카메라 위치 고정, 카메라 움직임 비활성화 |
| `seed` | number | 재현 가능한 생성을 위한 랜덤 시드 |

### 요청 예시

```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: 'seedance-v1.5-pro-image-to-video',
    image_url: 'https://example.com/image.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '1080p',
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

**바디 전용 예시:**

```javascript
{
  model_name: 'seedance-v1.5-pro-image-to-video',
  image_url: 'https://example.com/image.jpg',
  prompt: 'Camera slowly pulls back to reveal the full landscape',
  duration: 6,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true
}
```

## 응답 형식

### 초기 응답

두 모델 모두 폴링을 위한 `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`: 비디오 생성 실패

## 처리 시간

일반적인 처리 시간: 길이와 해상도에 따라 2-5분.

1080p의 긴 비디오는 최대 8분이 소요될 수 있습니다. 상태 확인을 위해 5-10초마다 폴링하세요.

## 모범 사례

1. **모션을 명확하게 설명하기**: 더 예측 가능한 결과를 위해 프롬프트에 구체적인 움직임 설명 포함
2. **해상도 선택**: 빠른 반복 작업에는 `480p` 또는 `720p` 사용, 최종 출력에는 `1080p` 사용
3. **카메라 컨트롤**: 카메라 흔들림 없이 피사체에 집중하고 싶을 때 `camera_fixed: true` 설정
4. **화면 비율**: 대상 플랫폼에 맞게 화면 비율 선택 (예: 모바일은 `9:16`, 데스크톱은 `16:9`)
5. **재현성**: 특정 생성을 재현하거나 반복하려면 `seed` 파라미터 사용
6. **이미지 품질**: 이미지-비디오 변환 시 최상의 결과를 위해 고해상도의 밝은 입력 이미지 사용