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

# Hy4 Preview

> Tencent Hy4 preview checkpoint (1M context, text-only) on Tencent Cloud TokenHub — native reasoning_effort, default high.

**Chat** · Tencent · China-hosted

> [!WARNING]
>
> **Requires an organization opt-in:** China-hosted opt-in. Until an administrator enables it from the admin console the model is hidden from pickers and API requests to it are refused. See [organization consent gates](https://docs.aireserve.com/models.md#organization-consent-gates).

## Call it

Endpoint: `POST /v1/chat/completions` — set `model` to `hy4-preview`.

```bash cURL theme={"dark"}
curl https://api.aireserve.com/v1/chat/completions \
  -H "Authorization: Bearer $AIRESERVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hy4-preview",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
```

```python Python theme={"dark"}
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.aireserve.com/v1",
    api_key=os.environ["AIRESERVE_API_KEY"],
)

res = client.chat.completions.create(
    model="hy4-preview",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(res.choices[0].message.content)
```

```typescript TypeScript theme={"dark"}
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.aireserve.com/v1",
  apiKey: process.env.AIRESERVE_API_KEY,
});

const res = await client.chat.completions.create({
  model: "hy4-preview",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(res.choices[0].message.content);
```

Full request and response reference: [Quickstart](https://docs.aireserve.com/getting-started/quickstart.md).

## IDs & aliases

| Send as `model` | What it is |
| - | - |
| `hy4-preview` | Canonical gateway id |
| `claude-air-hy4-preview` | Claude Code picker id |

Every alias resolves at the gateway and is disclosed back as `requestedModelAlias` in usage metadata. Routing variants also apply: `hy4-preview:nitro` picks the fastest provider serving these weights and `hy4-preview:floor` the cheapest ([details](https://docs.aireserve.com/models.md#provider-routing-variants)).

## Specs

| Spec | Detail |
| - | - |
| Modality | Text & chat — Chat |
| Model maker | Tencent |
| Served by | Tencent |
| Context window | 983,040 tokens |
| Max output | 65,536 tokens |
| Pricing | \$0.834 in / \$2.5 out per 1M tokens |
| Cached input | \$0.042 per 1M tokens |
| Capabilities | Streaming, Tool use, Extended reasoning, Prompt caching |
| Hosting | China-hosted provider ([what that means](https://docs.aireserve.com/models.md#china-hosted-models)) |
| Opt-ins | China-hosted opt-in |

Prices are public list rates at generation time and may lag the provider card; `GET /v1/models` and the portal's pricing page are authoritative for billing.

> [card] [Browse all models](https://docs.aireserve.com/models.md)
>
> Search and filter every model by modality, maker, capability and price.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.