API reference · TikTok

tiktok/app-v3/live-daily-rank

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

APISynchronousOpen model
Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run
Model IDtiktok/app-v3/live-daily-rank
01

Input Schema

6 parameters · 0 required · 6 optional

ParameterTypeRequiredDescription
cookiestringOptionalUser's own cookie, optional parameter, used when the interface is not available.
room_idstringOptionalLive room id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different room ids of different live rooms.
anchor_idstringOptionalAnchor id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different anchor ids of different live rooms.
rank_typeintegerOptionalRank type, parameter values are as follows:
region_typeintegerOptionalRegion type, use the default value, the specific meaning is unknown.
gap_intervalintegerOptionalTime interval, use the default value to represent the current day, use -1 to represent the ranking record.
02

Output Schema

FieldTypeDescription
idstringUnique identifier for the generation task
statusstringTask status: pending, running, completed, failed, timeout
modelstringModel used for the generation
outputsarrayArray of output items
outputs[].urlstringURL of the generated artifact
outputs[].content_typestringMIME type (e.g. image/png, video/mp4)
errorobject | nullError details if failed, null on success
error.typestringMachine-readable error type code
error.messagestringHuman-readable error description
03

Code Examples

Ready-to-run snippets

const apiKey = process.env.SANDBASE_API_KEY;
const response = await fetch("https://api.sandbase.ai/v1/run", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "tiktok/app-v3/live-daily-rank"
  }),
});

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());