接入文档

本站提供完全兼容 OpenAI 协议的中转接口，覆盖 文本对话、图像生成、视频生成、音乐生成、语音合成与识别、实时语音 全部模态。 你只需要把 base_url 换成本站地址、把 api_key 换成本站生成的令牌，其余代码不用改动。

一句话改动： base_url = https://api.hkgapi.xyz/v1（注意结尾是 /v1，不要多加斜杠）

快速开始

curl https://api.hkgapi.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}],
    "stream": true
  }'

鉴权

所有接口通过 HTTP 请求头携带令牌完成鉴权，两种写法等价：

Authorization: Bearer sk-xxxxxxxxxxxxxxxx
# 或者
Authorization: sk-xxxxxxxxxxxxxxxx
安全提醒：令牌等同于余额，请勿写进前端代码、公开仓库或截图。 建议为每个应用单独创建一个令牌，异常时单独吊销即可。

获取令牌

登录控制台 → 左侧「令牌」→「添加令牌」→ 复制以 sk- 开头的字符串。

创建时可以限制该令牌的可用模型、额度上限与过期时间，便于分发给不同项目或团队成员。

对话补全

POST/v1/chat/completions
{
  "model": "gpt-4o-mini",
  "messages": [
    {"role": "system", "content": "你是一个简洁的助手"},
    {"role": "user",   "content": "北京有哪些景点？"}
  ],
  "temperature": 0.7,
  "max_tokens": 1024,
  "stream": true
}

stream: true 时返回 Server-Sent Events，逐块返回增量内容，适合对话类应用。

文本向量

POST/v1/embeddings
{
  "model": "text-embedding-3-small",
  "input": ["要向量化的文本", "第二条文本"]
}

图像生成

POST/v1/images/generations
{
  "model": "gpt-image-1",
  "prompt": "一只戴着宇航头盔的柯基，赛博朋克风格",
  "size": "1024x1024",
  "n": 1
}
图像 / 视频类接口单次响应体积可达数 MB，并发高时非常吃带宽。 如果你的业务以出图为主，请联系我们单独评估带宽与计费方式。

图像编辑 / 改图（图生图）

POST/v1/images/edits

上传参考图进行局部重绘或风格迁移。走 multipart 表单，不是 JSON——这是最常写错的一处：

curl https://api.hkgapi.xyz/v1/images/edits \
  -H "Authorization: Bearer sk-你的令牌" \
  -F image=@input.png \
  -F model=gpt-image-1 \
  -F prompt="把背景换成雪山"

视频生成

视频生成耗时以分钟计，因此统一采用 异步任务 模式： ① 提交任务拿到 task_id → ② 轮询查询接口 → ③ 状态成功时响应里带回视频下载地址。

可灵 Kling · 文生视频

POST/kling/v1/videos/text2video
curl https://api.hkgapi.xyz/kling/v1/videos/text2video \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-v1",
    "prompt": "镜头缓慢推近，一只猫在窗台看雨",
    "duration": "5"
  }'

查询任务结果

GET/kling/v1/videos/text2video/{task_id}
curl https://api.hkgapi.xyz/kling/v1/videos/text2video/{task_id} \
  -H "Authorization: Bearer sk-你的令牌"

其他视频入口：图生视频 /kling/v1/videos/image2video、即梦 /jimeng/、统一入口 /v1/video/generations。

音乐生成

同样为异步任务模式（Suno）。

POST/suno/submit/{action}
curl https://api.hkgapi.xyz/suno/submit/music \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "轻快的城市民谣，木吉他，中文男声",
    "mv": "chirp-v3-5",
    "make_instrumental": false
  }'
GET/suno/fetch/{task_id}

轮询该地址，成功时响应里返回音频文件地址。任务列表用 POST /suno/fetch。

语音合成 / 识别

语音合成（TTS）

POST/v1/audio/speech
curl https://api.hkgapi.xyz/v1/audio/speech \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"tts-1","voice":"alloy","input":"你好，这是一段测试语音。"}' \
  --output speech.mp3

语音识别（ASR）

POST/v1/audio/transcriptions
curl https://api.hkgapi.xyz/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-你的令牌" \
  -F file=@audio.mp3 \
  -F model=whisper-1
上传体积提醒：音频文件单次上限取决于你的套餐，官方 OpenAI 语音转写为 25MB。 超限会返回 413，请先压缩或分段上传。

另有 /v1/audio/translations（语音转译为英文）。

实时语音

WS/v1/realtime

走 WebSocket（wss://）而非 HTTP，适合边说边听的低延迟场景：语音助手、实时字幕、语音 Agent。 注意本项目 api 子域是 DNS 直连（灰云），不经 CDN——长连接经过 CDN 会随机断开。 

const ws = new WebSocket(
  'wss://api.hkgapi.xyz/v1/realtime?model=gpt-4o-realtime-preview',
  ['realtime', 'openai-insecure-api-key.sk-你的令牌']
);

端点总表

模态端点返回方式计费
文本对话/v1/chat/completions流式 SSE按 Token
Claude / Gemini/v1/messages、/v1beta/models/*流式 SSE按 Token
向量 / 重排/v1/embeddings、/v1/rerank同步按 Token
图像/v1/images/generations、/v1/images/edits、/mj/*同步 / 任务按次
视频/v1/video/generations、/kling/v1/videos/*、/jimeng/*异步任务按次
音乐/suno/submit/* + /suno/fetch异步任务按次
语音合成/v1/audio/speech同步按次 / 按量
语音识别/v1/audio/transcriptions、/v1/audio/translations同步按次 / 按量
实时语音/v1/realtimeWebSocket按时长 / 按量

具体可用模型以 /v1/models 返回为准；页面上方的商城价格页可按模态筛选查看。

模型列表

GET/v1/models

返回当前账号可用的全部模型 ID。价格与倍率可访问 /api/pricing 获取（无需鉴权）。

错误码

HTTP含义处理建议
401令牌无效 / 已吊销检查 Authorization 头与令牌状态
402余额不足前往控制台充值
403该令牌无权调用此模型调整令牌的可用模型范围
404模型不存在用 /v1/models 确认模型 ID
429触发限流降低并发，或加指数退避重试
500 / 502上游通道异常系统会自动尝试其他通道；持续失败请联系客服

限流与配额

维度说明
并发按分组配置，默认单账号可同时进行数十路流式请求
QPS按分组配置每分钟 / 每小时请求上限，超限返回 429
模型范围可在令牌级别限制可调用的模型
额度上限可为单个令牌设置消费上限，用尽后自动失效

客户端配置

ChatGPT-Next / NextChat

接口地址：https://api.hkgapi.xyz
API Key：sk-你的令牌
自定义模型：从价格表复制模型名填入

Cherry Studio / LobeChat 等

在「模型服务」中新增一个 OpenAI 兼容提供方，API 地址填 https://api.hkgapi.xyz/v1。

Python（openai SDK ≥ 1.0）

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://api.hkgapi.xyz/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的令牌",
  baseURL: "https://api.hkgapi.xyz/v1",
});

const r = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);

文档中的域名 api.hkgapi.xyz 为示例，请替换为你实际部署的域名。