> ## Documentation Index
> Fetch the complete documentation index at: https://docs.redbit.one/llms.txt
> Use this file to discover all available pages before exploring further.

# 操作检查清单

> 面向 Redbit 上线配置、首次生成和视频生成失败排查的实用清单。

# 操作检查清单

在把真实任务交给 Redbit 前，先用这几张清单过一遍。每一项都对应一个会影响是否继续推进的实际判断。

## 谁应该阅读本文

| 读者        | 适用场景                    |
| --------- | ----------------------- |
| 工作区负责人    | 准备把 Redbit 环境交给用户使用     |
| 首次使用者     | 准备发起真实生成任务              |
| 支持/客户成功团队 | 视频或供应商工作流失败，需要做第一轮结构化排查 |

## 前置概念

先确认当前使用的是哪条路由：直接供应商、中继供应商、自定义中继，还是 Local Core。不要把凭证粘贴到 prompt、Cards、Workshop 脚本或 Agent 聊天里。

## 上线前配置

| 检查项                                            | 为什么重要                                                         |
| ---------------------------------------------- | ------------------------------------------------------------- |
| 确认工作区入口和路径：`/dashboard`、`/workshop`、Settings   | 用户需要稳定入口，才能开始模型配置                                             |
| 只配置当前工作流需要的供应商 key                             | 降低误暴露和误选供应商的风险                                                |
| 确认路由是直接供应商、中继还是自定义中继                           | 可见模型和 payload 形状会随路由变化                                        |
| 如果要使用 Agent，先测试 describe/Agent runtime profile | tool calling、structured output、system prompt 和 vision 支持因模型而异 |
| 只有需要本地媒体、MCP、自动化、FFmpeg、插件或存储桥接时才配对 Local Core | 普通浏览器侧生成不需要本地引擎                                               |
| 上传机密素材前确认供应商条款                                 | Redbit 负责组织请求；隐私和保留政策仍由供应商决定                                  |
| 提前决定资产如何备份或导出                                  | 浏览器 profile 删除、站点数据清理或配额压力都可能移除本地数据                           |

## 首次生成前检查

| 检查项                                                  | 为什么重要                                  |
| ---------------------------------------------------- | -------------------------------------- |
| 选择正确标签：`Describe`、`Image`、`Video`、`Audio` 或 `Speech` | 标签决定可见模型、默认值和输入要求                      |
| 确认模型家族和变体                                            | 同一个 prompt 在不同模型上会产生不同结果               |
| 按需确认比例、时长、清晰度和音频设置                                   | 视频和图像供应商可能拒绝不支持的组合                     |
| 只添加所选模型接受的参考素材                                       | Seedance、运动模型、图像编辑和 describe 模型的输入规则不同 |
| 除非任务需要 Agent 检查或路由素材，否则不要把源素材放进 Agent 聊天             | 避免素材进入不必要的助手上下文                        |
| 准备复用的结果请保存或置顶                                        | 临时最近素材可能被清理                            |
| 重试前先读卡片错误                                            | 不改凭证、输入或路由，通常只会重复同一失败                  |

## 视频生成失败排查

| 现象              | 第一轮检查                                            |
| --------------- | ------------------------------------------------ |
| 缺少参考素材          | 确认模式和必需角色：首帧、尾帧、参考图、参考视频或参考音频                    |
| Seedance 参考混用错误 | 同一个任务中只使用首尾帧角色，或只使用多参考角色，不要混用                    |
| 供应商或中继报错        | 检查 API key 类型、base URL、中继能力、模型 ID 映射、额度和供应商状态    |
| 开启中继后模型消失       | 中继能力过滤可能不包含该模型家族或变体                              |
| 视频很慢或卡住         | 尝试更短时长、更低清晰度、fast 变体，或换成队列压力更小的 provider 路由      |
| 结果和 prompt 不匹配  | 对比供应商/模型能力、参考强度、prompt 具体度，以及模型是否支持该输入类型         |
| Agent 说完成但没有媒体  | 检查生成工具是否真的返回 `{ success: true }`；只有文字回复不足以代表生成成功 |

## 下一步

路由配置看 [模型与供应商配置](./model-providers.mdx)，Seedance 专属问题看 [Seedance 视频工作流](./seedance-video.mdx)，面向用户的回答看 [FAQ 与排障](../faq.mdx)。