API 参考

接口规范

TokenHub 完全兼容 OpenAI API 规范，所有路径与 OpenAI 一致，仅 Base URL 替换为 TokenHub。

项目	值
Base URL	https://hubwave.ai/v1
认证方式	Authorization: Bearer sk-xxxxx
内容类型	application/json

Chat Completions

POST /v1/chat/completions

请求参数

参数	类型	必填	说明
model	string	✅	模型名，如 gpt-4o
messages	array	✅	对话消息列表
stream	boolean	❌	是否流式返回
temperature	number	❌	0~2，默认 1
max_tokens	integer	❌	最大输出 token 数
tools	array	❌	Function Calling 工具列表

示例

curl https://hubwave.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": true
  }'

Embeddings

POST /v1/embeddings

curl https://hubwave.ai/v1/embeddings \
  -H "Authorization: Bearer sk-xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "Hello world"
  }'

Images

POST /v1/images/generations

curl https://hubwave.ai/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A futuristic city",
    "size": "1024x1024"
  }'

Audio

• POST /v1/audio/transcriptions - 语音转文字
• POST /v1/audio/speech - 文字转语音

错误码

状态码	含义
401	API Key 无效或额度不足
429	触发限流，请稍后重试
500	上游错误，已自动重试
503	渠道不可用