# 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/task/listByScheduleId.get.description
Returns AI image or video generation tasks for one schedule. Poll this endpoint until the requested tasks reach a terminal status and expose their generated asset URLs.

# paths./v1/ai/task/listByScheduleId.get.parameters[].description
Schedule ID returned by the schedule creation endpoint.

# paths./v1/ai/task/listByScheduleId.get.responses.200.content.application/json.example.data.list[].params.prompt
A clean 10-second product reveal video with a slow camera push-in

# paths./v1/ai/task/listByScheduleId.get.responses.403.description
The API key does not have permission for this operation.

# paths./v1/ai/task/listByScheduleId.get.responses.429.description
Too many requests. Retry with exponential backoff.

# paths./v1/ai/task/listByScheduleId.get.responses.429.headers.Retry-After.description
Seconds to wait before retrying, when provided.

# paths./v1/ai/task/listByScheduleId.get.responses.500.description
Unexpected server error. Retry transient failures with exponential backoff.

# paths./v1/ai/task/listByScheduleId.get.x-ui.title
查询 AI 生成任务结果

# paths./v1/ai/task/listByScheduleId.get.x-ui.summary
使用创建接口返回的 scheduleId 查询本次图片或视频生成任务。建议每 5 秒轮询，直到任务完成或明确失败。

# paths./v1/ai/task/listByScheduleId.get.x-ui.summaryEn
List image or video generation tasks using the scheduleId returned at creation. Poll about every five seconds until tasks complete or explicitly fail.

# paths./v1/ai/task/listByScheduleId.get.x-ui.parameters[].descriptionEn
scheduleId returned when the generation schedule was created

# paths./v1/ai/task/listByScheduleId.get.x-ui.responseExample.data.list[].params.prompt
A clean 10-second product reveal video with a slow camera push-in

# paths./v1/ai/task/listByScheduleId.get.x-ui.notes[]
失败、取消或过期后再决定是否重试；网络错误或轮询进程退出不表示生成任务失败。

# paths./v1/ai/task/listByScheduleId.get.x-ui.notes[]
视频优先读取 customResult.videoUrl 或 result.url；图片通常读取 result.url 或 resultUrl。

# paths./v1/ai/task/listByScheduleId.get.x-ui.notesEn[]
Waiting states include WAITING_SUBMIT, SUBMITTING, PENDING, and PROCESSING. COMPLETED is successful.

# paths./v1/ai/task/listByScheduleId.get.x-ui.notesEn[]
Retry only after an explicit failure, cancellation, or expiration. A network or polling-process error does not mean generation failed.

# paths./v1/ai/task/listByScheduleId.get.x-ui.notesEn[]
For videos, prefer customResult.videoUrl or result.url. Images usually use result.url or resultUrl.

# 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.