跳到内容

Tokenhub API Reference ​

更新时间

Base URL: https://tokenhub-intl.tencentcloudmaas.com认证: Tokenhub API Key / Bearer

这里是图片与视频生成所需的认证、请求方式、结果处理规格。各模型的参数与示例请在下方的模型文档中查看。

调用规格 ​

API 密钥与认证 ​

在 Tokenhub 控制台的 API Key Management 中签发密钥。所有生成与查询请求都在 Authorization 请求头中传入同一个密钥。

http
Authorization: Bearer $TOKENHUB_API_KEY
Content-Type: application/json

API 密钥请用服务端环境变量管理。JSON 正文中只传入各模型文档所定义的字段。

端点与地域 ​

所有示例均使用国际网关 tokenhub-intl.tencentcloudmaas.com。URL 路径会随生成方式不同而变化,请使用各模型文档中的路径。不要额外传入 Region 参数。

参考文件示例存放在 Singapore COS(ap-singapore)。结果文件从 API 响应返回的 URL 下载。

API 列表与请求参数 ​

各模型的生成与查询 API 及输入字段,请参考下方引擎目录中的文档。不同引擎的任务 ID 与结果字段可能不同。

响应与执行流程 ​

同步请求 ​

Hy Image 与 Seedream Image 在生成请求的响应中直接返回结果。响应字段与图片传递格式遵循各模型的响应规格。

异步任务 ​

  1. 发送生成请求并保存返回的任务 ID。
  2. 通过该模型的查询路径确认状态。
  3. 在完成状态下读取结果 URL 并下载文件。

任务 ID 字段与完成状态因模型而异。处理查询响应时,请区分下列取值。

模型生成响应中的任务 ID查询响应中的成功状态
WAND-Vega-Imagetask_idstatus=completed
WAND-Vega-Videoidstatus=succeeded
Vidu Imagetask_idstate=success
PixVerse VideoResp.video_idResp.status=1
Kling Videodata.iddata.status=succeeded
MiniMax Videotask_idtask.status=succeeded
Hy Videotask_idstatus=succeeded

轮询间隔与失败状态遵循各模型的查询规格。生成请求被受理后,不要重复提交同一请求,而应用任务 ID 查询结果。

错误与调用限制 ​

错误处理 ​

HTTP 状态确认项
400模型 ID、必填字段、参数格式与输入限制
401API 密钥是否有效以及 Authorization: Bearer 请求头
429调用频率与使用额度
5xx服务错误。若已拿到异步任务 ID,请先查询任务状态

错误响应中的请求标识与错误码可用于定位问题。各模型的错误结构请参考相应文档的错误码章节。

请求示例 ​

请使用要调用的模型或协议对应的请求示例。不要把不同路径的认证方式与请求字段混在一个请求里。请同时查看下方的引擎文档与各协议的参数。

结果与资源管理 ​

参考文件与结果保存 ​

参考 URL 必须可被 API 服务端访问。文件格式、大小、数量以及视频时长限制遵循各模型的输入条件。带签名的结果 URL 请在有效期内下载并保存。

示例文件URL
参考图片https://mpstestmodel-1315536146.cos.ap-singapore.myqcloud.com/justin/wiki-examples/reference-cup.png
参考视频https://mpstestmodel-1315536146.cos.ap-singapore.myqcloud.com/justin/wiki-examples/vega-pro-example.mp4

引擎目录与相关文档 ​

Image ​

模型模型 ID调用方式
Hyhy-image-v3.5-preview / hy-image-v3同步
WAND-Vega-Imagewand-vega-image-pro / wand-vega-image-flash / wand-vega-image-lite异步
Viduvidu-image-q2异步
Seedreamseedream-image-v5.0-pro / seedream-image-v5.0-lite同步

Video ​

模型模型 ID调用方式
WAND-Vega-Videowand-vega-video-1.5-pro / wand-vega-video-1.0-pro / wand-vega-video-1.0-lite异步
PixVersepixverse-video-v6.0 / pixverse-video-c1异步
Klingkling-video-v3 / kling-video-v3-omni / kling-video-v3-turbo异步
MiniMaxminimax-video-h3 / minimax-video-h3-max异步
Hyhy-video-v1.5异步

价格与官方指南 ​

Tokenhub 模型价格 / API 错误码

分类官方指南
Image概述 / Vega / Hy / Vidu / Seedream
Video概述 / PixVerse / Kling / MiniMax / Hy

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages