> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 开始使用 CRUN API

> 通过统一 API 平台接入丰富的先进 AI 模型。您可以选择最新的图像生成、视频创作和音频模型，为应用构建 AI 能力。

# 开始使用 CRUN API（重要）

欢迎使用 **CRUN**。本指南将介绍将 CRUN API 集成到产品中所需的核心信息，包括模型、定价、身份验证、请求流程、限制和支持方式。

我们致力于提供透明、实用且对开发者友好的服务。请在投入生产环境之前仔细阅读本指南。

## 1. 可用模型与 Playground

您可以在模型页面查看**最新支持的模型**：

👉 [https://crun.ai/models](https://crun.ai/zh/models)

* 我们会在新模型稳定后持续更新并上线。
* 每个模型页面都提供对应的 **Playground**，您可以在调用 API 前直接通过界面测试和调试。
* Playground 是了解模型行为、参数和输出格式的最佳方式。

***

## 2. 定价

完整且最新的价格列表可在此处查看：

👉 [https://crun.ai/pricing](https://crun.ai/zh/pricing)

* 我们的价格通常比官方 API **低 30%–50%**。
* 部分模型的折扣可达 **80%**。
* 由于上游成本可能调整，价格也可能随之变化。请始终以定价页面的最新信息为准。

***

## 3. 创建并保护您的 API Key

您可以在此处创建和管理 API Key：

👉 [https://crun.ai/user-api-key](https://crun.ai/zh/user-api-key)

**重要安全提示：**

* **切勿在前端代码中暴露 API Key**，包括浏览器、移动应用和公开代码仓库。
* 请将 API Key 视为敏感密钥妥善保管。

为了帮助您保护账户使用安全，我们提供：

* **按 Key 设置速率限制**，支持小时、每日和总用量上限
* **IP 白名单**，仅允许已授权的服务器 IP 访问 API

这些能力可以帮助防止意外超量使用和未授权请求。

***

## 4. 必需请求头

每个 API 请求都**必须**包含正确的请求头：

```http theme={null} theme={null}
X-API-KEY: <YOUR_API_KEY>
Content-Type: application/json
```

如果请求头缺失或不正确，可能会收到如下响应：

```json theme={null} theme={null}
{"code":401,"msg":"API key missing"}
```

调试身份验证问题时，请优先检查请求头是否正确。

***

## 5. 日志与任务详情

您可以在此处查看所有历史任务：

👉 [https://crun.ai/logs](https://crun.ai/zh/logs)

每个任务都可以查看：

* 创建时间
* 使用的模型
* 输入参数
* 任务状态
* 积分消耗
* 最终结果或错误详情

如果您怀疑积分扣费异常，此页面是核对任务和用量的权威依据。

***

## 6. 数据保留策略

请注意以下数据保留规则：

* **生成的媒体文件**：保留 14 天，之后自动删除
* **日志记录**（文本 / 元数据）：保留 2 个月，之后自动删除

如果需要长期保存结果，请及时下载并存储到您自己的系统中。

***

## 7. 异步任务模型

CRUN 上的所有生成任务都是异步任务。

请求成功后会返回：

* **HTTP 200**
* 一个 `task_id`

<Warning>
  200 响应仅表示任务已创建，并不代表任务已经完成。
</Warning>

如需获取最终结果，您需要选择以下任一方式：

* 在请求中提供回调（webhook）URL，或
* 使用 `task_id` 主动轮询“查询任务状态”接口

***

## 8. 速率限制与并发

默认情况下，我们会应用以下限制：

* 每 10 秒最多创建 20 个新的生成请求
* 通常可支持 100+ 个并发运行任务
* 限制按账户维度生效

如果超过限制：

* 请求会被拒绝，并返回 HTTP 429
* 被拒绝的请求不会进入任务队列

对大多数用户来说，该限制已经足够使用。
如果您持续遇到 429 错误，可以联系支持团队申请更高限制。审批会谨慎处理。

***

## 9. 开发者支持

**支持时间：**
UTC 21:00 – UTC 17:00（次日）

您也可以通过邮件联系我们：[support@curn.ai](mailto:support@curn.ai)，但邮件不是首选方式，也通常不是最快方式。

***

## 10. 稳定性预期

我们以极具竞争力的价格提供高质量、领先的 API 能力。

同时也需要说明：

* 我们并不完美
* 整体稳定性可能略低于官方提供商
* 这是我们在价格和服务能力之间做出的明确取舍

在实际使用中，CRUN 已足够稳定，可以支持生产工作负载和长期业务增长。我们也希望在一开始就帮助您建立合理预期。

***

## 11. 关于团队

CRUN 由一个小型创业团队打造。

* 我们迭代速度快
* 我们非常重视开发者体验
* 我们持续改进产品和服务

同时，我们也坦诚地承认：

* 并非所有事情都已经完美
* 我们无法立即满足每一种使用场景

您的反馈会帮助我们持续改进，我们也真诚感谢每一位开发者的建议和支持。