视频创作指南
AI 视频生成排错指南：排队、失败、声音与下载
按任务状态和公开错误码排查问题，覆盖参考素材异常、身份漂移、无声、下载失败与积分返还，并说明何时联系支持。
先看任务状态，不要只看转圈动画。尝试重新提交前，保留任务 ID、实际模型和设置。本文针对本站独立平台的视频工具及 API，不描述 Pika 官方托管服务的行为。
于 2026 年 11 月 9 日按本站当前任务处理核对。创作调整属于建议，不是已测得的效果保证。编写本文没有执行付费生成。
先判断：任务是否已经创建？
打开“我的创作”或工具页的“我的作品”。API 用户要同时检查 HTTP 状态和 JSON code：HTTP 200 但 code: -1 仍是业务错误。创建成功后，保存返回的本地 dbId 或 id，继续查询同一个任务。
| 状态 | 含义 | 第一步 |
|---|---|---|
| 没有任务 ID，且收到明确拒绝 | 请求没有返回创建成功 | 按错误说明修正后再尝试 |
| 网络超时后没有任务 ID | 是否创建尚不确定 | 先查“我的创作”，不要认定可安全重复 POST |
queued |
等待调度 | 保留任务；排队位置不等于承诺完成时间 |
pending、processing |
仍在进行中 | 合理间隔查询同一 ID |
success |
已产生结果 | 检查或下载；创作不满意与生成失败不同 |
failed、canceled |
已记录终态 | 查看公开错误码，再核对积分记录 |
关闭页面或停止 API 轮询不会取消任务。客户端十分钟等待窗口结束，也不代表服务端失败。需要确认取消或删除时，请查看已登录账户中的可用操作；API Key 不能替代所有账户操作的登录状态。
在生成前被拒绝
| 错误或症状 | 检查什么 | 下一步 |
|---|---|---|
Unauthorized 或 HTTP 401 |
密钥所属账号、状态和 Bearer 格式 |
创建或复制正确的密钥，不要把密钥发给支持 |
| 跨域请求被拒绝 | 该接口是否支持浏览器 CORS 和令牌鉴权 | 将集成放在后端，跨域浏览器 Cookie 不能完成此处鉴权 |
Unsupported model |
当前项目目录中的模型 slug |
刷新目录，不要把营销名称当作模型 ID |
| 时长、分辨率或画幅不受支持 | 所选模型当前的 params |
选择兼容值后重新询价 |
Automatic duration is not supported |
是否把时长设为 -1 |
改为支持的正整数时长 |
Insufficient credits |
所需积分和账户可用余额 | 检查有效期及可用积分，选择较低成本设置或补充积分 |
| 活跃任务过多 | 账号未完成的任务 | 等待已有任务，不要继续提交副本 |
HTTP 429 或 Please retry after ... |
Retry-After 与响应说明 |
等待后重试适合重试的读取，不盲目重复生成 POST |
| 供应商或报价不可用 | 目录、询价服务及配置是否可用 | 保存参数，稍后再查，持续异常时联系支持 |
询价不锁定价格，更换输入或稍后提交可能重新计价。模型及设置也可能下架。实际请求与响应结构见 API 快速入门。
根据公开任务错误码排查
失败或取消任务的单任务查询，会在 data.taskInfo.userErrorCode 返回公开分类，可能不会展示供应商原始细节。不要把任务错误分类与外层 code 混淆，外层 code 描述本次 API 请求。
userErrorCode |
处理方式 |
|---|---|
reference_media_invalid |
检查 URL 可访问性、格式、文件损坏及供应商输入限制 |
reference_media_duration_invalid |
检查单段时长和参考素材总时长规则 |
too_many_images、too_many_videos、too_many_audios |
按所选模型限制删减素材 |
prompt_too_long |
将提示词缩短到模型允许范围 |
service_busy |
保留任务 ID，确认已记录状态，等待后再决定是否新建 |
content_safety_rejected |
检查输入与目标内容是否允许；认为误判时联系支持复核 |
copyright_restricted |
检查素材和用途的权利；认为限制有误时申请复核 |
task_canceled |
核对账户操作与积分记录 |
generation_failed |
属于通用分类；基础检查无法解决时提交任务 ID 和脱敏信息 |
不要反复重提被拒内容以规避供应商限制。失败任务也不会自动反复尝试直到得到可用结果。
参考素材无法读取
- 使用不依赖浏览器登录 Cookie 的可访问 URL，本地磁盘路径不是供应商可读取的 URL。
- 确认链接仍有效，并能覆盖处理时段。缩略图能打开，不证明原图或原视频也能访问。
- 核对真实格式、大小、参考数量和时长。站点上传限制与模型输入限制是不同检查项，须满足各自适用要求。
- 从最少的有效参考组开始。部分模型要求参考音频与图片或视频一起使用，请查看所选模型说明。
本站上传接口目前使用浏览器登录鉴权。仅持 API Key 的集成应使用适合的素材托管 URL，不要直接假设上传接口可接受密钥。涉及私有素材时，请选择供应商支持的访问方式，并让链接在处理期间保持有效。
人脸、产品或运镜不符合预期
| 症状 | 第一次怎么改 | 修改后检查什么 |
|---|---|---|
| 人脸变化 | 换清晰源图，降低表情和头部运动幅度 | 眼睛、牙齿、脸部轮廓与头发 |
| 标签或产品形状变化 | 减少环绕和物体大幅运动 | 逐帧检查轮廓、文字与反光 |
| 角色混杂 | 去除冲突参考，明确素材分工 | 每张图是否属于同一目标身份 |
| 闪烁或风格不统一 | 保留一种风格、一个动作和稳定光线 | 相邻帧及背景是否稳定 |
| 镜头不听指令 | 保留一种运镜并写明结束构图 | 实际构图和方向 |
| 多个动作未完成 | 拆成更短的独立镜头 | 每条是否完成一个动作 |
每次只改一个变量，其他设置和模型保持不变。这些方法有助于诊断，但不能保证身份、文字或物理表现准确。可结合提示词模板、图生视频案例和参考生视频案例调整。
视频没有声音
先取消预览静音，再测试下载文件。如果文件也没有声音，确认实际模型是否支持原生音频，以及声音控制项是否开启。对静音输出模型写“说话”，不会让它自动获得音频能力。
支持声音的模型可用简短对白和明确声音指令尝试新任务。独立音轨并非本站所有视频工具的承诺，不要根据 Pika 官方 Flex 的功能表推断本站支持。
生成成功，但下载或播放失败
查询已有任务，使用当前返回的 taskInfo.videos[].videoUrl。从后端下载时，不要向媒体域名转发本站 API Key。浏览器下载代理需要登录状态，该处 HTTP 401 不等于视频生成失败。
遇到 HTTP 403/404，核对链接与任务状态，持续不可访问时联系支持；再次查询不保证能够续期旧签名链接。播放异常时，在兼容播放器中测试完整下载的文件，并核对实际格式。更改扩展名不会转换编码。
按情况重试下载，不要重新进行付费生成。公开报告中请去掉带签名的媒体 URL。
积分看起来少了
提交任务后，排队或处理中也可能已经扣减积分。成功生成会消耗积分，即使你对创作效果不满意；再成功修改一次，就是另一次尝试。按照本站政策，生成失败会自动返还已扣积分。
核对任务最终状态和账户积分记录。赠送积分可能到期，不同订阅或积分包的实际单价也不同；任务尚未结束，不代表已确认退款。失败任务的返还没有体现在记录中时，请带任务 ID 提交工单，不要反复删除或重建任务来尝试强制返还。
预算说明见当前额度、成本与重试消耗。
联系支持时提供什么
通过账户支持渠道或 support@tikdek.com 联系，附任务 ID、模型、输入模式、近似发生时间和时区、参数、HTTP 状态、公开错误码，以及已尝试的步骤。请对个人素材、API Key、Cookie 和带签名链接脱敏。任务与积分记录截图有助于排查，但不要提供账户凭证。