智叶 API
应用接入与安全
将智叶 API 接入自己的应用，并妥善管理访问令牌和任务结果。
从应用服务端调用
由应用服务端调用 https://api.ziyelian.site，浏览器或移动端通过您自己的业务接口使用模型。API Key 保存在服务端环境变量或密钥管理系统中，不打包到前端资源。
按应用管理 Key
- 为不同应用、环境或团队分别创建 Key。
- 选择业务需要的模型分组，并设置有效期、额度和模型范围。
- 定期检查调用记录；Key 泄露时及时停用并更换。
- 日志中隐藏 Authorization、API Key、客户内容及私有文件地址。
请求与响应
根据模型选择对应接口，JSON 请求携带 Content-Type: application/json。保留完整模型 ID、任务 ID 和请求标识，便于关联业务订单。
流式响应应及时读取，按协议识别终止事件。网络中断与模型生成结束是不同状态，应用应分别处理。
异步视频任务
每个业务订单创建一次视频任务，保存返回的 id，随后查询同一任务。任务创建结果不明时先核对已有订单，不自动重复创建。
Seedance 两个分组均返回官方原始视频链接，Fast、Mini 使用 720p，2.0、2.5 可选 720p、1080p。任务成功后读取 content.video_url 直接下载保存；下载官方签名链接时不附加本站 API Key。也可选用本站任务下载接口。
超时与错误处理
- 为网络连接、请求上传和响应读取设置合理超时。
- 收到 429 时降低并发并遵循响应中的等待提示。
- 创建类请求不要在结果不明时无限重试；查询类请求可采用有上限的退避。
- 保留脱敏错误信息及请求 ID，向本站客服提供必要上下文。