身份验证

网关 Hostlinku 使用 Bearer token 身份验证，API 密钥格式为 sk-…。向 /v1/* 端点发送的每个请求中都应包含该 API 密钥：

Authorization: Bearer sk-isi-api-key-kamu
Content-Type: application/json

对于端点 Anthropic Messages，也接受 x-api-key: sk-… 标头。 API密钥可在console.hostlinku.com的API密钥菜单中创建和管理。

创建 API 密钥

API密钥以SHA-256哈希值的形式存储在服务器上：其原始值从未被存储，也无法还原。旧版API密钥（如hl_live_…）仍然有效，因为身份验证是基于哈希值而非前缀进行的。

创建 API 密钥时的可选过期时间：

过期的API密钥将被拒绝，提示如下：

{
  "status": "error",
  "error": { "code": "UNAUTHORIZED", "message": "API key sudah kedaluwarsa." }
}

每个 API 密钥均可设置 以美元为单位的使用限额（creditLimit），其重置周期为：

使用量根据该 API 密钥记录的实际请求费用（requests.customer_cost）进行计算。当累计费用达到限额时，后续请求将被拒绝并返回 402 PAYMENT_REQUIRED 状态码：

{
  "status": "error",
  "error": {
    "code": "PAYMENT_REQUIRED",
    "message": "Limit kredit API key tercapai (🪙10.0000 dari 🪙10 total)."
  }
}

额度与账户余额不同：额度仅针对单个 API 密钥，而账户余额则是所有 API 密钥的资金来源。两者都必须充足，请求才能执行。请参阅计费与余额。

除了额度限制外，支付网关还会针对每个API密钥实施请求频率限制：

超过限额将导致出现 429 RATE_LIMITED 错误。详情请参阅使用情况与限额。

情况	HTTP	`error.code`	消息
`Authorization` 标头不存在或不是 Bearer 标头	401	`UNAUTHORIZED`	`Endpoint ini memerlukan API key Hostlinku: kirim header Authorization: Bearer sk-… (atau x-api-key). …`
API密钥未知、输入有误或已被撤销	401	`UNAUTHORIZED`	`API key tidak valid atau sudah dicabut.`
API密钥已过期	401	`UNAUTHORIZED`	`API key sudah kedaluwarsa.`
API密钥用于`/api/*`控制台的端点	403	`API_KEY_NOT_ALLOWED`	`API key hanya berlaku untuk endpoint gateway /v1/* …`
API密钥已达到额度上限	402	`PAYMENT_REQUIRED`	`Limit kredit API key tercapai (…)`
账户余额不足以完成预订请求	402	`PAYMENT_REQUIRED`	`Saldo kredit tidak cukup untuk request ini.`
超出速率限制	429	`RATE_LIMITED`	`Rate limit terlampaui. …`