身份验证

每个 /v1 请求都必须在 Authorization 请求头中携带 Open AI Image API 密钥。

Authorization: Bearer sk_sd_example

创建密钥

前往设置 → API 密钥，填写便于识别的名称，然后创建密钥。完整密钥只显示一次。之后 Open AI Image 只保存安全哈希，无法再次显示原密钥。

只在服务端保存密钥

例如，可以把密钥保存为 OPENAIIMAGE_API_KEY，只注入到调用 API 的服务端进程。不要在应用日志或错误追踪工具中输出密钥。

撤销和轮换

如果密钥可能已经泄露，请立即撤销。使用已撤销密钥的请求会返回 401。如果轮换期间不能中断服务，请先创建新密钥，再撤销旧密钥。

速率限制

创建任务的请求间隔至少为 1.5 秒；同一 IP 的 API 请求间隔至少为 100 毫秒。超出限制时会返回 429。请使用带随机抖动的指数退避，轮询间隔从 5–10 秒开始。