Enterprise API

企業級程式開發與 LLM API

使用單一 Hypereal API 金鑰，即可支援程式開發代理、IDE 整合、內部工具與生產環境 LLM 工作負載。Enterprise API 相容 OpenAI，原生支援 Anthropic，並為追求穩定模型 ID、圖像生成、計費與用量日誌的團隊提供精選模型集合。

取得 API 金鑰查看模型

部分 Claude 模型 ID 僅限 Claude Code CLI 使用

以 -max 結尾的僅限 CLI 使用之 Claude 模型 ID（例如 claude-opus-4-7-max）僅支援透過 Claude Code CLI 存取 Anthropic 原生端點。嚴禁使用任何其他客戶端或第三方封裝器呼叫這些模型，違者將導致請求被封鎖且 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 金鑰在單一帳號層級控制平面中統一管理消費限額、模型範圍、用量日誌與 credits 計費。

請求保險

成功的 Enterprise API 請求包含延遲保險元資料，當請求時間異常過長時自動進行 credits 補償。

快速入門

呼叫聊天補全

使用託管基礎路徑存取精選 Enterprise 模型目錄與穩定的 Hypereal 模型 ID。

curlbash

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
  }'

OpenAI SDKts

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);

Responses APIts

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 搭配多模態聊天補全，或呼叫相容 OpenAI 的圖像生成端點以使用 GPT Image 2。請使用模型 ID nano-banana-2 和 gpt-image-2。多模態聊天圖像欄位回傳 base64 資料 URL，圖像生成端點則回傳 OpenAI 圖像回應格式。

多模態聊天圖像bash

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"
    }
  }'

OpenAI 圖像生成bash

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"
  }'

Claude Code

使用 Anthropic 原生端點

Claude Code 與 Anthropic SDK 客戶端應指向 Hypereal API 根路徑，因為它們會自動附加原生訊息路徑。原始 HTTP 客戶端可直接呼叫託管訊息路徑。工具使用、思考區塊、串流及提示快取欄位均完整保留。

僅限 CLI 使用的 Claude 模型 ID（-max 後綴）只能從 Claude Code CLI 使用。Hermes 或 OpenClaw 等第三方封裝器在此層級不被允許使用。

Claude Code 環境bash

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 CLIbash

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

Anthropic Messagesbash

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 模型

價格以每百萬 Token 顯示，並透過 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

列出 Enterprise 模型bash

curl https://api.hypereal.cloud/v1/managed/models \
  -H "Authorization: Bearer ck_..."

Schema

請求與回應格式

Enterprise API 接受 OpenAI 聊天補全請求格式、Responses API 格式，以及在所選模型支援時的 OpenAI 圖像生成請求。串流、工具、結構化輸出、溫度與最大 Token 控制在相容模型上均可透傳。

請求主體json

{
  "model": "claude-sonnet-4-7",
  "messages": [
    { "role": "user", "content": "Refactor this function." }
  ],
  "stream": true,
  "max_tokens": 2000
}

計費元資料json

{
  "hypereal": {
    "billing": {
      "model": "claude-sonnet-4-7",
      "credits_charged": 12,
      "balance_before": 1000,
      "balance_after": 988
    }
  }
}

代理

工具與快取

託管端點保留相容 OpenAI 的工具呼叫、結構化輸出、推理控制、串流區塊，以及所選模型支援的提示快取欄位。對於長時間的程式開發會話，請搭配快取控制發送穩定的專案上下文，並保持一致的 session ID。

工具呼叫ts

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",
});

快取bash

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 回應標頭的形式呈現。

層面	主要模型	請求數	Token 數	佇列
文字生成	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 金鑰消費限額、模型範圍、每日預算、每小時預算及每金鑰模型限制，均可在內部控制時設定得更低。

託管容量標頭http

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 請求為異常緩慢的成功呼叫提供請求保險。失敗的請求不收費，因此補償僅在成功請求產生 credits 扣費後才進行評估。非串流回應會在 hypereal.insurance 中包含結算資訊。串流回應則立即在標頭中公開保單資訊，並在串流結束後自動結算。

保險元資料json

{
  "hypereal": {
    "insurance": {
      "status": "paid",
      "trigger": "latency",
      "reason": "latency_threshold_exceeded",
      "latency_ms": 94320,
      "threshold_ms": 90000,
      "credits_charged": 12,
      "credits_compensated": 3
    }
  }
}

回應標頭http

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。使用 /v1/managed/messages 進行直接的 Anthropic 原生請求。Claude Code 應使用 https://api.hypereal.cloud 作為其基礎 URL。