// API REFERENCE · V1

AgentHub AI API

OpenAI 兼容的统一 AI Gateway。使用一个 API Key 调用平台支持的模型，并由账户余额按实际用量结算。

01

身份验证

在控制台创建 API Key，然后通过 Bearer Token 发送。完整 Key 仅在创建时显示一次。

Authorization: Bearer ah_live_xxxxxxxxxxxx
02

创建对话响应

POST/v1/chat/completions
curl https://agenthub-ai-launch.ye-poke.chatgpt.site/v1/chat/completions \
  -H "Authorization: Bearer $AGENTHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": false
  }'
计费流程验证 Key → 检查余额与 Key 限额 → 预留额度 → 调用模型 → 读取 Token 用量 → 结算并写入消费记录。
03

获取模型列表

GET/v1/models

返回当前可调用模型。被管理员暂停的模型会在调用时返回 503。

04

计费与错误

401API Key 无效或已撤销
402账户余额不足
429API Key 月度限额已用完
503模型或上游服务暂不可用

成功响应包含 x-agenthub-request-id 与 x-agenthub-cost-micros，方便审计单次调用。