Meter AI Video Operation

post

https://api.revenium.ai/meter/v2/ai/video

Submit video generation/editing metadata for metering and billing purposes.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

AI video operation metadata including duration, credits, and video-specific attributes

The AI video operation metadata

transactionId

string | null

traceId

string | null

model

string

provider

string

requestTime

string

responseTime

string

requestDuration

int64

operationType

string | null

enum

operationSubtype

string | null

totalCost

double | null

costType

string

enum

Allowed:

organizationName

string | null

subscriptionId

string | null

productName

string | null

agent

string | null

environment

string | null

region

string | null

parentTransactionId

string | null

transactionName

string | null

retryNumber

int32 | null

traceType

string | null

traceName

string | null

squadId

string | null

squadName

string | null

squadRole

string | null

agenticJobId

string | null

agenticJobName

string | null

agenticJobType

string | null

agenticJobVersion

string | null

errorReason

string | null

errorCode

int32 | null

subscriber

middlewareSource

string | null

modelSource

string | null

taskType

string | null

durationSeconds

double

fps

int32 | null

resolution

string | null

creditsConsumed

double | null

videoJobId

string | null

requestedDurationSeconds

double | null

creditRate

double | null

asyncOperation

boolean | null

completionStatus

string | null

enum

Allowed:

sourceTransactionId

string | null

inputMessages

string | null

outputResponse

string | null

promptsTruncated

boolean | null

billingUnit

string

enum

Allowed:

billingSkipped

boolean | null

skipReason

string | null

enum

Allowed:

pricingTier

string | null

enum

Allowed:

requestedServiceTier

string | null

actualServiceTier

string | null

priorityTier

string | null

costSource

string | null

Headers

Idempotency-Key

string

length between 1 and 255

Optional Stripe-style retry-safety key. If present, the response (status + body) is cached keyed by (tenant, key). Identical retries replay the cached response; body mismatch returns 409 idempotency_key_mismatch; a concurrent in-flight call returns 409 idempotency_key_in_progress with Retry-After: 1. Must be 1-255 printable ASCII characters; UUID v4 recommended. See https://docs.revenium.io/integrations/idempotency for full behavior.

Responses

201Video operation successfully metered

400Bad request. Either invalid_idempotency_key from the idempotency filter (canonical envelope), or a controller-level body parse / @Valid failure (legacy ApiError envelope). The two will converge to a single schema once the v2 error envelope unification lands.

401Unauthorized - Authentication required

403Forbidden. The API key scope is not allowed to post to metering endpoints. Use a key with METERING (rev_mk_), WRITE (rev_sk_), or legacy (hak_) scope.

404Resource not found

409Idempotency conflict. idempotency_key_mismatch when the same Idempotency-Key was reused with a different request body. idempotency_key_in_progress when a concurrent request with the same key is still in flight; in that case the response carries a Retry-After header.

413Request body exceeds the maximum size buffered by the idempotency filter.

422Validation failed - missing required video fields

429Budget limit exceeded — request rejected by enforcement rule

500Internal server error

503Idempotency cache backing store is temporarily unavailable. Retry later.