企業級程式開發與 LLM API
使用單一 Hypereal API 金鑰,即可支援程式開發代理、IDE 整合、內部工具與生產環境 LLM 工作負載。Enterprise API 相容 OpenAI,原生支援 Anthropic,並為追求穩定模型 ID、圖像生成、計費與用量日誌的團隊提供精選模型集合。
以 -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。
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 搭配多模態聊天補全,或呼叫相容 OpenAI 的圖像生成端點以使用 GPT Image 2。請使用模型 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 模型
價格以每百萬 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 |
curl https://api.hypereal.cloud/v1/managed/models \ -H "Authorization: Bearer ck_..."
請求與回應格式
Enterprise API 接受 OpenAI 聊天補全請求格式、Responses API 格式,以及在所選模型支援時的 OpenAI 圖像生成請求。串流、工具、結構化輸出、溫度與最大 Token 控制在相容模型上均可透傳。
{
"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 的工具呼叫、結構化輸出、推理控制、串流區塊,以及所選模型支援的提示快取欄位。對於長時間的程式開發會話,請搭配快取控制發送穩定的專案上下文,並保持一致的 session 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 回應標頭的形式呈現。
| 層面 | 主要模型 | 請求數 | 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 金鑰消費限額、模型範圍、每日預算、每小時預算及每金鑰模型限制,均可在內部控制時設定得更低。
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 中包含結算資訊。串流回應則立即在標頭中公開保單資訊,並在串流結束後自動結算。
{
"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。使用 /v1/managed/messages 進行直接的 Anthropic 原生請求。Claude Code 應使用 https://api.hypereal.cloud 作為其基礎 URL。
