Managed gateway · LeanPool

MV template

A photo-to-video (MV) template.

GETapi.tikultra.com/v1/mv-templateStandard · 5 credits

Upstream/aweme/v1/mv/detail/Every plan

Parameters

Name	Type	Description
`template_id`required	string	The template ID. e.g. 7398112233445566778

Pricing

Plan	Per call	Per 1,000 calls
Starter	5 credits	$0.58
Growth	5 credits	$0.40
Scale	5 credits	$0.29

Response fields

Field	Type	Description
`status_code`	integer	Upstream TikTok mobile status code (0 indicates success).
`template_id`	string	Unique template identifier.
`name`	string	Decoded name value.
`min_photos`	integer	Decoded min photos value.
`max_photos`	integer	Decoded max photos value.
`duration_ms`	integer	Duration in milliseconds.
`usage_count`	integer	Total usage count.
`log_pb`	object	Upstream request trace envelope from the mobile gateway.
`log_pb.impr_id`	string	Upstream TikTok impression / trace identifier.

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

import os
from tikultra import TikUltra

with TikUltra(api_key=os.environ["TIKULTRA_KEY"]) as client:
    res = client.request("GET", "/v1/mv-template", params={
        "template_id": "7398112233445566778",
    })
    print(res.credits_cost, res.data)

{
  "status_code": 0,
  "template_id": "7398112233445566778",
  "name": "Clean Carousel Cut",
  "min_photos": 2,
  "max_photos": 12,
  "duration_ms": 12000,
  "usage_count": 74800,
  "log_pb": {
    "impr_id": "202611120200419F8E7D6C5B4A3210"
  }
}

Try it in the playground Full reference in the docs

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API key See pricing

Parameters

Pricing

Response fields

Responses

More in Series, sounds, hashtags & places

Ready to build?