# extract-frames

**Repository Path**: vee7z/extract-frames

## Basic Information

- **Project Name**: extract-frames
- **Description**: 本项目是一个视频帧提取器，用于从视频中通过精度设置提取关键帧，并将其保存为图像文件。它基于Node.js和Express框架构建，使用了fluent-ffmpeg库进行视频处理。
- **Primary Language**: NodeJS
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-15
- **Last Updated**: 2025-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 视频帧提取器项目介绍

本项目是一个视频帧提取器，用于从视频中通过精度设置提取关键帧，并将其保存为图像文件。它基于Node.js和Express框架构建，使用了fluent-ffmpeg库进行视频处理。

## 接口请求

### 提取视频帧
- **请求方法**: POST
- **请求URL**: /api/extract-frames
- **请求参数**:
  - `url`: 视频的URL，字符串类型，必填。
  - `precision`: 提取精度，范围0-10，数字类型，选填，默认值为2，最小精度为30秒一帧，最大精度为1秒一帧。

### 请求示例
```json
{
  "url": "https://example.com/video.mp4",
  "precision": 2
}
```

## 接口响应

### 成功响应
- **状态码**: 200
- **响应体**: 包含提取的帧图像文件路径的数组。

### 响应示例
```json
{
  "status": "complated",
  "taskId": "eb1055be-593f-49b4-8160-61cd9185a6b7",
  "frameCount": 2,
  "frameUrls": [
    "http://api.com/frames/eb1055be-593f-49b4-8160-61cd9185a6b7/frame_001_1.jpg",
    "http://api.com/frames/eb1055be-593f-49b4-8160-61cd9185a6b7/frame_001_2.jpg",
  ]
}
```