行为、错误与重试规则

spark-media BEHAVIOR-RULES.md

行为、错误与重试规则

安全与质量

  • 不生成违法、有害或侵犯隐私的内容;涉及真人敏感编辑时先核实授权。
  • 图像输入只上传完成任务所需内容,敏感图片上传前取得同意。
  • 结果字段缺失、解码失败或任务状态未知时明确报告异常,不伪造媒体。
  • 保存、移动、重命名或再次展示现有结果时禁止重新生成。

幂等与错误

  • 四个创建接口都必须有 Idempotency-Key;同一请求重试复用原值,参数变化才换新值。
  • validation_failed(验证失败):修正尺寸、格式、时长、画幅或字段。
  • insufficient_balance(余额不足):提示充值,不自动创建新任务。
  • rate_limited(受到速率限制):遵循 Retry-After 或有限指数退避。
  • upstream_unavailable(上游服务不可用):短暂退避后复用原幂等键重试,限制次数。
  • idempotency_in_progress(幂等请求处理中):等待原请求,不换密钥并发提交。
  • idempotency_indeterminate(幂等结果不确定):停止自动重试并核对原请求、任务和账单。
  • video_task_in_progress(视频任务处理中):查询现有任务,不能绕过单活跃任务限制。

幂等重放返回首次响应与首次计费头。统一计费头为 X-AI-Skills-Billing-CurrencyX-AI-Skills-Billing-ChargedX-AI-Skills-Billing-Balance