更新日志
2026-10-27 · 视频文档:可灵统一格式调用文档
- 新增「可灵统一格式」目录(中英同步,现有「可灵格式」内容不变):面向 15 个视频模型(
kling-* / kling-v-*),全部模型统一走 POST /v1/videos 提交、GET /kling-video/v1/videos/{task_id} 查询并直链取片
- 「模型指南」页按 8 组模型逐一给出功能说明、参数表与三语言调用示例;「提交任务」页按场景独立成节(文生 / 图生 / 首尾帧 / 多镜头分镜 / 动作控制 / 元素音色引用 / multipart 上传),目录可直接定位
- 新增「元素与音色」页:两套资产命名空间(
kling-element / kling-voice、kling-v-element / kling-v-voice)的创建 / 查询 / 删除,以及在视频生成中引用的数量与 audio 约束(ID 按系列隔离不互通)
- 关键口径:
audio 缺省静音(该模型最低价档)、按实际生成档位计费、失败任务不计费;成片直链有时效,生成后请尽快下载取用
- 端点速查表新增该格式入口,模型说明前缀表补
kling-* / kling-v-*
2026-10-21 · 图片文档:Seedream 5.0 图生图与图层拆分
- 图生图「豆包 Seedream 格式」按 5.0 系列实测更新(中英同步):实测清单加入
doubao-seedream-5-0,image 支持多张参考图(string / string[]),sequential_image_generation 标注 doubao-seedream-5-0 不支持
- 新增「Seedream 图层拆分」:
doubao-seedream-5-0-pro、doubao-seedream-5-0-flash-260915 传 layer_decomposition: true 输出底图 + 独立图层,最多 17 张,示例代码三语言
- 端点速查表「图片生成」行与能力子页列表补「Seedream 图层拆分」入口
2026-10-12 · Vega 异步文档实测修正:content_url 时效口径
- 「查询与下载」页口径实测修正(中英同步):
content_url 为带签名的临时地址,免令牌但有时效,过期后再请求返回 502——此前「长期有效、可写入数据库」的表述有误,已改为「立即下载转存、勿当长期图片链接分发」
- 补充内容端点鉴权口径:
GET /v1/tasks/{task_id}/artifacts/{key}/content 不带 ?access= 时需带令牌,artifacts[].content_url 自带 ?access= 的形式才免令牌
- 提交页错误码表新增
502 Artifact upstream authentication failed(图片地址签名过期),轮询示例注释同步加转存提醒
2026-10-12 · 图片文档拆分:Vega 异步任务接口
- 图片生成单页拆为「文生图与图生图 / 图片编辑 / Vega 格式」目录(中英同步),子页统一「端点 → 认证 → 请求体 → …」骨架,右侧大纲恢复可用
- 新增 Vega 异步任务页(新版):
POST /v1/tasks/vega 提交(文生图与图生图同端点,不传 input 即文生图)、GET /v1/tasks/{task_id} 轮询(QUEUED / IN_PROGRESS / SUCCESS / FAILURE)、/artifacts 下载;content_url 为本站免令牌直链(时效口径见上方修正条目)
- 计费口径:提交 0 预扣、完成按实际用量结算、失败不扣费;pro 图生图前 3 张参考图免费、第 4 张起每张 +10,000 tokens;耗时实测 Lite 约 19 秒、Pro 约 98 秒
- 旧版同步调用方式(文生图 Vega 系列 + 图生图 Vega 格式)保留为「旧版使用指南」:同步接口已不再支持 Vega(报
tiered expr run failed),页首标注下线并指向异步接口;端点速查表新增 Vega 异步行
2026-10-12 · 豆包视频文档实测修正
camera_fixed 从「不支持」清单移入正式参数表(中英同步):2026-10 复测 t2v 提交返回 200 正常建单、参数透传上游生效(true / false 运镜差异明显),修正此前「传了返回 400」的结论;frames / service_tier 仍为不支持
- 新增图生视频素材合规提示:i2v 的
image / images 不接受真人照片,命中火山合规检测直接 400 InputImageSensitiveContentDetected.PrivacyInformation(不建单、不计费),首帧需改用插画 / 动漫 / 产品 / 风景类图片
2026-10-09 · 音乐文档:新版异步任务接口
- 音乐章节按厂商重组(中英同步,结构同视频章节):火山引擎格式目录下分「新版(异步任务)」与「旧版(同步接口)」——新版
POST /volcengine/music/submit 提交、GET /volcengine/music/fetch/{task_id} 轮询,模型 doubao-music-bgm(纯音乐)/ doubao-music-song(歌曲),状态 queued / processing / completed / failed;旧版同步接口 /v1/audio/speech(volcengine-bgm / volcengine-song)存量可用
- 提交页沉淀 metadata 参数详解:BGM 时长
30~120 秒 / Song 30~240 秒、genre / mood / timbre 严格枚举(英文原值大小写敏感,非枚举值返回 502 并列出全部合法值)、input 词数 5~2000、传 metadata.lyrics 后 input 可省略
- 计费口径:按音频时长计费,提交时按申请时长预扣费、完成时按上游实际时长结算多退少补,失败不计费全额退回;
data.url 为带签名临时地址,需及时下载转存
- MiniMax Music chat 流式独立为「MiniMax 格式」页(同视频章节的厂商单页先例),Suno 停用说明随页保留;端点速查表音乐行改为异步提交端点
2026-09-29 · 视频文档:MiniMax-H3 调用文档与素材模式补全
- 视频章节新增「MiniMax 格式」页(中英同步):MiniMax-H3 复用通用任务端点
/v1/video/generations,支持文生 / 图生 / 视频生视频三种模式,网关已拦截该模型的 /v1/chat/completions 调用(防文本 token 误计费)
- 在线实测口径沉淀:分辨率仅
768p / 2K(缺省按 720p 校验直接报错)、文生视频必填 metadata.ratio、时长校验 4~15 秒整数(缺省 5);素材 URL 必须上游机房可达(境外图床实测 unreachable 2013),失败任务不扣费
- 查询响应补充渠道镜像字段:
data.data.output.video_url 上游 OSS 直链约 24 小时失效、result_url 为本站代理下载链;视频总览 TIP、端点速查表、状态页 NOTE 同步标注
- 通用任务页(创建视频生成任务)补全输入素材模式:首尾帧(
metadata.first_frame_url / last_frame_url)、多参考图(images 多张)、视频生视频与多参考视频(metadata.video_urls)、参考音频(metadata.audio_urls),新增模式对照表、素材格式约束与「metadata 整体透传、顶层字段静默丢弃」口径,示例补首尾帧 / 多参考图 / 视频生视频三场景(中英同步)
2026-09-28 · 可灵文档新版 / 旧版分册
- 可灵章节拆为「新版(全模型)」与「旧版(仅 v2.5-turbo)」两个目录:新版页按 TokenHub 直连插件重写——字段表(
resolution / audio / multi_shot 取代 mode 富 token)、模型 × 参数速查、可灵信封响应(含 final_unit_deduction / created_at 镜像字段)、元素音色改为 metadata.contents 引用、callback_url 隧道改为 contents / options 直通
- 新版提交页注明旧写法(
mode 档位、原生 settings 对象、metadata 隧道)无需修改可直接使用;mode: "mock" 返回 400(防真实扣费拦截)
- 新增「动作控制」页(motion-control 模型):
metadata.contents 组装(形象图 + 动作视频各恰好 1 项,prompt/element 可选)、character_orientation 必填与朝向决定参考视频时长上限、分辨率 / 音频设置、素材内容约束与实测口径(720p 档 1264×720、时长跟随参考视频)
- 旧版收敛为单页使用指南:仅保留 v2.5-turbo 实际用到的字段表与最小示例,移除该模型用不到的 ultra / 素材 token / callback_url 等内容,减少选择干扰
2026-09-23 · 视频文档重构
- 视频文档按「任务总览 + 接入格式」重组:顶层创建 / 查询总览页(带 POST / GET 方法徽标),豆包 / 可灵 / 即梦 / Sora 四个格式目录按「提交任务 / 查询与下载」拆子页,替换原单页
video.mdx
- 子页统一「端点 → 请求体 → 请求示例 → 响应体 → 响应示例」骨架,右侧内容目录恢复可用;示例统一 cURL / Python / Node.js 三语言,豆包补文生 / 图生双示例
- 豆包(Seedance)实测校准:时长用
seconds、画幅与分辨率走 metadata、顶层字段静默丢弃清单;沉淀「模型 × 模式」参数支持矩阵(mini i2v 固定 720p、不支持 resolution 等)
- 侧边栏:格式目录默认折叠;接口方法徽标 GET 绿色 / POST 蓝色(
theme/index.tsx Tag 覆盖)
- 可灵 / 即梦 / Sora 查询页补统一任务 JSON 响应体与响应示例;端点速查表视频行改为
/v1/video/generations
2026-09-21 · 音频文档重构
- 音频文档按能力拆分为 TTS / 音乐 / STT 三个独立页面,替换原单页
audio.mdx
- 接入 MiniMax Music chat 流式接口:
images 参数直通、Suno 格式标注为已停用保留
- 视频文档补元素 / 音色管理表格与示例(中英同步)
2026-09-16 · 视频与音频实测校准
- 可灵:分辨率改由
mode 决定(std 720P / pro 1080P),补 native / nomulti 开关与 v2.6 native 强制 1080p 说明
- 可灵:素材 URL 限制改为实测口径(腾讯云直链、失败站点与推荐顺序)、图生视频补图片约束(jpg/png、≤50MB、宽高≥300px)
- 可灵:
wm 默认无水印说明、元素音色 mode 引用规则表、callback_url 示例重写并补 Python / Node.js 版本
- 视频:result_url 补 1 小时时效(后撤回该表述,中英对齐)、任务状态补 NOT_START、o1 duration 区分纯文生、编辑视频拉取失败计费警示
- MiniMax Speech 实测限制更新:顶层
response_format 报 500、恒定 128k 单声道、tone 仅斜杠式、latex_read 须 $$ 包裹、发音字典不可靠改内联写法
2026-09-08 · API 调用文档拆分与多模态补充
- 「API 调用」页拆分为总览 + 文本 / 图片 / 音频 / 视频 / 多模态 / 客户端 六个能力子页
- 多模态文档支持视频理解,补传参方式与
reasoning_effort 等模型参数差异
- 图生图按厂商拆分传参格式,补 Vega 格式与 size 差异
- 视频通用调用流程拆分文生 / 图生,补 size 画幅说明
- 计费与鉴权补充:动态计费说明修订、鉴权示例补 Node.js 版本
2026-09-01 · 文档导航重构
- 删除「快速开始」模块:首页两个 hero 按钮与 quickstart 目录移除,相关跳转改为产品内入口
- 产品路由扁平化:
/products/api-model/... → /tokenhub/...,首页仅通过四个产品卡片进入对应文档
- 每个产品页面只显示本产品的侧边栏目录,不再展示其他产品
- 顶部导航「产品文档」改为四产品下拉菜单
- 常见问题、更新日志页面隐藏侧边栏(单页无需目录导航)
2026-08-21 · 文档网站初始化
- API 模型服务模块全部文档:产品介绍、快速开始、API Key 管理、充值与计费、接入地址与鉴权、能力调用(文本 / 音频 / 图片)、错误码对照、模型说明(模型分类 / 计费 / 命名 / 选型)、客户端接入(Cherry Studio / Claude Code / Codex / 其他 / CC Switch)
- 顶级常见问题四个分类:账号 / API / 模型 / 客户端
- YUAN、STMind、算力调度平台占位页