通用约定

所有请求发往 https://api-ganfonxai.gangfeng.net，仅支持 HTTPS。接口路径与 OpenAI 兼容，例如视频生成为 https://api-ganfonxai.gangfeng.net/v1/videos。

• 每个请求都需携带 Authorization: Bearer YOUR_API_KEY，见 鉴权。
• 请求体使用 JSON（Content-Type: application/json）；上传本地图片时使用 multipart/form-data。
• 文本统一使用 UTF-8 编码。
• 时间字段均为 Unix 时间戳（秒），如 created_at、expires_at。
• 任务 ID 以 task_ 开头，查询、下载时原样使用。
• 金额单位为人民币元，详见 计费说明。

请求失败时返回非 2xx 的 HTTP 状态码，响应体是包含 code 和 message 的 JSON。目前有两种结构，请在解析时同时兼容：

// 任务接口的错误
{ "code": "task_submit_rate_limited", "message": "提交过于频繁：每秒最多提交 5 个任务，请稍后重试", "data": null }

// 部分请求校验错误（OpenAI 格式）
{ "error": { "code": "invalid_request", "message": "...", "type": "invalid_request_error" } }

状态码与错误码的完整说明见 错误码。

需要更高的提交速率，请联系平台调整。批量生成时，请在你的服务端排队并匀速提交，不要瞬间并发大量请求。

• 429：等待 Retry-After 秒后再重试；没有该响应头时按 1 秒、2 秒、4 秒指数退避。
• 5xx：服务暂时不可用，稍后重试，建议最多重试 3 次。
• 400 / 401 / 403：参数、密钥或余额问题，重试无效，请按错误信息修正。
• 提交请求超时或网络中断时，先查询再重试：到控制台「视频任务」确认任务是否已创建，避免重复扣费。

任务记录、调用日志和账单可在控制台长期查看。