概览

一套协议接入多类 AI 能力

TokenMarket 对外提供统一 API 合同，让团队使用同一套鉴权方式、同一 Base URL 和统一响应风格来调用不同模型能力。

兼容 OpenAI 风格的 JSON 请求与响应

一套 API Key 覆盖 chat、embeddings、images、audio、rerank 和 video

统一计费、配额校验与请求追踪头

鉴权

鉴权与 Base URL

所有请求都使用 Bearer Token。请直接使用下方 TokenMarket 对外正式 Base URL。

Base URL

https://cloud.hopegate.ai/api

必需请求头

Authorization: Bearer YOUR_TOKENMARKET_API_KEY
Content-Type: application/json

先在 TokenMarket 控制台创建 API Key，再通过 Authorization 请求头发送。

快速开始

验证接入是否成功的最快方式，是先发送一个最小 chat 请求。

curl -X POST "https://cloud.hopegate.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_TOKENMARKET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "DeepSeek-V4-pro",
    "provider": "dataeyes",
    "messages": [
      { "role": "user", "content": "Reply with only OK." }
    ],
    "stream": false
  }'

核心端点

当前支持的统一端点

下面这些端点已经纳入当前对外统一 API 面。

路径	用途	说明
/v1/chat/completions	聊天补全与推理输出	支持标准 OpenAI 风格 messages，并可选指定 provider。
/v1/embeddings	文本嵌入	按上游响应格式返回 embedding 向量。
/v1/images/generations	文生图	当上游模型支持时，可使用 response_format、size、quality 和 n 等参数。
/v1/audio/speech	文本转语音	返回二进制音频，同时附带 TokenMarket 请求和计费响应头。
/v1/rerank	文档重排序	是否可用取决于你的上游账号是否开通了对应模型。
/v1/video/generations	视频生成任务创建	通常返回上游异步任务信息。

代码示例

所有示例都使用相同的 API Key 模式。运行前只需要替换 YOUR_TOKENMARKET_API_KEY。

聊天补全

cURL

curl -X POST "https://cloud.hopegate.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_TOKENMARKET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "DeepSeek-V4-pro",
    "provider": "dataeyes",
    "messages": [
      { "role": "user", "content": "Reply with only OK." }
    ],
    "stream": false
  }'

嵌入

cURL

curl -X POST "https://cloud.hopegate.ai/api/v1/embeddings" \
  -H "Authorization: Bearer YOUR_TOKENMARKET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-large",
    "provider": "dataeyes",
    "input": "TokenMarket unified API integration"
  }'

图像生成

cURL

curl -X POST "https://cloud.hopegate.ai/api/v1/images/generations" \
  -H "Authorization: Bearer YOUR_TOKENMARKET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "provider": "dataeyes",
    "prompt": "A minimal geometric fox icon on white background",
    "response_format": "url",
    "size": "1024x1024"
  }'

文本转语音

cURL

curl -X POST "https://cloud.hopegate.ai/api/v1/audio/speech" \
  -H "Authorization: Bearer YOUR_TOKENMARKET_API_KEY" \
  -H "Content-Type: application/json" \
  -o speech.mp3 \
  -d '{
    "model": "gpt-4o-mini-tts",
    "provider": "dataeyes",
    "input": "Hello from TokenMarket",
    "voice": "alloy",
    "format": "mp3"
  }'

重排序

cURL

curl -X POST "https://cloud.hopegate.ai/api/v1/rerank" \
  -H "Authorization: Bearer YOUR_TOKENMARKET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-rerank",
    "provider": "dataeyes",
    "query": "Which document is about TypeScript?",
    "documents": ["TypeScript guide", "Baking bread tutorial", "Marathon training"],
    "top_n": 2
  }'

视频生成

cURL

curl -X POST "https://cloud.hopegate.ai/api/v1/video/generations" \
  -H "Authorization: Bearer YOUR_TOKENMARKET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v1",
    "provider": "dataeyes",
    "prompt": "A paper plane flying over a lake at sunrise",
    "size": "1280x720"
  }'

错误处理

TokenMarket 会把平台错误和上游错误归一成一致的错误结构。

类型	代码	含义
invalid_request_body	REQUEST_001	请求体校验失败。
unauthorized	AUTH_001	API Key 缺失、无效或已被禁用。
provider_error	PROVIDER_001	上游供应商拒绝了请求，或所选模型当前不可用。
timeout	PROVIDER_TIMEOUT	上游操作在完成前超时。

常见问题

如何切换中英文？

使用页面头部的语言切换器即可。页面会保留当前文档路径，只在英文和中文之间切换。

不同模型类别要接不同 API 吗？

不需要。TokenMarket 会按操作类型区分统一端点，但它们共享相同的鉴权方式和 Base URL。

如何指定 provider？

如果你想强制走某个上游，可在请求体里添加可选的 provider 字段；如果不传，TokenMarket 会使用自己的路由策略或模型默认 provider。

为什么会返回 PROVIDER_001？

这表示请求已经到达上游供应商，但在上游侧失败了，例如模型未开通、上游报错，或者传输过程中被中断。