エンタープライズグレードのコーディング・LLM API
コーディングエージェント・IDE 統合・社内ツール・本番 LLM ワークロードに、1つの Hypereal API キーを使用できます。Enterprise API は OpenAI 互換かつ Anthropic ネイティブで、予測可能なモデル ID・画像生成・請求・使用ログを求めるチーム向けにキュレーションされたモデルセットを提供します。
-max で終わる CLI 専用 Claude モデル ID(例:claude-opus-4-7-max)は、Anthropic ネイティブエンドポイントに対する Claude Code CLI からの利用のみサポートされています。これらのモデルを他のクライアントやサードパーティラッパーで使用することは厳禁であり、リクエストがブロックされ API キーが返金なく停止されます。Hermes、OpenClaw およびプロキシ・リプレイ・アカウントプーリングツール類を含みますが、これらに限定されません。標準(非 -max)モデルは影響を受けず、すべてのクライアントから引き続き利用可能です。
Claude Code・コーディングエージェント・レビューボット・IDE ツール・OpenAI または Anthropic API を利用する社内自動化と組み合わせて使用できます。
Claude Opus 4.8、Claude Sonnet 4.7、Claude Haiku、GPT-5.5、Nano Banana 2、GPT Image 2、DeepSeek、Qwen、Kimi が安定した Hypereal モデル ID で提供されています。
マルチモーダルレスポンスフィールドとアカウントレベルの使用量制御を備えた同一のマネージドチャット補完エンドポイントを通じて画像を生成できます。
Hypereal API キーは、支出制限・モデルスコープ・使用ログ・クレジット課金を1つのアカウントレベルコントロールプレーンで管理します。
Enterprise API リクエストの成功時には、レイテンシ保険メタデータが含まれ、異常に時間がかかった場合は自動的にクレジット補償が行われます。
チャット補完を呼び出す
キュレーションされた Enterprise モデルカタログと安定した Hypereal モデル ID には、マネージドベースパスを使用してください。
curl https://api.hypereal.cloud/v1/managed/chat/completions \
-H "Authorization: Bearer ck_..." \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-7",
"messages": [
{
"role": "system",
"content": "You are a senior software engineer."
},
{
"role": "user",
"content": "Review this TypeScript function for correctness."
}
],
"temperature": 0.2,
"max_tokens": 1200
}'import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.HYPEREAL_API_KEY,
baseURL: "https://api.hypereal.cloud/v1/managed",
});
const completion = await client.chat.completions.create({
model: "claude-sonnet-4-7",
messages: [
{ role: "user", content: "Write a migration checklist for this PR." },
],
});
console.log(completion.choices[0]?.message?.content);const response = await client.responses.create({
model: "claude-sonnet-4-7",
input: "Create a concise migration checklist for this pull request.",
});
console.log(response.output_text);チャット補完で画像を生成する
Nano Banana 2 をマルチモーダルチャット補完と組み合わせるか、GPT Image 2 用の OpenAI 互換画像生成エンドポイントを呼び出してください。モデル ID は nano-banana-2 と gpt-image-2 を使用します。マルチモーダルチャットの画像フィールドは base64 データ URL を返し、画像生成は OpenAI の画像レスポンス形式を返します。
curl https://api.hypereal.cloud/v1/managed/chat/completions \
-H "Authorization: Bearer ck_..." \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2",
"messages": [
{
"role": "user",
"content": "Generate a clean product mockup of a glass banana sculpture on a white studio background."
}
],
"modalities": ["image", "text"],
"image_config": {
"aspect_ratio": "1:1",
"image_size": "1K"
}
}'curl https://api.hypereal.cloud/v1/managed/images/generations \
-H "Authorization: Bearer ck_..." \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A clean product mockup of a glass banana sculpture on a white studio background.",
"size": "1024x1024",
"quality": "standard"
}'Anthropic ネイティブエンドポイントを使用する
Claude Code および Anthropic SDK クライアントは、ネイティブのメッセージパスを自動で追加するため、Hypereal API ルートを指定してください。生の HTTP クライアントはマネージドメッセージパスを直接呼び出せます。ツール使用・思考ブロック・ストリーミング・プロンプトキャッシュフィールドは保持されます。
CLI 専用 Claude モデル ID(-max サフィックス)は Claude Code CLI からのみ使用してください。Hermes や OpenClaw などのサードパーティラッパーはこのティアでは許可されていません。
export ANTHROPIC_BASE_URL="https://api.hypereal.cloud" export ANTHROPIC_AUTH_TOKEN="ck_..." export ANTHROPIC_API_KEY="" export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8" export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-7" export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-latest" export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-7"
# Claude Code CLI ONLY. # Claude model IDs for the official Claude Code CLI, not third-party wrappers. export ANTHROPIC_BASE_URL="https://api.hypereal.cloud" export ANTHROPIC_AUTH_TOKEN="ck_..." export ANTHROPIC_API_KEY="" export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-7-max" export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6-max" export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-max" export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-6-max"
curl https://api.hypereal.cloud/v1/managed/messages \
-H "anthropic-api-key: ck_..." \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-7",
"messages": [
{ "role": "user", "content": "Review this diff." }
],
"tools": [],
"max_tokens": 1200
}'サポート対象の Enterprise モデル
価格は100万トークンあたりで表示され、Hypereal Credits で課金されます。
| モデル ID | 名前 | コンテキスト | 入力 | キャッシュ読み取り | キャッシュ書き込み | 出力 |
|---|---|---|---|---|---|---|
| claude-opus-4-8 | Claude Opus 4.8 | 1M | $5.25 | $0.525 | $6.56 | $26.25 |
| claude-sonnet-4-7 | Claude Sonnet 4.7 | 1M | $3.15 | $0.315 | $3.94 | $15.75 |
| claude-haiku-latest | Claude Haiku Latest | 200k | $1.05 | $0.105 | $1.31 | $5.25 |
| claude-opus-4-7-max | Claude Opus 4.7 | 200k | $5.25 | $0.525 | $6.56 | $26.25 |
| claude-opus-4-6-max | Claude Opus 4.6 (1M) | 1M | $5.25 | $0.525 | $6.56 | $26.25 |
| claude-opus-4-5-max | Claude Opus 4.5 | 200k | $5.25 | $0.525 | $6.56 | $26.25 |
| claude-sonnet-4-6-max | Claude Sonnet 4.6 | 200k | $3.15 | $0.315 | $3.94 | $15.75 |
| claude-sonnet-4-5-max | Claude Sonnet 4.5 | 200k | $3.15 | $0.315 | $3.94 | $15.75 |
| claude-haiku-4-5-max | Claude Haiku 4.5 | 200k | $1.05 | $0.105 | $1.31 | $5.25 |
| gpt-5-5 | GPT-5.5 | 1M | $5.25 | $0.525 | n/a | $31.50 |
| deepseek-v4-pro | DeepSeek V4 Pro | 1M | $0.4567 | $0.0038 | n/a | $0.9135 |
| qwen3-7-max | Qwen3.7 Max | 200k | $1.31 | $0.2625 | $1.64 | $3.94 |
| qwen3-7-plus | Qwen3.7 Plus | 1M | $0.42 | $0.084 | $0.525 | $1.68 |
| kimi-latest | Kimi Latest | 256k | $0.7182 | $0.1512 | n/a | $3.59 |
| nano-banana-2 | Nano Banana 2 | 131k | $0.525 | n/a | n/a | $3.15 |
| gpt-image-2 | GPT Image 2 | 272k | $8.40 | $2.10 | n/a | $31.50 |
curl https://api.hypereal.cloud/v1/managed/models \ -H "Authorization: Bearer ck_..."
リクエストとレスポンスの形式
Enterprise API は、OpenAI チャット補完リクエスト形式・Responses API 形式・対応モデルでの OpenAI 画像生成リクエストを受け付けます。ストリーミング・ツール・構造化出力・温度・最大トークン制御は、互換モデルで透過的に適用されます。
{
"model": "claude-sonnet-4-7",
"messages": [
{ "role": "user", "content": "Refactor this function." }
],
"stream": true,
"max_tokens": 2000
}{
"hypereal": {
"billing": {
"model": "claude-sonnet-4-7",
"credits_charged": 12,
"balance_before": 1000,
"balance_after": 988
}
}
}ツールとキャッシング
マネージドエンドポイントは、選択されたモデルがサポートする場合に、OpenAI 互換ツール呼び出し・構造化出力・推論制御・ストリーミングチャンク・プロンプトキャッシュフィールドを保持します。長いコーディングセッションでは、キャッシュ制御付きの安定したプロジェクトコンテキストを送信し、一貫したセッション ID を維持してください。
const completion = await client.chat.completions.create({
model: "claude-sonnet-4-7",
messages: [{ role: "user", content: "Find the changed files." }],
tools: [
{
type: "function",
function: {
name: "list_changed_files",
description: "List changed files in the current repository.",
parameters: { type: "object", properties: {} },
},
},
],
tool_choice: "auto",
});curl https://api.hypereal.cloud/v1/managed/chat/completions \
-H "Authorization: Bearer ck_..." \
-H "Content-Type: application/json" \
-H "X-Hypereal-Cache: true" \
-H "X-Session-Id: coding-agent-session-123" \
-d '{
"model": "claude-sonnet-4-7",
"cache_control": { "type": "ephemeral" },
"messages": [
{ "role": "system", "content": "Stable project context..." },
{ "role": "user", "content": "Continue the refactor." }
],
"max_tokens": 1200
}'マネージド同時実行制御
Enterprise API リクエストはモデル呼び出しの前にマネージドアドミッションコントロールを通過します。ゲートウェイは短いウェイトキュー・モデルレベルの同時実行スロット・アカウントレベルの分間リクエスト制限・容量テレメトリ・過負荷モデルパス用のサーキットブレーカーを使用します。これらの制御は Enterprise API トラフィックにのみ適用され、Hypereal レスポンスヘッダーとして公開されます。
| サーフェス | 主要モデル | リクエスト | トークン | キュー |
|---|---|---|---|---|
| テキスト生成 | gpt-5-5 | 15,000 RPM | 40,000,000 TPM | 15,000,000,000 tokens |
| 画像生成 | gpt-image-2 | 250 IPM | 8,000,000 TPM | n/a |
これらはマネージド容量の上限です。API キーの支出制限・モデルスコープ・日次予算・時間予算・キーごとのモデル制限は、内部管理のためにより低く設定できます。
X-Hypereal-Managed-Governor: active X-Hypereal-Managed-Model-Concurrency-Limit: 80 X-Hypereal-Managed-Model-Concurrency-Remaining: 79 X-Hypereal-Managed-Model-RPM-Limit: 15000 X-Hypereal-Managed-Model-RPM-Remaining: 14999 X-Hypereal-Capacity-Requests-Remaining: 9852 X-Hypereal-Managed-Image-IPM-Limit: 250 X-Hypereal-Managed-Image-IPM-Remaining: 249 X-Hypereal-Managed-Circuit: closed
低速リクエストへの自動補償
Enterprise API リクエストには、異常に低速な成功リクエストに対するリクエスト保険が付帯しています。失敗したリクエストは課金されないため、補償は成功リクエストにクレジット請求が発生した後にのみ評価されます。非ストリーミングレスポンスには hypereal.insurance に精算内容が含まれます。ストリーミングレスポンスはポリシーヘッダーを即時公開し、ストリーム終了後に自動的に精算されます。
{
"hypereal": {
"insurance": {
"status": "paid",
"trigger": "latency",
"reason": "latency_threshold_exceeded",
"latency_ms": 94320,
"threshold_ms": 90000,
"credits_charged": 12,
"credits_compensated": 3
}
}
}X-Hypereal-Insurance-Status: paid X-Hypereal-Insurance-Trigger: latency X-Hypereal-Insurance-Latency-Ms: 94320 X-Hypereal-Insurance-Threshold-Ms: 90000 X-Hypereal-Insurance-Credits: 3
OpenAI 互換チャット補完には /v1/managed/chat/completions、Responses API には /v1/managed/responses、OpenAI 画像生成には /v1/managed/images/generations のマネージドパスを使用してください。Anthropic ネイティブリクエストには /v1/managed/messages を使用します。Claude Code のベース URL には https://api.hypereal.cloud を指定してください。
