XH XPKHub 技术文档

Developer Documentation

XPKHub 技术文档

使用 api.xpkhub.com 的租户 API Key 调用 LLM、图片生成和视频生成服务。后台管理员入口不会在公开文档中展示。

Recommended Flow 注册账号 → 激活租户 → 创建 API Key → 调用模型 所有请求都可以在租户后台查看轨迹、余额和任务结果。

快速开始

登录租户后台后，在 API 密钥页面创建 Key，再选择已开放的模型别名发起调用。

建议先用 chat-default 完成首调用。 如果需要代码、图片或视频能力，再到租户后台的模型价格页选择对应别名。 
curl https://api.xpkhub.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chat-default",
    "messages": [
      {"role": "user", "content": "请用一句话介绍 XPKHub"}
    ]
  }'
进入租户后台 注册试用账号

API Surface

常用接口

LLM

POST /v1/chat/completions

OpenAI Chat Completions 兼容入口，适合大多数对话、文本生成和工具链适配场景。

LLM

POST /v1/responses

Responses 风格入口，用于需要更现代响应结构的应用接入。

Claude

POST /v1/messages

Anthropic Messages 兼容入口，便于接入偏 Claude 协议的客户端。

Image

POST /v1/images/generations

图片生成统一入口，按租户权限、模型价格和任务结果进行管理。

Video

POST /v1/video/generations

视频生成统一入口，支持文本、图片参考和任务化查询。

Task

GET /v1/generation-tasks/{id}

查询图片或视频生成任务状态、资产地址和失败原因。

租户接入流程

  1. 注册或登录租户账号。
  2. 完成券码激活、充值或运营审核。
  3. 在租户后台创建 API Key。
  4. 选择模型别名，按文档发起调用。
  5. 在请求轨迹、额度与任务页面查看调用结果。

如果接口返回余额、权限、模型访问或模型服务失败相关错误，请先到租户后台查看请求轨迹，再联系运营支持。