NCA Toolkit - 强大的媒体处理 API 工具包

核心功能

一个工具包替代多个付费服务，全方位满足您的媒体处理需求

视频处理

字幕生成、合并、裁剪、分割、缩略图提取等全方位视频处理功能

音频转录

使用 OpenAI Whisper 进行高质量转录、翻译和格式转换

云存储集成

支持 GCP、S3、Cloudflare R2、Digital Ocean Spaces 等多种云存储

FFmpeg 编排

灵活的 FFmpeg 接口，实现复杂的自定义媒体处理操作

图片处理

图片转视频、网页截图、格式转换等图片处理功能

高性能处理

队列系统、Webhook 回调、异步处理，轻松应对大规模任务

快速开始

三步即可部署您的媒体处理 API

1

选择部署方式

Zeabur (推荐)

Docker

GCP Cloud Run

Digital Ocean

2

配置环境变量

# API 认证（必需）
API_KEY=your_secure_api_key

# 云存储配置（二选一）
# 选项 1: Cloudflare R2
S3_ENDPOINT_URL=https://xxx.r2.cloudflarestorage.com
S3_ACCESS_KEY=your_access_key
S3_SECRET_KEY=your_secret_key
S3_BUCKET_NAME=your_bucket
S3_REGION=auto
R2_PUBLIC_DOMAIN=https://pub-xxx.r2.dev

# 选项 2: GCP Storage
GCP_SA_CREDENTIALS='{"your":"service_account_json"}'
GCP_BUCKET_NAME=your_bucket_name

3

启动并测试

# Docker 部署示例
docker run -d -p 8080:8080 \
  -e API_KEY=your_api_key \
  -e S3_ENDPOINT_URL=https://xxx.r2.cloudflarestorage.com \
  -e S3_ACCESS_KEY=your_key \
  -e S3_SECRET_KEY=your_secret \
  -e S3_BUCKET_NAME=your_bucket \
  -e S3_REGION=auto \
  xiangyugongzuoliu/nca-toolkit:latest

# 测试 API
curl -X GET "http://localhost:8080/v1/toolkit/test" \
  -H "x-api-key: your_api_key"

API 示例

简单易用的 RESTful API，开箱即用

音视频转录

使用 OpenAI Whisper 进行高质量转录

curl -X POST "https://your-api.com/v1/media/transcribe" \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/audio.mp3",
    "task": "transcribe",
    "language": "zh",
    "response_type": "direct"
  }'

视频字幕生成

为视频添加可自定义样式的字幕

curl -X POST "https://your-api.com/v1/video/caption" \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "subtitle_text": "你好，世界",
    "font_size": 24,
    "font_color": "white"
  }'

二进制文件上传

直接上传文件到云存储

curl -X POST "https://your-api.com/v1/s3/upload_binary" \
  -H "x-api-key: your_api_key" \
  -F "file=@image.jpg" \
  -F "public=true"

# 返回
{
  "file_url": "https://cdn.example.com/image.jpg",
  "storage_provider": "cloudflare_r2"
}

查看完整 API 文档

技术栈

基于成熟稳定的开源技术构建

Flask

Web 框架

FFmpeg

媒体处理

Whisper

语音识别

Docker

容器化

Python

编程语言

R2/S3

对象存储

Playwright

浏览器自动化

Gunicorn

WSGI 服务器