파이프라인으로 돌아가기

영상 자르기

결정론적 전사본 기반 비디오 트리밍: SRT를 명시적인 [시작, 끝] 구간으로 잘라내고 원본을 이에 맞춰 ffmpeg로 컷합니다. 컷을 문장 경계에 스냅하고 클립에 맞게 재기준화된 구간 전사본을 다운스트림 자막 작업용으로 반환합니다. LLM 없음, 편집상의 선택은 업스트림(일반적으로 highlights 파이프라인)에 속합니다.

0.1

입력이 필요합니다: 비디오, 전사본 (SRT), 시작 (초), 종료 (초)

가장 적합한 용도

  • 이미 업스트림에서 선택된 명시적 구간으로 긴 영상 컷
  • highlights 이후 연결: highlights가 순간을 고르고 video-trim이 잘라냅니다
  • 문장 경계에 스냅된 클립과 재기준화된 구간 SRT를 한 번의 호출로 생성

사용 시점

  • 항상 transcription + highlights 이후(또는 이미 구간을 아는 모든 호출자)
  • captions 이전, 출력의 재기준화된 구간 SRT가 captions 단계에 바로 입력됩니다

  • highlights(count=N, style=...)와 함께 사용하여 권위 있는 편집상의 선택을 얻으세요
  • 컷은 SRT 세그먼트 경계에 스냅됩니다, 약간 좁은 구간을 전달하고 스냅이 이를 완전한 문장으로 넓히도록 두세요
  • 출력 전사본 URL은 이미 t=0으로 재기준화되어 있습니다. captions에 바로 입력하세요

이 파이프라인을 사용하는 레시피

이 파이프라인 관련 기사

영상 자르기 API

직접 작성한 코드에서 이 파이프라인을 호출하세요. 요청 한 번으로 실행이 시작되며, 모델은 별도의 엔드포인트가 아니라 입력 필드입니다.

4 개 입력
4 필수
0.1 크레딧
bun add @pipe2-ai/sdk
import { createClient } from "@pipe2-ai/sdk";

const client = createClient(process.env.PIPE2_TOKEN!);

const { run_pipeline } = await client.RunPipeline({
  pipeline_slug: "video-trim",
  input: {
    video_url: "https://example.com/interview.mp4",
    transcript_url: "https://example.com/interview.vtt",
    start_sec: 12,
    end_sec: 48,
  },
});
pip install pipe2
import asyncio
import os

from pipe2 import Pipe2Client

client = Pipe2Client(token=os.environ["PIPE2_TOKEN"])

run = asyncio.run(client.run_pipeline(
    pipeline_slug="video-trim",
    input={
        "video_url": "https://example.com/interview.mp4",
        "transcript_url": "https://example.com/interview.vtt",
        "start_sec": 12,
        "end_sec": 48,
    },
))
go get github.com/pipe2-ai/sdk-go
client := pipe2.NewClient(os.Getenv("PIPE2_TOKEN"))

input := json.RawMessage(`{
  "video_url": "https://example.com/interview.mp4",
  "transcript_url": "https://example.com/interview.vtt",
  "start_sec": 12,
  "end_sec": 48
}`)

run, err := pipe2.RunPipeline(context.Background(), client, "video-trim", input)
if err != nil {
    log.Fatal(err)
}
brew install pipe2-ai/tap/pipe2
pipe2 pipelines run \
  --pipeline video-trim \
  --input-json '{"video_url": "https://example.com/interview.mp4", "transcript_url": "https://example.com/interview.vtt", "start_sec": 12, "end_sec": 48}' \
  --wait

API 토큰 발급 →

매개변수

end_sec 필수

구간 종료 지점(제외)입니다. start_sec보다 커야 합니다.

number
start_sec 필수

구간 시작 지점입니다. 보통 상위 선택기(예: highlights)가 제공합니다.

number
transcript_url 필수

원본의 SRT 전사본입니다, 필수. 구간이 세그먼트 경계에 맞춰 정렬되고, 이후 자막 작업을 위해 잘린 SRT가 반환됩니다.

string
video_url 필수

잘라낼 원본 비디오입니다.

string

AI 에이전트에서 사용하기

MCP 클라이언트를 pipe2에 연결하면 에이전트가 이 도구들을 사용할 수 있습니다. 이 파이프라인을 찾아 위와 동일한 스키마를 읽고 실행합니다.

  • list_pipelines
  • get_pipeline_schema
  • run_pipeline
  • get_pipeline_run_status
  • request_upload
https://mcp.pipe2.ai/mcp
{
  "mcpServers": {
    "pipe2ai": {
      "url": "https://mcp.pipe2.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

전체 API 레퍼런스 MCP 설정 CLI 레퍼런스

비디오 트리밍: 결정론적 전사본 기반 컷

원본 비디오, 해당 SRT 전사본, 그리고 명시적인 [start_sec, end_sec] 구간을 전달하세요. 파이프라인이 구간을 실제 세그먼트 경계에 스냅하여 컷이 문장 중간에 떨어지지 않도록 하고, ffmpeg로 원본을 트리밍한 뒤, t=0으로 재기준화된 구간 전사본을 반환합니다, 재전사 없이 captions 단계에서 바로 사용할 수 있습니다.

작동 방식

  1. 세그먼트에 스냅: 시작/끝이 가장 가까운 SRT 세그먼트 경계로 맞춰집니다
  2. SRT 잘라내기: 유지된 세그먼트가 t=0으로 재기준화되어 구간 전사본으로 업로드됩니다
  3. FFmpeg 트리밍: 원본이 스냅된 구간으로 깔끔한 프레임 단위 경계로 컷됩니다

여기에 LLM이 없는 이유

  • 편집상의 결정(어떤 순간이 클립할 가치가 있는지)은 업스트림에 속합니다, 일반적으로 highlights 파이프라인입니다
  • highlights 이후에 LLM을 다시 호출하면 선택된 구간과 렌더링된 구간 사이에 드리프트만 추가됩니다
  • 단일 호출 과금: 트리밍당 0.1크레딧 정액, 토큰별 정산 불필요

자주 묻는 질문

구간은 어떻게 선택되나요?
사용자가 제공합니다. highlights 파이프라인(또는 다른 업스트림 피커)이 start_sec와 end_sec를 내보내고, 이 트리밍이 이를 결정론적으로 소비합니다. 트리밍 자체에는 LLM이 없습니다, 편집상의 결정은 피커에 있습니다.
왜 전사본이 필요한가요?
전사본이 컷을 단어 중간이 아니라 완전한 문장에 스냅되게 만드는 요소입니다. 파이프라인은 구간과 겹치는 모든 세그먼트를 유지하고, 유지된 집합의 범위를 취한 뒤, 영상을 이에 맞춰 트리밍합니다, 그런 다음 동일한 SRT가 잘리고 t=0으로 재기준화되어 captions 단계가 재사용하도록 반환됩니다.
전사본 없이 실행할 수 있나요?
이제는 아닙니다. 이전의 키프레임 비전 폴백은 highlights가 편집상의 선택을 담당하면서 제거되었습니다, 선택된 구간에서 지속적으로 드리프트했기 때문입니다. 먼저 원본을 전사하세요(transcription 파이프라인은 원본 해시로 캐싱하므로 재실행은 무료입니다).
크레딧이 소모되나요?
트리밍당 0.1 크레딧 정액입니다.
start_sec/end_sec가 전사본 범위를 벗어나면 어떻게 되나요?
구간은 원본 영상이 아니라 전사본과 대조됩니다. 끝을 넘어가면 컷이 전사본의 마지막 문장까지 되돌려집니다.

더 많은 파이프라인 살펴보기

전체 보기 →
영상 생성
from 9.5
영상 생성
이미지 생성
0.2-6.4
이미지 생성
음성 생성
0.7-1.3
음성 생성
음악 생성
2.5-45.1
음악 생성