跳转到主要内容

​
开始使用 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 请求都必须包含正确的请求头：
如果请求头缺失或不正确，可能会收到如下响应：
调试身份验证问题时，请优先检查请求头是否正确。

​
5. 模型请求输入

模型请求使用统一的外层 JSON 结构：
  • model：必填，指定模型 ID。
  • input：必填，填写该模型支持的参数对象。不同模型的 input 字段不同，请参阅对应模型文档。
  • callback_url：可选，用于接收任务完成通知。
为获得更好的请求性能，CRUN 所有模型的媒体文件输入仅支持 URL 格式。不支持 Base64 编码内容及其他输入方式。

​
6. 日志与任务详情

您可以在此处查看所有历史任务： 👉 https://crun.ai/logs 每个任务都可以查看：
  • 创建时间
  • 使用的模型
  • 输入参数
  • 任务状态
  • 积分消耗
  • 最终结果或错误详情
如果您怀疑积分扣费异常，此页面是核对任务和用量的权威依据。

​
7. 数据保留策略

请注意以下数据保留规则：
  • 生成的媒体文件：保留 14 天，之后自动删除
  • 日志记录（文本 / 元数据）：保留 2 个月，之后自动删除
如果需要长期保存结果，请及时下载并存储到您自己的系统中。

​
8. 异步任务模型

CRUN 上的所有生成任务都是异步任务。 请求成功后会返回：
  • HTTP 200
  • 一个 task_id
200 响应仅表示任务已创建，并不代表任务已经完成。
如需获取最终结果，您需要选择以下任一方式：

​
9. 速率限制与并发

默认情况下，我们会应用以下限制：
  • 每 10 秒最多创建 20 个新的生成请求
  • 通常可支持 100+ 个并发运行任务
  • 限制按账户维度生效
如果超过限制：
  • 请求会被拒绝，并返回 HTTP 429
  • 被拒绝的请求不会进入任务队列
对大多数用户来说，该限制已经足够使用。 如果您持续遇到 429 错误，可以联系支持团队申请更高限制。审批会谨慎处理。

​
10. 开发者支持

支持时间： UTC 21:00 – UTC 17:00（次日） 您也可以通过邮件联系我们：[email protected]，但邮件不是首选方式，也通常不是最快方式。

​
11. 稳定性预期

我们以极具竞争力的价格提供高质量、领先的 API 能力。 同时也需要说明：
  • 我们并不完美
  • 整体稳定性可能略低于官方提供商
  • 这是我们在价格和服务能力之间做出的明确取舍
在实际使用中，CRUN 已足够稳定，可以支持生产工作负载和长期业务增长。我们也希望在一开始就帮助您建立合理预期。

​
12. 关于团队

CRUN 由一个小型创业团队打造。
  • 我们迭代速度快
  • 我们非常重视开发者体验
  • 我们持续改进产品和服务
同时，我们也坦诚地承认：
  • 并非所有事情都已经完美
  • 我们无法立即满足每一种使用场景
您的反馈会帮助我们持续改进，我们也真诚感谢每一位开发者的建议和支持。