Video Stitch API

Keyword target: video stitch API

The stitch endpoint combines two to eight completed video projects into one video without a new generation charge. Every source must belong to the API-key account, be ready, and use the same aspect ratio. Canvas-style generation through the API is therefore generate-media for clips plus stitch for assembly.

1. Create or identify two to eight video jobs under the same account.
2. Poll each job until ready and confirm the clips share an aspect ratio.
3. Send the ordered projectIds to POST /api/v1/stitch, then poll the returned status URL.

Working example

Set REVIRAL_API_KEY only in your server environment, then run this request with values valid for your account.

curl -X POST "https://reviral.ai/api/v1/stitch" \
  -H "Authorization: Bearer $REVIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"projectIds":["550e8400-e29b-41d4-a716-446655440001","550e8400-e29b-41d4-a716-446655440002"]}'

{
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440003",
    "kind": "stitch",
    "creditsCharged": 0,
    "status": "queued",
    "statusUrl": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440003"
  }
}

Frequently asked questions

How many videos can the stitch API combine?

A request combines two to eight distinct ready video project IDs in the order supplied.

Does stitching charge generation credits?

No. Stitching uses the same zero-credit assembly path as the app; creating the source clips may charge separately.

Can I stitch another account's video?

No. Every source project is checked against the account that owns the API key.

Stitch owned video jobs

Combines two to eight ready, same-aspect video jobs owned by the API-key account. Stitching is free.

Authentication: Bearer API key required

curl -X POST "https://reviral.ai/api/v1/stitch" \
  -H "Authorization: Bearer $REVIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"projectIds":["550e8400-e29b-41d4-a716-446655440001","550e8400-e29b-41d4-a716-446655440002"]}'