需打通airtable与zebracat数据链路：一、建“zebracat_ai_animation_jobs”base，设动画id等字段及“待提交队列”视图；二、用自动化将字段映射为json调用zebracat api；三、脚本预检必填项与格式；四、配置webhook实现状态双向同步；五、支持csv离线批量导入降级。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望借助 Zebracat 与 Airtable 协同实现 AI 动画的规模化产出，则需打通数据驱动的内容生成链路。Airtable 作为结构化任务管理中枢，可承载角色设定、分镜脚本、提示词模板、参数配置等字段；Zebracat 则依据该表单自动调用对应动画生成指令。以下是具体实施路径：
一、搭建Airtable基础表结构
Airtable 表需支持多视图协同与自动化触发，核心字段应覆盖动画生产全流程要素，确保 Zebracat 能准确读取每一项生成指令。每个记录代表一个独立动画单元，支持批量操作与状态追踪。
1、创建新 Base，命名为“Zebracat_AI_Animation_Jobs”。
2、添加字段：【动画ID】（自动编号）、【场景描述】（长文本）、【主体动作】（单选/多选）、【风格关键词】（协作文本）、【时长秒数】（数字）、【输出尺寸】（单选：1080x1920 / 1920x1080 / 720x720）、【Zebracat_Model】（单选：anime-v3 / real-time-2.1 / cartoon-pro）、【状态】（单选：待生成 / 已提交 / 已完成 / 失败）。
3、设置视图：新建“待提交队列”视图，筛选条件为【状态】=“待生成”，排序按【动画ID】升序。
二、配置Zebracat API对接字段映射
Zebracat 支持通过 Webhook 或 CSV 批量导入方式接收结构化提示指令，Airtable 需将各字段按 Zebracat 所需 JSON Schema 格式组装，确保字段名、数据类型、枚举值范围完全匹配其 API 文档要求。
1、在 Airtable 中启用“自动化”功能，选择触发器为“当记录匹配条件时”——条件设为【状态】从“待生成”变为“已提交”。
2、添加操作“发送 HTTP 请求”，方法设为 POST，URL 填入 Zebracat 提供的批量提交端点（如 https://api.zebracat.ai/v1/batch/jobs）。
3、在请求体（Body）中使用 Airtable 公式拼接 JSON，例如：{"prompt": "{场景描述}，{主体动作}，{风格关键词}","model": "{Zebracat_Model}","duration": {时长秒数},"resolution": "{输出尺寸}"}。
4、配置请求头（Headers）：Content-Type 设为 application/json，Authorization 填入 Zebracat 提供的 Bearer Token。
三、启用Airtable脚本自动化预检
为避免无效记录进入 Zebracat 队列导致失败重试，需在提交前执行字段完整性校验与格式合规性检查，降低 API 报错率并提升批量成功率。
1、在自动化流程中插入“运行脚本”操作，选择 JavaScript 环境。
2、脚本内定义必填字段数组：["场景描述", "主体动作", "Zebracat_Model", "时长秒数", "输出尺寸"]。
3、遍历当前记录各字段值，对空值或非法值（如时长≤0、尺寸不在预设列表中）打标并更新【状态】为“失败”，同时写入【错误说明】字段，例如：“输出尺寸‘2000x1000’未在白名单中，请选择：1080x1920 / 1920x1080 / 720x720”。
4、仅当全部校验通过，才执行后续 HTTP 请求步骤。
四、建立双向状态同步机制
Zebracat 生成完成后会返回 job_id 与回调 URL，Airtable 需能接收异步通知并更新本地记录状态，形成闭环反馈，支撑后续人工复核或自动归档。
1、在 Airtable Base 中新增“Webhook 接收器”视图，启用“公开 API”并复制其唯一 endpoint URL（如 https://airtable.com/v0/xxx/Zebracat_Webhook）。
2、在 Zebracat 后台配置该 URL 为任务完成回调地址，并勾选“携带 job_id 与 status 字段”。
3、在 Airtable 自动化中新增触发器：“当收到 Webhook 请求时”，解析请求体中的 job_id，通过查找记录功能定位原始动画条目。
4、根据回调中的 status 字段值，更新【状态】为“已完成”或“失败”，并在【Zebracat_Job_ID】字段写入返回的唯一标识符，便于溯源。
五、部署CSV离线批量导入备用流
当网络不稳定或 Zebracat API 临时不可用时，可切换至离线 CSV 导入模式，保障生产不中断。Airtable 支持导出结构化 CSV 并适配 Zebracat 批量上传模板格式，实现无缝降级。
1、在 Airtable 视图“待提交队列”中点击右上角“•••” → “导出视图” → 选择 CSV 格式。
2、使用 Excel 或脚本清洗字段：将【输出尺寸】列统一转为 Zebracat 接受的代码值（如“1080x1920”→“portrait”），【Zebracat_Model】列映射为 API 内部模型代号（如“anime-v3”→“zbc-anime-v3”）。
3、保存为 zebracat_batch_input.csv，字段顺序严格对应 Zebracat 官方文档要求的 header 行：prompt,model,duration,resolution,style_preset。
4、登录 Zebracat 控制台，进入“Batch Import”页，拖入该 CSV 文件，点击“Validate & Submit”，系统将自动校验格式并启动队列。
