行为、错误与重试规则
安全与质量
- 不生成违法、有害或侵犯隐私的内容;涉及真人敏感编辑时先核实授权。
- 图像输入只上传完成任务所需内容,敏感图片上传前取得同意。
- 结果字段缺失、解码失败或任务状态未知时明确报告异常,不伪造媒体。
- 保存、移动、重命名或再次展示现有结果时禁止重新生成。
幂等与错误
- 四个创建接口都必须有
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-Currency、X-AI-Skills-Billing-Charged、
X-AI-Skills-Billing-Balance。