API reference · Douyin

douyin/xingtu-v3/data-sp-author-spread-info

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/api/douyin/xingtu-v3/data-sp-author-spread-info
Model IDdouyin/xingtu-v3/data-sp-author-spread-info
01

Input Schema

6 parameters · 1 required · 5 optional

ParameterTypeRequiredDescription
oAuthorIdstringRequiredAuthor's unique ID.
typestringOptionalVideo type. · Options: PERSONAL_VIDEO, XINTU_VIDEO · Default: "PERSONAL_VIDEO"
PERSONAL_VIDEOXINTU_VIDEO
rangestringOptionalTime range. · Options: DAY_30, DAY_90 · Default: "DAY_30"
DAY_30DAY_90
flowTypestringOptionalFlow type filter. · Options: EXCLUDE, INCLUDE · Default: "EXCLUDE"
EXCLUDEINCLUDE
platformstringOptionalPlatform type. · Options: SHORT_VIDEO, LIVE_STREAMING, PICTURE_TEXT, SHORT_DRAMA · Default: "SHORT_VIDEO"
SHORT_VIDEOLIVE_STREAMINGPICTURE_TEXTSHORT_DRAMA
onlyAssignbooleanOptionalWhether to only include assigned videos. · Default: false
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/api/douyin/xingtu-v3/data-sp-author-spread-info", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "type": "PERSONAL_VIDEO",
    "range": "DAY_30",
    "flowType": "EXCLUDE",
    "platform": "SHORT_VIDEO",
    "oAuthorId": "6870161898013196295",
    "onlyAssign": false
  }),
});

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