TokenMarket

TM

AI Token的统一接口

用一个入口统一接入模型调用、价格对比、路由治理与 Token 结算。

多模型目录可解释路由统一计费
登录
语言
EN中文

概览

一套协议接入多类 AI 能力

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

兼容 OpenAI 风格的 JSON 请求与响应
一套 API Key 覆盖 chat、responses、embeddings、images、audio、rerank 和 video
统一计费、配额校验、流式事件和请求追踪头

最新能力更新

当前文档已同步最新公开能力：chat/completions 支持 text 与 image_url 组合的多模态输入，/v1/responses 支持原生 Responses 风格的 input_text 与 input_image 内容 part，并已开放非流式与 SSE 流式返回，推荐正式 Base URL 为 https://cloud.hopegate.ai/api。

鉴权

鉴权与 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",
    "messages": [
      { "role": "user", "content": "Reply with only OK." }
    ],
    "stream": false
  }'

核心端点

当前支持的统一端点

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

路径用途说明
/v1/chat/completions聊天补全与推理输出支持标准 OpenAI 风格 messages，并支持 text 与 image_url 组成的 content parts。
/v1/responsesResponses 风格统一响应接口支持非流式 JSON 返回与 SSE 流式事件；当 input 为消息数组时，请使用原生 Responses content part：文本为 input_text，图片为 input_image，而不是 chat 接口里的 text 与 image_url。
/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",
    "messages": [
      { "role": "user", "content": "Reply with only OK." }
    ],
    "stream": false
  }'

多模态聊天补全

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": "gpt-5.4",
    "messages": [
      {
        "role": "user",
        "content": [
          { "type": "text", "text": "Describe the image in one sentence." },
          {
            "type": "image_url",
            "image_url": { "url": "https://example.com/cat.png" }
          }
        ]
      }
    ],
    "stream": false
  }'

Responses 接口与流式输出

cURL

curl -N -X POST "https://cloud.hopegate.ai/api/v1/responses"   -H "Authorization: Bearer YOUR_TOKENMARKET_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "gpt-5.4",
    "input": [
      {
        "role": "user",
        "content": [
          { "type": "input_text", "text": "Describe this image in one sentence." },
          {
            "type": "input_image",
            "image_url": "https://example.com/cat.png"
          }
        ]
      }
    ],
    "stream": false
  }'

Responses 接口与 data URL 图片

cURL

curl -X POST "https://cloud.hopegate.ai/api/v1/responses"   -H "Authorization: Bearer YOUR_TOKENMARKET_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "gpt-5.4",
    "input": [
      {
        "role": "user",
        "content": [
          { "type": "input_text", "text": "Describe this image in one short sentence." },
          {
            "type": "input_image",
            "image_url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+a9d0AAAAASUVORK5CYII="
          }
        ]
      }
    ],
    "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"
  }'

流式事件

Responses SSE 事件格式

当 /v1/responses 使用 stream=true 时，TokenMarket 会按 SSE 顺序返回事件。建议消费 response.output_text.delta 做增量渲染，消费 response.completed 做最终收口。

response.created 表示本次响应对象已经建立，状态通常为 in_progress。
response.output_text.delta 适合直接拼接到前端文本缓冲区。
usage.summary 会在流中给出当前计费与 token 汇总，最后以 data: [DONE] 结束。

SSE 事件序列示例

event: response.created
data: {"type":"response.created","response":{"id":"resp_123","object":"response","created":1780468890,"model":"gpt-5.4","status":"in_progress"}}

event: response.output_item.added
data: {"type":"response.output_item.added","output_index":0,"item":{"type":"message","id":"msg_resp_123","status":"in_progress","role":"assistant","content":[]}}

event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_resp_123","output_index":0,"content_index":0,"delta":"Hello"}

event: usage.summary
data: {"prompt_tokens":24,"completion_tokens":12,"total_tokens":36,"charged_amount":0.00052}

event: response.output_item.done
data: {"type":"response.output_item.done","output_index":0,"item":{"type":"message","id":"msg_resp_123","status":"completed","role":"assistant","content":[{"type":"output_text","text":"Hello","annotations":[]}]}}

event: response.completed
data: {"type":"response.completed","response":{"id":"resp_123","object":"response","created":1780468890,"status":"completed","output_text":"Hello","output":[{"type":"message","id":"msg_resp_123","status":"completed","role":"assistant","content":[{"type":"output_text","text":"Hello","annotations":[]}]}],"model":"gpt-5.4","usage":{"input_tokens":24,"output_tokens":12,"total_tokens":36,"charged_amount":0.00052}}}

data: [DONE]

不同上游模型的文本分片粒度可能不同，但事件顺序与外层字段语义会保持一致。

错误处理

错误处理

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

类型代码含义
invalid_request_bodyREQUEST_001请求体校验失败。
unauthorizedAUTH_001API Key 缺失、无效或已被禁用。
provider_errorPROVIDER_001上游服务拒绝了请求，或所选模型当前不可用。
timeoutPROVIDER_TIMEOUT上游操作在完成前超时。

常见问题

常见问题

如何切换中英文？

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

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

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

为什么会返回 PROVIDER_001？

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

什么时候用 /v1/responses？

当你希望使用 OpenAI Responses 风格输入，或者直接消费 SSE 事件流时，优先使用 /v1/responses；如果你已有 chat/completions SDK，也可以继续走 /v1/chat/completions。

什么时候优先从 /v1/chat/completions 开始？

当你只需要最小接入成本时，优先从 /v1/chat/completions 开始；如果你需要原生 Responses 风格输入或事件流，再使用 /v1/responses。