> ## 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.

# Getting Started with CURN API

> Access a comprehensive collection of state-of-the-art AI models through our unified API platform. Choose from the latest image generation, video creation, and audio models to power your applications.

# Getting Started with CRUN API (Important)

Welcome to **CRUN**. This guide walks you through the essential information you need to start integrating CRUN APIs into your product, including models, pricing, authentication, request flow, limits, and support.

We aim to be transparent, practical, and developer-friendly. Please read this carefully before going to production.

## 1. Available Models & Playground

You can find the **latest supported model** on our models page:

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

* We continuously update and onboard new models as soon as they are stable.
* Each model page links to its **Playground**, where you can test and experiment directly in our UI before calling the API.
* The Playground is the best place to understand model behavior, parameters, and output formats.

***

## 2. Pricing

The complete and up-to-date pricing list is available here:

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

* Our prices are typically **30%–50% lower than official APIs**.
* For some models, discounts can reach **up to 80%**.
* Pricing may change as upstream providers adjust their costs, so always refer to the pricing page for the latest numbers.

***

## 3. Creating and Securing Your API Key

Create and manage your API keys here:

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

**Important security notes:**

* **Never expose your API key in frontend code** (browser, mobile apps, public repositories).
* Treat your API key as a secret.

To help protect your usage, we provide:

* **Rate limits per key** (hourly, daily, and total usage caps)
* **IP whitelist** support, allowing only approved server IPs to access the API

These features help prevent accidental overuse and unauthorized requests.

***

## 4. Required Request Headers

Every API request **must** include the correct headers:

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

If these headers are missing or incorrect, you may receive:

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

Always double-check your headers when debugging authentication issues.

***

## 5. Logs & Task Details

You can inspect all your historical tasks here:

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

For each task, you can view:

* Creation time
* Model used
* Input parameters
* Task status
* Credit consumption
* Final results or error details

If you ever suspect incorrect credit usage, this page is the source of truth for verification.

***

## 6. Data Retention Policy

Please note our retention rules:

* **Generated media files**: stored for 14 days, then automatically deleted
* **Log records** (text / metadata): stored for 2 months, then automatically deleted

If you need long-term access, make sure to download and store results on your side in time.

***

## 7. Asynchronous Task Model

All generation tasks on CRUN are asynchronous.

A successful request returns:

* **HTTP 200**
* A `task_id`

<Warning>
  A 200 response only means the task was created, not completed.
</Warning>

To get the final result, you must either:

* Provide a callback (webhook) URL in the request, or
* Actively poll the "query task status" API using the `task_id`

***

## 8. Rate Limits & Concurrency

By default, we apply the following limits:

* Up to 20 new generation requests per 10 seconds
* This typically allows 100+ concurrent running tasks
* Limits are applied per account

If you exceed the limit:

* Requests will be rejected with HTTP 429
* Rejected requests will not enter the queue

For most users, this is more than sufficient.
If you consistently hit 429 errors, you may contact support to request a higher limit — approvals are handled cautiously.

***

## 9. Developer Support

**Support hours:**
UTC 21:00 – UTC 17:00 (next day)

You may also email us at [support@curn.ai](mailto:support@curn.ai), but this is not the preferred or fastest option.

***

## 10. Stability Expectations

We provide access to top-tier, highly competitive APIs at very aggressive pricing.

That said:

* We are not perfect
* Our overall stability may be slightly lower than official providers
* This is a conscious trade-off

In practice, CRUN is stable enough to support production workloads and long-term business growth, but we believe in setting realistic expectations upfront.

***

## 11. About the Team

CRUN is built by a small startup team.

* We move fast
* We care deeply about developer experience
* We are constantly improving

At the same time, we acknowledge that:

* Not everything is perfect
* We can't satisfy every use case immediately

Your feedback helps us improve — and we genuinely appreciate it.