> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# GPT-6 Astra API

> 1 つの BeatAPI キーで、OpenAI、Anthropic、Gemini 互換 SDK から GPT-6 Astra を利用できます。

GPT-6 Astra は、BeatAPI で利用できる最新世代の OpenAI モデルです。他のテキストモデルと同じ Text API パススルーを使用し、対応するすべての SDK 形式でモデル ID `gpt-6-astra` を指定します。

| モデル           | 適した用途                             | 課金                        |
| ------------- | --------------------------------- | ------------------------- |
| `gpt-6-astra` | GPT-5.6 より高い料金でも、最新世代の推論能力を重視する処理 | 入力トークンが 272K を超えると上位料金を適用 |

> **Tip**
>
> Astra は入力が 272K トークンを超えると上位の料金が適用されます。現在の BeatAPI の通常料金は、100 万トークンあたり入力 $4、キャッシュ入力 $0.40、出力 $20 です。272K を超えると、リクエスト全体に入力 $8、キャッシュ入力 $0.80、出力 $30 が適用されます。[最新の料金表](https://beatapi.io/pricing)で該当する料金を確認し、`GET /v1/models` でアカウントが利用できるモデルを確認してください。

## 推奨：OpenAI Responses

`POST https://api.beatapi.io/v1/responses`

```typescript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.BEATAPI_API_KEY,
  baseURL: "https://api.beatapi.io/v1"
});

const response = await client.responses.create({
  model: "gpt-6-astra",
  input: "Design a resilient webhook retry strategy for a payments API.",
  reasoning: { effort: "medium" }
});

console.log(response.output_text);
```

```bash
curl --request POST \
  --url https://api.beatapi.io/v1/responses \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-6-astra",
  "input": "Design a resilient webhook retry strategy for a payments API.",
  "reasoning": { "effort": "medium" }
}'
```

推論の強度には `none`、`low`、`medium`、`high`、`xhigh`、`max` を指定できます。まずはバランスのよい `medium` から始め、実際の処理で 1 段階低い設定と高い設定を比較してください。

## 既存の SDK 形式

既存の実装は、ベース URL を変更し、プロバイダーのキーを BeatAPI キーに置き換えることで移行できます。

### OpenAI Chat Completions

`POST https://api.beatapi.io/v1/chat/completions`

```bash
curl --request POST \
  --url https://api.beatapi.io/v1/chat/completions \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-6-astra",
  "messages": [
    { "role": "user", "content": "Design a resilient webhook retry strategy for a payments API." }
  ]
}'
```

### Anthropic Messages

`POST https://api.beatapi.io/v1/messages`

```bash
curl --request POST \
  --url https://api.beatapi.io/v1/messages \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-6-astra",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "Design a resilient webhook retry strategy for a payments API." }
  ]
}'
```

### Gemini generateContent

`POST https://api.beatapi.io/v1beta/models/gpt-6-astra:generateContent`

```bash
curl --request POST \
  --url 'https://api.beatapi.io/v1beta/models/gpt-6-astra:generateContent' \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "contents": [
    { "role": "user", "parts": [{ "text": "Design a resilient webhook retry strategy for a payments API." }] }
  ]
}'
```

## キーで利用できるモデルの確認

`GET https://api.beatapi.io/v1/models`

```json
{
  "object": "list",
  "data": [
    { "id": "gpt-6-astra", "object": "model", "owned_by": "beatapi" }
  ]
}
```

Text、Image、Video、Workflow、Effect、Realtime API は、同じ API キーと USD 残高を共有します。呼び出しは実際のトークン使用量に基づいて課金されます。ダッシュボードの利用状況ログで、リクエスト ID、モデル、トークン総数、ステータス、精算額を確認できます。