{"uid":"cap_3Bji4nvC87PFb4K8BkWLp","slug":"video-timecode-calc-smpte-timecode-arithmetic-15b72d90","name":"Video & Timecode Calc – SMPTE Timecode Arithmetic","description":"Add or subtract two SMPTE timecodes at a given frame rate, drop-frame aware, with the result in frames and seconds.","url":"https://video-calc.x402tookit.com/timecode-math?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["a","b"],"properties":{"a":{"type":"string","description":"First timecode, HH:MM:SS:FF (or ; before frames for drop-frame)"},"b":{"type":"string","description":"Second timecode"},"op":{"type":"string","description":"add (default) or subtract"},"fps":{"type":"string","description":"23.976, 24, 25, 29.97, 30, 48, 50, 59.94 or 60 (default 24)"},"dropFrame":{"type":"string","description":"true for drop-frame (29.97 and 59.94 only)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"fps":{"type":["null","string"]},"asOf":{"type":["null","string"]},"result":{"type":["null","string"]},"source":{"type":["null","string"]},"aFrames":{"type":["null","number"]},"bFrames":{"type":["null","number"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"dropFrame":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"realSeconds":{"type":["null","number"]},"resultFrames":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ralbRNa8SyPoMeK5vCNS_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Add or subtract two SMPTE timecodes at a given frame rate (drop-frame aware), returning the result as a timecode, frame count, and real seconds.","exampleAgentPrompt":"Add the SMPTE timecodes 01:02:30;15 and 00:45:10;20 at 29.97 drop-frame fps and tell me the result timecode, total frames, and real seconds.","exampleUseCases":[{"title":"Calculate edit end timecode","prompt":"My clip starts at 00:58:30:00 and the segment I'm inserting is 00:02:45:12 long — both at 25fps. What timecode does the clip end at, and how many total frames is that?"},{"title":"Subtract timecodes for duration check","prompt":"I need to subtract 01:15:22:10 from 02:30:45:20 at 23.976fps non-drop-frame. What's the difference in timecode, frames, and real seconds?"},{"title":"Drop-frame timecode addition for broadcast","prompt":"Can you add 00:30:00;00 and 00:29:59;29 together using 29.97 drop-frame? I need the result timecode, total frame count, and how many real seconds that is."}],"resultDescription":"Returns the arithmetic result as a SMPTE timecode string, the individual frame counts for each input, the result in total frames, real elapsed seconds, the fps used, and whether drop-frame was applied. May also include a summary, degraded flag, and disclaimer fields.","failureModes":["Invalid timecode format (not HH:MM:SS:FF or HH:MM:SS;FF) returns an error","Unsupported fps value outside allowed set (23.976, 24, 25, 29.97, 30, 48, 50, 59.94, 60) returns an error","Drop-frame requested for a non-drop-frame-compatible fps (only 29.97 and 59.94) returns an error","Missing required parameters a or b returns a validation error","Subtraction resulting in a negative timecode may return an error or zero-clamped result"],"whenToPreferThis":"Use this endpoint when you need precise SMPTE timecode addition or subtraction that is drop-frame aware — especially for broadcast (29.97 DF) or film (23.976, 24) workflows. Prefer it over manual frame counting because it handles the drop-frame discontinuity correctly and returns results in both frames and real seconds simultaneously. It is the right choice when your input is already in HH:MM:SS:FF timecode notation rather than raw frame counts (use the frame-count converter sibling for that).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:20:38.456Z","isFirstParty":false,"canonicalSlug":"video-timecode-calc-smpte-timecode-arithmetic-15b72d90"}