Tokenhub API Reference
Base URL: https://tokenhub-intl.tencentcloudmaas.com认证: Tokenhub API Key / Bearer
这里是图片与视频生成所需的认证、请求方式、结果处理规格。各模型的参数与示例请在下方的模型文档中查看。
调用规格
API 密钥与认证
在 Tokenhub 控制台的 API Key Management 中签发密钥。所有生成与查询请求都在 Authorization 请求头中传入同一个密钥。
Authorization: Bearer $TOKENHUB_API_KEY
Content-Type: application/jsonAPI 密钥请用服务端环境变量管理。JSON 正文中只传入各模型文档所定义的字段。
端点与地域
所有示例均使用国际网关 tokenhub-intl.tencentcloudmaas.com。URL 路径会随生成方式不同而变化,请使用各模型文档中的路径。不要额外传入 Region 参数。
参考文件示例存放在 Singapore COS(ap-singapore)。结果文件从 API 响应返回的 URL 下载。
API 列表与请求参数
各模型的生成与查询 API 及输入字段,请参考下方引擎目录中的文档。不同引擎的任务 ID 与结果字段可能不同。
响应与执行流程
同步请求
Hy Image 与 Seedream Image 在生成请求的响应中直接返回结果。响应字段与图片传递格式遵循各模型的响应规格。
异步任务
- 发送生成请求并保存返回的任务 ID。
- 通过该模型的查询路径确认状态。
- 在完成状态下读取结果 URL 并下载文件。
任务 ID 字段与完成状态因模型而异。处理查询响应时,请区分下列取值。
| 模型 | 生成响应中的任务 ID | 查询响应中的成功状态 |
|---|---|---|
| WAND-Vega-Image | task_id | status=completed |
| WAND-Vega-Video | id | status=succeeded |
| Vidu Image | task_id | state=success |
| PixVerse Video | Resp.video_id | Resp.status=1 |
| Kling Video | data.id | data.status=succeeded |
| MiniMax Video | task_id | task.status=succeeded |
| Hy Video | task_id | status=succeeded |
轮询间隔与失败状态遵循各模型的查询规格。生成请求被受理后,不要重复提交同一请求,而应用任务 ID 查询结果。
错误与调用限制
错误处理
| HTTP 状态 | 确认项 |
|---|---|
400 | 模型 ID、必填字段、参数格式与输入限制 |
401 | API 密钥是否有效以及 Authorization: Bearer 请求头 |
429 | 调用频率与使用额度 |
5xx | 服务错误。若已拿到异步任务 ID,请先查询任务状态 |
错误响应中的请求标识与错误码可用于定位问题。各模型的错误结构请参考相应文档的错误码章节。
请求示例
请使用要调用的模型或协议对应的请求示例。不要把不同路径的认证方式与请求字段混在一个请求里。请同时查看下方的引擎文档与各协议的参数。
结果与资源管理
参考文件与结果保存
参考 URL 必须可被 API 服务端访问。文件格式、大小、数量以及视频时长限制遵循各模型的输入条件。带签名的结果 URL 请在有效期内下载并保存。
引擎目录与相关文档
Image
| 模型 | 模型 ID | 调用方式 |
|---|---|---|
| Hy | hy-image-v3.5-preview / hy-image-v3 | 同步 |
| WAND-Vega-Image | wand-vega-image-pro / wand-vega-image-flash / wand-vega-image-lite | 异步 |
| Vidu | vidu-image-q2 | 异步 |
| Seedream | seedream-image-v5.0-pro / seedream-image-v5.0-lite | 同步 |
Video
| 模型 | 模型 ID | 调用方式 |
|---|---|---|
| WAND-Vega-Video | wand-vega-video-1.5-pro / wand-vega-video-1.0-pro / wand-vega-video-1.0-lite | 异步 |
| PixVerse | pixverse-video-v6.0 / pixverse-video-c1 | 异步 |
| Kling | kling-video-v3 / kling-video-v3-omni / kling-video-v3-turbo | 异步 |
| MiniMax | minimax-video-h3 / minimax-video-h3-max | 异步 |
| Hy | hy-video-v1.5 | 异步 |
价格与官方指南
| 分类 | 官方指南 |
|---|---|
| Image | 概述 / Vega / Hy / Vidu / Seedream |
| Video | 概述 / PixVerse / Kling / MiniMax / Hy |