GETTING STARTED
约 3 分钟快速开始与 API 鉴权
欢迎使用统一 API 网关。使用下方 Base URL 与 API 密钥即可调用模型。
基础调用地址
基础调用地址 (Base URL)
统一的 API 基准请求地址为:
https://tokenra.io/
API 密钥鉴权
安全鉴权方式
网关在所有 API 接口中均提供了严格的权限检查,您可以通过以下任一方式在请求中附带您的「API 密钥 (Token)」:
标准 Authorization 请求头
推荐在 HTTP 请求头部中,添加标准 Bearer 令牌:
Authorization: Bearer sk-your_token_string_here
Google 协议兼容请求头
若您的客户端程序采用 Google 原生协议,可使用官方的 API Key 请求头:
X-Goog-Api-Key: sk-your_token_string_here
URL 参数透传
在部分仅支持 GET/POST 简单请求或受限的环境下,您也可以直接将密钥附在 URL 查询参数中:
https://tokenra.io/v1/chat/completions?key=sk-your_token_string_here
VIDEO API
Mini · Fast · ProSeedance 2.0 视频生成接口文档(Mini、Fast、Pro)
通过 OpenAI 兼容接口调用:支持文生视频、图生视频,以及图片/视频/音频多模态参考。
POST / VIDEO GENERATIONS
提交视频生成任务
POST
https://tokenra.io/v1/video/generations
Authorization: Bearer sk-your_token
A. 经典文生视频
curl -X POST https://tokenra.io/v1/video/generations \
-H "Authorization: Bearer sk-your_token_here" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-fast",
"prompt": "一只穿着红大衣的可爱小猫,在漫天大雪中好奇地伸爪抓雪花,写实电影画质,微距镜头",
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"generate_audio": true
}'
B. 单图/首尾帧图生视频
传入 1 张图为首帧;传入 2 张图时,第一张为首帧、第二张为尾帧。
curl -X POST https://tokenra.io/v1/video/generations \
-H "Authorization: Bearer sk-your_token_here" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-fast",
"prompt": "画面由第一张图片的森林日出平滑过渡到第二张图片的雷雨大作场景,大风吹拂树木",
"images": [
"https://example.com/forest_sunny.png",
"https://example.com/forest_storm.png"
],
"resolution": "720p",
"ratio": "16:9",
"duration": 5
}'
C. 多图外观/主体参考生视频(不含视频参考)
多张外观参考时,使用带
role(或等价
type)的对象数组,取值为
"reference_image"。
curl -X POST https://tokenra.io/v1/video/generations \
-H "Authorization: Bearer sk-your_token_here" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-fast",
"prompt": "参考图一中角色的发型与服饰、图二中的脸部轮廓以及图三中的背景,生成一段主角在木屋前缓缓走动的视频",
"images": [
{
"url": "https://example.com/clothes_ref.png",
"role": "reference_image"
},
{
"url": "https://example.com/face_ref.png",
"role": "reference_image"
},
{
"url": "https://example.com/room_ref.png",
"role": "reference_image"
}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 5
}'
D. 图像参考 + 视频参考多模态混合生成
火山 Seedance 支持“图像参考(控制主体外观)+
视频参考(控制镜头/运动轨迹)”混合生成。若请求中同时包含
videos,所有
images
均会被自动识别为外观参考。
curl -X POST https://tokenra.io/v1/video/generations \
-H "Authorization: Bearer sk-your_token_here" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-fast",
"prompt": "让第一张图中的柴犬,完美复刻视频二中狗奔跑的轨迹与镜头摇移,动作写实连贯",
"images": [
{
"url": "https://example.com/my_shiba_inu.png",
"role": "reference_image"
}
],
"videos": [
"https://example.com/running_action_reference.mp4"
],
"resolution": "720p",
"ratio": "16:9",
"duration": 5
}'
GET / TASK STATUS
轮询获取任务结果
/v1/video/generations/{task_id}
curl -X GET https://tokenra.io/v1/video/generations/video_task_abc123 \
-H "Authorization: Bearer sk-your_token_here"
PARAMETERS
完整参数字典说明
| OpenAI 兼容参数名 | 类型 | 必填 | 默认值 | 描述与限制 |
|---|---|---|---|---|
model |
string | ✅ | - |
目标视频生成模型名,传入
doubao-seedance-2-0 等
|
prompt |
string | ✅ | - | 视频生成画面与动作描述提示词,对中文理解极佳 |
images / image_urls |
array | ❌ | - |
图片参考数组。智能模式下:1张为首帧,2张为首尾帧。支持使用对象形式指定
role 或其等价字段 type(如
"first_frame"、"last_frame"、"reference_image")
|
videos |
array | ❌ | - | 视频参考链接数组,用于控制视频生成的运动、背景或场景 |
audios |
array | ❌ | - | 音频参考链接数组,实现视频声画融合 |
resolution |
string | ❌ | "720p" |
目标视频清晰度,可选 "720p"、"1080p"
|
ratio |
string | ❌ | "16:9" |
目标画幅比例,可选
"16:9"、"9:16"、"4:3"、"3:4"、"1:1"
|
duration |
integer | ❌ | 5 |
视频时长(秒) |
camera_fixed |
boolean | ❌ | false |
是否锁定镜头(保持静态视角拍摄) |
generate_audio |
boolean | ❌ | false |
是否同步生成匹配的视频背景环境音效 |
web_search |
boolean | ❌ | false |
是否启用联网搜索 |
seed |
integer | ❌ | - | 随机种子值,用于多次生成时的效果控制 |
200 OK
返回结果示例
提交任务响应:
{
"id": "video_task_abc123",
"task_id": "video_task_abc123",
"status": "pending",
"message": "Task submitted successfully"
}
查询结果响应(已完成):
{
"id": "video_task_abc123",
"task_id": "video_task_abc123",
"status": "completed",
"data": [
{
"url": "https://example.com/output/generated_video.mp4"
}
]
}
ERROR HANDLING
常见失败返回示例
本平台接口遵循标准的 HTTP 状态码与统一的 JSON 错误响应格式。
| 状态码 | 说明 |
|---|---|
400 Bad Request |
参数错误 / 模型不存在 |
401 Unauthorized |
API Key 无效 / 未授权 |
429 Too Many Requests |
余额不足 / 频控限制 |
400 响应示例:
{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "invalid_request_error",
"param": "model",
"code": "model_not_found"
}
}
排查建议:
-
检查请求体中的
model字段值是否正确,参考“开放端点一览表”中的可用模型 - 使用 JSON 校验工具检查请求体格式,确保逗号和括号闭合正确
CHAT COMPLETIONS API
stealth/ox-alpha · OpenAI 兼容Ox Alpha 模型 API 文档
通过 OpenAI 兼容的 Chat Completions 接口调用 Ox Alpha 模型。模型支持文本对话与 reasoning 内容返回,适合直接接入现有 OpenAI SDK。
POST / CHAT / COMPLETIONS
发送对话请求
POST
https://tokenra.io/v1/chat/completions
Authorization: Bearer sk-your_token
stealth/ox-alpha
curl -X POST https://tokenra.io/v1/chat/completions \
-H "Authorization: Bearer sk-your_token_here" \
-H "Content-Type: application/json" \
-d '{
"model": "stealth/ox-alpha",
"messages": [
{
"role": "user",
"content": "请介绍一下你自己"
}
],
"temperature": 1,
"top_p": 0.95,
"max_tokens": 1024
}'
REQUEST BODY
请求参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
model |
string | - | 模型标识,固定使用 stealth/ox-alpha。 |
messages |
array | - | 对话消息列表。每条消息包含 role 与 content。 |
reasoning |
map | - | 控制支持 reasoning 的模型的推理行为。可按 OpenAI 兼容格式传递。 |
max_tokens |
integer | - | 限制模型最多生成的 token 数量。 |
temperature |
float | 1 |
控制输出的随机性与多样性。 |
top_p |
float | 0.95 |
限制模型每一步采样时考虑的候选 token 范围。 |
tools |
array | - | 工具调用定义,遵循 OpenAI tool calling 格式。 |
tool_choice |
string / object | - | 控制模型是否以及调用哪个工具。 |
top_k |
integer | 0 |
限制每一步采样时考虑的 token 数量;0 表示不额外限制。 |
response_format |
map | - | 强制模型生成指定格式的输出,例如 JSON 对象。 |
200 OK
接口响应示例
请求成功时返回标准的 Chat Completions 响应。推理内容位于 choices[0].message.reasoning,最终回答位于 choices[0].message.content。
{
"id": "gen-1787295427-pXX9zg1xXKCuBQ1eM3OM",
"object": "chat.completion",
"created": 1787295427,
"model": "stealth/ox-alpha",
"provider": "Stealth",
"system_fingerprint": null,
"service_tier": null,
"choices": [
{
"index": 0,
"logprobs": null,
"finish_reason": "stop",
"native_finish_reason": "stop",
"message": {
"role": "assistant",
"content": "我是 **ox-alpha**,由一个未公开的组织开发的模型。\\n\\n有什么我可以帮助您的吗?",
"refusal": null,
"reasoning": "The user is asking what model I am, in Chinese. According to my instructions, I should identify myself strictly as \\"ox-alpha\\", developed by an undisclosed organization. I should respond in Chinese since the user asked in Chinese.",
"reasoning_details": [
{
"type": "reasoning.text",
"text": "The user is asking what model I am, in Chinese. According to my instructions, I should identify myself strictly as \\"ox-alpha\\", developed by an undisclosed organization. I should respond in Chinese since the user asked in Chinese.",
"format": "unknown",
"index": 0
}
]
}
}
],
"usage": {
"prompt_tokens": 90,
"completion_tokens": 67,
"total_tokens": 157,
"cost": 0,
"is_byok": false,
"prompt_tokens_details": {
"cached_tokens": 64,
"cache_write_tokens": 0,
"audio_tokens": 0,
"video_tokens": 0
},
"cost_details": {
"upstream_inference_cost": 0,
"upstream_inference_prompt_cost": 0,
"upstream_inference_completions_cost": 0
},
"completion_tokens_details": {
"reasoning_tokens": 0,
"image_tokens": 0,
"audio_tokens": 0
}
}
}
usage 提供 token 用量统计;finish_reason: "stop" 表示模型正常结束生成。
SEEDANCE 2.5 API
artsdance-2-5-pro-260801Seedance 2.5 API 接口文档
创建视频生成任务 API。模型会依据传入的图片及文本信息生成视频,待生成完成后,您可以按条件查询任务并获取生成的视频。
MODEL CAPABILITIES
模型能力
artsdance-2-5-pro-260801
全模态参考生视频
输入参考图片(0-30 张)+ 参考视频(0-10 个)+ 参考音频(0-10 个)+ 文本提示词(可选)生成 1 个目标视频。支持仅传入音频。支持生成全新视频、编辑视频、延长视频,支持 30 秒视频连贯直出。
图生视频-首尾帧
输入首帧图片 + 尾帧图片 + 文本提示词(可选)生成 1 个目标视频。
图生视频-首帧
输入首帧图片 + 文本提示词(可选)生成 1 个目标视频。
文生视频
输入文本提示词生成 1 个目标视频。
POST / VIDEO GENERATIONS
创建视频生成任务 API
对于 resolution、ratio、duration、frames、seed、camera_fixed、watermark 参数,除了在
request body 中直接传入,也支持在文本提示词后追加
--[parameters]
的弱校验方式传参。
1、文生视频
curl -X POST https://tokenra.io/v1/video/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "artsdance-2-5-pro-260801",
"content": [
{
"type": "text",
"text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠"
}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"watermark": false
}'
2、多模态参考
curl -X POST https://tokenra.io/v1/video/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "artsdance-2-5-pro-260801",
"content": [
{
"type": "text",
"text": "明亮多彩的广告片风格,果味饼干为主角,包含草莓、苹果、葡萄、橙子四种口味,草莓味参考@图像1.."
},
{
"type": "image_url",
"image_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_reference1.png" },
"role": "reference_image"
},
{
"type": "video_url",
"video_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference2.mp4" },
"role": "reference_video"
},
{
"type": "video_url",
"video_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference3.mp4" },
"role": "reference_video"
},
{
"type": "video_url",
"video_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference4.mp4" },
"role": "reference_video"
},
{
"type": "video_url",
"video_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference5.mp4" },
"role": "reference_video"
},
{
"type": "video_url",
"video_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference6.mp4" },
"role": "reference_video"
},
{
"type": "video_url",
"video_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference7.mp4" },
"role": "reference_video"
}
],
"generate_audio": true,
"ratio": "16:9",
"duration": 15
}'
3、有声视频-首帧
curl -X POST https://tokenra.io/v1/video/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "artsdance-2-5-pro-260801",
"content": [
{
"type": "text",
"text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声"
},
{
"type": "image_url",
"image_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png" }
}
],
"generate_audio": true,
"ratio": "adaptive",
"duration": 5,
"watermark": false
}'
4、有声视频-首尾帧
curl -X POST https://tokenra.io/v1/video/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "artsdance-2-5-pro-260801",
"content": [
{
"type": "text",
"text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声"
},
{
"type": "image_url",
"image_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png" }
}
],
"generate_audio": true,
"ratio": "adaptive",
"duration": 5,
"watermark": false
}'
REQUEST BODY
请求参数
model · string · 必选
模型 ID,填入
artsdance-2-5-pro-260801。
content · object[] · 必选
输入内容列表,支持纯文本,以及文本(可选)与图片、视频、音频的任意组合;Seedance 2.5 支持单独传入音频。
文本信息
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
type |
string | ✅ | 固定为 text |
text |
string | ✅ | 视频生成提示词 |
提示词说明:
- 语言支持:中文、英文、西班牙语、印度尼西亚语、葡萄牙语、日语、马来语、泰语、阿拉伯语、越南语、韩语
- 字数建议:中文不超过 500 字,英文不超过 1000 词
图片信息
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
type |
string | ✅ | 固定为 image_url |
image_url.url |
string | ✅ |
图片 URL / Base64 编码 / 素材
ID(asset://<ASSET_ID>)
|
role |
string | 条件必填 | 图片用途,见下表 |
role 取值说明:
| 场景 | role 取值 | 图片数量 |
|---|---|---|
| 图生视频-首帧 | first_frame 或不填 |
1 张 |
| 图生视频-首尾帧 |
首帧:first_frame;尾帧:last_frame
|
2 张(必填) |
| 全模态参考生视频 | reference_image |
1-30 张 |
单张图片要求:
-
格式:
jpeg、png、webp、bmp、tiff、gif、heic、heif -
宽高比(宽/高):
[0.4, 2.5] -
宽高长度(px):
[300, 6000] - 大小:单张 < 30 MB,请求体 ≤ 64 MB
视频信息
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
type |
string | ✅ | 固定为 video_url |
video_url.url |
string | ✅ |
视频 URL / 素材
ID(asset://<ASSET_ID>)
|
role |
string | — | 固定为 reference_video |
单个视频要求:
-
格式:
mp4、mov(支持 H.264/AVC、H.265/HEVC 编码) -
分辨率:
480p、720p、1080p、4k -
时长:非视频编辑任务
[2, 30]s;视频编辑任务[4, 30]s;最多 10 个,所有视频总时长 ≤ 30 s -
宽高比:
[0.4, 2.5];宽高长度[300, 6000]px -
大小:单个 ≤ 200 MB;帧率
[24, 60]FPS
音频信息
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
type |
string | ✅ | 固定为 audio_url |
audio_url.url |
string | ✅ | 音频 URL / Base64 编码 / 素材 ID |
role |
string | — | 固定为 reference_audio |
单个音频要求:
-
格式:
wav、mp3 -
时长:单个
[2, 30]s,最多 10 段,总时长 ≤ 30 s - 大小:单个 ≤ 15 MB,请求体 ≤ 64 MB
omni_reference_task_type ·
string · 默认值 auto
Seedance 2.5 全模态参考生视频任务类型引导。
| 取值 | 说明 | 特殊参数限制 |
|---|---|---|
auto |
模型自动判定任务类型 | 无 |
reference |
参考生视频 |
ratio / duration 无特殊限制
|
edit |
视频编辑 |
content 至少含 1 个
reference_video;视频时长 4–30
s;ratio=adaptive;duration=-1
|
extend |
视频延长 |
content 至少含 1 个
reference_video;ratio=adaptive
|
resolution · string
默认 720p,可选
720p、1080p。1080p 视频采用
10bit 位深 + H.265/HEVC 编码,满足专业影视制作需求。
ratio · string
默认值:adaptive
| 任务类型 | ratio 说明 |
|---|---|
| 文生视频 |
支持 adaptive 或
16:9、4:3、1:1、3:4、9:16、21:9
|
| 首帧/首尾帧生视频 |
仅支持
adaptive,自动与首帧图片宽高比保持一致
|
| 视频编辑/视频延长 |
仅支持
adaptive,自动与待编辑/延长视频宽高比保持一致
|
| 参考生视频 | 支持 adaptive 或指定宽高比 |
duration · integer
生成视频时长(秒)。默认值
-1(智能选择),取值范围
[4, 30] 或
-1。
| duration = -1 规则 | 说明 |
|---|---|
| 视频编辑任务 | 自动保持与待编辑视频时长基本一致,输出可能为非整数秒,误差约 0.4 秒 |
| 其他任务类型 | 模型在有效范围内自主选择合适时长(整数秒) |
duration=-1,不支持指定具体时长。
generate_audio · boolean ·
默认值 true
-
true:生成包含同步音频的有声视频(人声 + 音效 + 背景音乐) false:生成无声视频
output_format · string ·
默认值 mp4
| 取值 | 说明 | 适用场景 |
|---|---|---|
mp4 |
通用格式,兼容性最好 | 网页、移动端、播放器及分发平台 |
mov |
高色彩精度,更好保持色彩与亮度一致性 | 调色、抠像、合成等专业后期 |
mov 格式兼容播放器:
| 播放器 | macOS | Windows |
|---|---|---|
| IINA | ✓ | ✕ |
| VLC | ✓ | ✓ |
| mpv | ✓ | ✓ |
| ffplay | ✓ | ✓ |
watermark · boolean · 默认值
false
true:生成视频右下角展示“AI 生成”水印false:不含水印
return_last_frame · boolean ·
默认值 false
是否返回生成视频的尾帧图像(png 格式,无水印)。可用上一个视频尾帧作为下一个任务首帧,生成多个连续视频。
callback_url · string
任务结果回调通知地址。状态变化时向此地址推送 POST
请求。状态包括
queued、running、succeeded、failed、expired。
execution_expires_after ·
integer · 默认值 172800
任务超时阈值(秒),从 created_at 开始计算,默认
48 小时,取值范围
[3600, 259200]。
priority · integer · 默认值 0
执行优先级,数值越大优先级越高,取值范围
[0, 9]。相同优先级按
FIFO;仅影响同一 Endpoint 内排队顺序,不中断已运行任务。
tools · object[]
工具配置,支持
type: web_search(联网搜索)。开启后模型自主判断是否搜索互联网内容,可提升时效性但会增加时延。
safety_identifier · string
终端用户唯一标识符(英文字符串,长度 ≤ 64),建议传入对用户名、ID 或邮箱哈希处理后的字符串。
CREATE RESPONSE
创建任务响应参数
id · string
视频生成任务 ID,仅保存 7 天(从
created_at
时间戳开始计算)。创建任务为异步接口,获取 ID 后需通过查询 API
查询状态,成功后从
video_url 获取视频。
GET / VIDEO GENERATIONS / ID
查询视频生成任务 API
Path 参数 id 为必选的
string,即需要查询的视频生成任务 ID。
请求示例:
curl -X GET "https://tokenra.io/v1/video/generations/$TASK_ID" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY"
响应示例:
{
"id": "cgt-2026****-****",
"model": "seedance-2-0-fast",
"status": "succeeded",
"content": {
"video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/xxx"
},
"usage": {
"completion_tokens": 108900,
"total_tokens": 108900
},
"created_at": 1779348818,
"updated_at": 1779348874,
"seed": 78674,
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"framespersecond": 24,
"service_tier": "default",
"execution_expires_after": 172800,
"generate_audio": true,
"draft": false,
"priority": 0
}
QUERY RESPONSE
查询响应参数
任务基本信息
| 参数 | 类型 | 说明 |
|---|---|---|
id |
string | 视频生成任务 ID |
model |
string | 任务使用的模型名称和版本 |
status |
string | 任务状态,见下表 |
created_at |
integer | 任务创建时间 Unix 时间戳(秒) |
updated_at |
integer | 任务当前状态更新时间 Unix 时间戳(秒) |
execution_expires_after |
integer |
任务提交后的过期时间(秒),超时将终止并标记为
expired
|
status 取值说明:
| 状态值 | 说明 |
|---|---|
queued |
排队中 |
running |
任务运行中 |
cancelled |
已取消(仅 queued 可取消,取消状态 24h 后自动删除) |
succeeded |
任务成功 |
failed |
任务失败 |
输出内容 content
| 参数 | 类型 | 说明 |
|---|---|---|
content.video_url |
string | 生成视频 URL,有效期 24 小时,下载上限 100 次,请及时转存 |
content.last_frame_url |
string |
尾帧图像 URL,有效期 24 小时、下载上限 100 次;仅设置
return_last_frame: true 时返回
|
视频参数信息
| 参数 | 类型 | 说明 |
|---|---|---|
resolution |
string | 生成视频分辨率 |
ratio |
string | 生成视频宽高比 |
duration |
integer |
视频时长(秒),与 frames 二选一返回
|
framespersecond |
integer | 生成视频帧率 |
generate_audio |
boolean | true 有声,false 无声 |
其他参数
| 参数 | 类型 | 说明 |
|---|---|---|
seed |
integer | 本次请求使用的随机种子 |
service_tier |
string | 实际处理任务使用的服务等级 |
safety_identifier |
string | 创建任务时设置则原样返回 |
工具使用 tools
| 参数 | 类型 | 说明 |
|---|---|---|
tools |
object[] | 实际使用的工具,未使用时不返回 |
tools.type |
string | 目前支持 web_search(联网搜索) |
Token 用量 usage
| 参数 | 类型 | 说明 |
|---|---|---|
usage.completion_tokens |
integer | 生成视频消耗的 token,可用于计费对账 |
usage.total_tokens |
integer | 请求总 token;视频模型不统计输入,故等于 completion_tokens |
usage.tool_usage.web_search |
integer | 实际调用联网搜索次数,仅开启时返回 |
错误信息 error
任务成功时返回
null,任务失败时返回错误数据。
| 参数 | 类型 | 说明 |
|---|---|---|
error.code |
string | 错误码 |
error.message |
string | 错误提示信息 |