开始使用 CRUN API（重要）
欢迎使用 CRUN。本指南将介绍将 CRUN API 集成到产品中所需的核心信息，包括模型、定价、身份验证、请求流程、限制和支持方式。
我们致力于提供透明、实用且对开发者友好的服务。请在投入生产环境之前仔细阅读本指南。
1. 可用模型与 Playground
您可以在模型页面查看最新支持的模型：
👉 https://crun.ai/models
- 我们会在新模型稳定后持续更新并上线。
- 每个模型页面都提供对应的 Playground，您可以在调用 API 前直接通过界面测试和调试。
- Playground 是了解模型行为、参数和输出格式的最佳方式。
2. 定价
完整且最新的价格列表可在此处查看：
👉 https://crun.ai/pricing
- 我们的价格通常比官方 API 低 30%–50%。
- 部分模型的折扣可达 80%。
- 由于上游成本可能调整，价格也可能随之变化。请始终以定价页面的最新信息为准。
3. 创建并保护您的 API Key
您可以在此处创建和管理 API Key：
👉 https://crun.ai/user-api-key
重要安全提示：
- 切勿在前端代码中暴露 API Key，包括浏览器、移动应用和公开代码仓库。
- 请将 API Key 视为敏感密钥妥善保管。
为了帮助您保护账户使用安全，我们提供：
- 按 Key 设置速率限制，支持小时、每日和总用量上限
- IP 白名单，仅允许已授权的服务器 IP 访问 API
这些能力可以帮助防止意外超量使用和未授权请求。
4. 必需请求头
每个 API 请求都必须包含正确的请求头：
X-API-KEY: <YOUR_API_KEY>
Content-Type: application/json
{"code":401,"msg":"API key missing"}
5. 日志与任务详情
您可以在此处查看所有历史任务：
👉 https://crun.ai/logs
每个任务都可以查看：
- 创建时间
- 使用的模型
- 输入参数
- 任务状态
- 积分消耗
- 最终结果或错误详情
如果您怀疑积分扣费异常，此页面是核对任务和用量的权威依据。
6. 数据保留策略
请注意以下数据保留规则：
- 生成的媒体文件：保留 14 天，之后自动删除
- 日志记录（文本 / 元数据）：保留 2 个月，之后自动删除
如果需要长期保存结果，请及时下载并存储到您自己的系统中。
7. 异步任务模型
CRUN 上的所有生成任务都是异步任务。
请求成功后会返回：
200 响应仅表示任务已创建，并不代表任务已经完成。
- 在请求中提供回调（webhook）URL，或
- 使用
task_id 主动轮询“查询任务状态”接口
8. 速率限制与并发
默认情况下，我们会应用以下限制：
- 每 10 秒最多创建 20 个新的生成请求
- 通常可支持 100+ 个并发运行任务
- 限制按账户维度生效
如果超过限制：
- 请求会被拒绝，并返回 HTTP 429
- 被拒绝的请求不会进入任务队列
对大多数用户来说，该限制已经足够使用。
如果您持续遇到 429 错误，可以联系支持团队申请更高限制。审批会谨慎处理。
9. 开发者支持
支持时间：
UTC 21:00 – UTC 17:00（次日）
您也可以通过邮件联系我们：[email protected]，但邮件不是首选方式，也通常不是最快方式。
10. 稳定性预期
我们以极具竞争力的价格提供高质量、领先的 API 能力。
同时也需要说明：
- 我们并不完美
- 整体稳定性可能略低于官方提供商
- 这是我们在价格和服务能力之间做出的明确取舍
在实际使用中，CRUN 已足够稳定，可以支持生产工作负载和长期业务增长。我们也希望在一开始就帮助您建立合理预期。
11. 关于团队
CRUN 由一个小型创业团队打造。
- 我们迭代速度快
- 我们非常重视开发者体验
- 我们持续改进产品和服务
同时，我们也坦诚地承认：
- 并非所有事情都已经完美
- 我们无法立即满足每一种使用场景
您的反馈会帮助我们持续改进，我们也真诚感谢每一位开发者的建议和支持。