# info.summary
TikTok commerce-content publishing, creator analysis data, AI media generation, AI model APIs, viral-video replication, and public content data APIs.

# info.description
Use the LINGTU AI OpenAPI to query authorized creators and TikTok Shop products, upload media, create TikTok Shop video or photo publishing tasks, generate AI images and videos, fetch TikTok and Instagram creator post data, relay supported AI models, stream viral-video replication prompts, and fetch public content metrics.  A JSON request succeeds only when the HTTP status is successful and the response body has `code: 0`. Streaming replication requests and chat completions with `stream: true` return `text/event-stream` on success.

# tags[].description
Create and query scheduled AI image and video generation tasks.

# paths./v1/ai/schedule/create.post.description
Creates one or more AI image or video generation tasks. Use the returned scheduleId to query task status and generated assets. Keep polling the same schedule until every requested output succeeds or explicitly fails.

# paths./v1/ai/schedule/create.post.requestBody.content.application/json.examples.image.value.params.prompt
A clean product hero image on a bright studio background

# paths./v1/ai/schedule/create.post.requestBody.content.application/json.examples.video.value.params.prompt
A clean 10-second product reveal video with a slow camera push-in

# paths./v1/ai/schedule/create.post.responses.200.links.generationTasks.description
Poll the tasks created for this schedule.

# paths./v1/ai/schedule/create.post.responses.403.description
The API key does not have permission for this operation.

# paths./v1/ai/schedule/create.post.responses.429.description
Too many requests. Retry with exponential backoff.

# paths./v1/ai/schedule/create.post.responses.429.headers.Retry-After.description
Seconds to wait before retrying, when provided.

# paths./v1/ai/schedule/create.post.responses.500.description
Unexpected server error. Retry transient failures with exponential backoff.

# paths./v1/ai/schedule/create.post.x-ui.title
创建 AI 图片或视频生成任务

# paths./v1/ai/schedule/create.post.x-ui.summary
创建 AI 图片或视频生成计划，支持提示词、参考图、模型、尺寸和批量数量。使用响应中的 scheduleId 查询任务状态与生成结果。

# paths./v1/ai/schedule/create.post.x-ui.summaryEn
Create scheduled AI image or video generation tasks with prompts, references, model options, dimensions, and output count. Use the returned scheduleId to query status and assets.

# paths./v1/ai/schedule/create.post.x-ui.parameters[].description
调用方生成的任务标识；建议使用 8 位小写字母或数字

# paths./v1/ai/schedule/create.post.x-ui.parameters[].descriptionEn
Caller-generated task identifier; an 8-character lowercase alphanumeric value is recommended

# paths./v1/ai/schedule/create.post.x-ui.parameters[].type
gpt-image-2 | nano-banana-2 | nano-banana-2-2k | nano-banana-2-4k | seedream5.0-lite | gemini-omni-video | veo3.1-lite-extend | veo3.1-extend | grok-imagine-1.5 | seedance2.0-mini | seedance2.0 | seedance2.0-fast

# paths./v1/ai/schedule/create.post.x-ui.parameters[].description
根据 type 选择下方列出的图片或视频模型

# paths./v1/ai/schedule/create.post.x-ui.parameters[].descriptionEn
Select one of the image or video models listed below, matching type

# paths./v1/ai/schedule/create.post.x-ui.parameters[].descriptionEn
Required for images, for example 1:1 or 9:16

# paths./v1/ai/schedule/create.post.x-ui.parameters[].description
视频生成时长；可选值取决于模型

# paths./v1/ai/schedule/create.post.x-ui.parameters[].descriptionEn
Video duration; allowed values depend on the model

# paths./v1/ai/schedule/create.post.x-ui.parameters[].description
单张远程参考图 URL，主要用于视频生成

# paths./v1/ai/schedule/create.post.x-ui.parameters[].descriptionEn
One remote reference image URL, primarily for video generation

# paths./v1/ai/schedule/create.post.x-ui.parameters[].description
按顺序传入的远程参考图 URL；不支持 data URL

# paths./v1/ai/schedule/create.post.x-ui.parameters[].descriptionEn
Ordered remote reference image URLs; data URLs are not supported

# paths./v1/ai/schedule/create.post.x-ui.parameters[].description
视频是否添加水印，默认 false

# paths./v1/ai/schedule/create.post.x-ui.parameters[].descriptionEn
Whether to add a video watermark; defaults to false

# paths./v1/ai/schedule/create.post.x-ui.parameters[].description
生成数量，未指定多结果时建议传 1

# paths./v1/ai/schedule/create.post.x-ui.parameters[].descriptionEn
Number of outputs; use 1 unless multiple results are needed

# paths./v1/ai/schedule/create.post.x-ui.parameters[].description
需要关联的业务对象 ID

# paths./v1/ai/schedule/create.post.x-ui.parameters[].description
ISO 8601 执行时间；省略时立即创建

# paths./v1/ai/schedule/create.post.x-ui.parameters[].descriptionEn
ISO 8601 execution time; omit to create immediately

# paths./v1/ai/schedule/create.post.x-ui.parameters[].descriptionEn
Display name for the generation schedule

# paths./v1/ai/schedule/create.post.x-ui.requestExamples.image.params.prompt
A clean product hero image on a bright studio background

# paths./v1/ai/schedule/create.post.x-ui.requestExamples.video.params.prompt
A clean 10-second product reveal video with a slow camera push-in

# paths./v1/ai/schedule/create.post.x-ui.notes[]
参考图必须是可访问的 http/https URL；本地文件需先上传后再传入 URL。

# paths./v1/ai/schedule/create.post.x-ui.notes[]
scheduleId 与 taskId 不同。创建成功后请使用 scheduleId 查询本计划的任务列表，不要因轮询中断而重复创建。

# paths./v1/ai/schedule/create.post.x-ui.notesEn[]
Video durations: gemini-omni-video supports 6/8/10s; veo3.1-lite-extend and veo3.1-extend are fixed at 8s; grok-imagine-1.5 supports 6/10/15/20/25/30s; seedance2.0-mini, seedance2.0, and seedance2.0-fast support 4/8/10/12/15s.

# paths./v1/ai/schedule/create.post.x-ui.notesEn[]
For images, use IMAGE_GENERATION with params.aspectRatio. For videos, use VIDEO_GENERATION with params.seconds and params.size.

# paths./v1/ai/schedule/create.post.x-ui.notesEn[]
References must be accessible http/https URLs. Upload local files before passing their URLs.

# paths./v1/ai/schedule/create.post.x-ui.notesEn[]
scheduleId and taskId are different. Query the same scheduleId after creation and do not recreate a task only because polling was interrupted.

# components.securitySchemes.ApiKeyAuth.description
LINGTU AI API key. Keep it on the server and never expose it in client-side code or logs.

# components.schemas.ErrorResponse.properties.code.description
Non-zero business or HTTP-aligned error code.

# components.schemas.AiVideoGenerationParams.properties.seconds.description
Allowed durations depend on the selected model.