API 说明文档

TokenFusion 平台 RESTful API 接入指南

产品介绍

TokenFusion 是一个 AI 视频生成与多模态处理平台，面向内容创作、媒体生产与行业级视频应用场景，提供覆盖文生视频、文生图、文本对话、图像生成等的完整能力链路。通过统一的 API，帮助企业快速构建低成本、高质量、可规模化的 AIGC 应用。

当前已支持火山方舟（Volcano Ark）的 Seedance 系列、Seed 系列、Seedream 系列，以及可灵 AI（Kling AI）等模型。TokenFusion 提供统一的 RESTful API 接口，分为 AI 模型接口 与 管理接口 两大类。所有 API 调用均通过标准 HTTP 请求完成，请求和响应体均为 JSON 格式（生文流式模式除外，返回 SSE）。

接口分类

平台入门 · 登录开发者控制台

访问 控制台 > API Keys，创建 API 密钥并命名管理，支持一键复制 API Key。

鉴权认证

用 API Key 组装成 Authorization，填写到 Request Header 里，组装方式为：

代码块

Authorization: Bearer YOUR_API_KEY

其中 Bearer 与 API Key 之间需要保留一个空格。

• 生文、生图、生视频、素材库等模型调用接口须通过 Authorization Header 携带 API Key 进行鉴权。
• 素材库另要求当前用户已开通 火山（volcano） 类视频模型权限，否则返回 403。
• 余额查询接口使用账号和密码在请求体中认证，不需要传 Authorization Header。

API Key 无效、缺失或已禁用时返回 401，响应体为 {"detail":"..."}。

组装请求地址

平台统一接口地址格式如下：

代码块

https://api.xzzgm.cn/api/v1/

AI 模型接口路径示例：

https://api.xzzgm.cn/api/v1/chat/completions

https://api.xzzgm.cn/api/v1/images/generations

https://api.xzzgm.cn/api/v1/video/generations

https://api.xzzgm.cn/api/v1/assets/{Action}（如 CreateAssetGroup、CreateAsset）

管理接口路径示例：

https://api.xzzgm.cn/api/v1/user/balance

下文示例中的路径均相对于上述 Base URL。生产环境请将域名替换为实际对外地址（当前为 https://api.xzzgm.cn）。

完整请求示例（生视频异步流程）

以下以文生视频为例，演示「创建任务 → 轮询查询 → 获取结果」的完整流程。

1. 创建视频生成任务

请求

curl -X POST https://api.xzzgm.cn/api/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "doubao-seedance-1-0-pro-250528",
  "content": [
    {
      "type": "text",
      "text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田"
    }
  ],
  "ratio": "16:9",
  "duration": 5
}'

结果返回示例

{
  "id": "cgt-xxxx-xxxx"
}

2. 查询任务结果

提交异步任务后，使用返回的任务 ID 查询结果：

请求

curl -X GET "https://api.xzzgm.cn/api/v1/video/generations/${TASK_ID}" \
  -H "Authorization: Bearer YOUR_API_KEY"

结果返回示例

{
  "id": "cgt-xxxx-xxxx",
  "model": "doubao-seedance-1-0-pro-250528",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/xxxx/xxxx.mp4"
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1779951506,
  "updated_at": 1779951777,
  "seed": 95020,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "service_tier": "default",
  "generate_audio": true,
  "draft": false
}

任务进行中时 status 为 queued 或 running，请间隔 5~10 秒轮询，收到 429 时遵循 Retry-After 退避。

若需在视频中引用私域参考图/音视频，请先按下文 素材库 · Assets API 完成入库，再在 content 中使用 asset://{素材ID}。

接口总览

模型调用 · 生文（Chat Completions）

OpenAI 兼容的对话补全接口。TokenFusion 校验 API Key 与模型权限后，将请求体原样转发至上游文本模型服务（火山方舟 Seed 系列等），响应 JSON / SSE 亦原样透传。

对齐火山方舟 对话(Chat) API；多模态理解详见图片、视频、音频文档；续写模式见续写模式。

能力模式对照

具体 Model ID 与能力标签以模型广场为准；未绑定上游渠道时返回 503 model_not_found。

请求头（Request Headers）

请求体（Request Body）

下表为 OpenAI 兼容字段及火山 Seed 常用扩展。TokenFusion 对未列出的上游支持字段允许透传（extra 不拦截）。

messages 格式

content 可为字符串（纯文本），或多段对象数组（多模态理解）。

字符串 content（纯文本 / 默认对话）

{"role": "user", "content": "你好"}

多段 content（多模态）

messages[].content[] 中 type 仅下列取值有效（与上游一致）：

续写模式

在已有文本前缀基础上继续生成，适用于故事续写、代码补全等。将最后一条消息的 role 设为 assistant，content 填入希望模型接续的前缀，并在请求体设置 continue_final_message: true、add_generation_prompt: false。详见火山续写模式。

{
  "role": "user",
  "content": "请以童话故事为主题续写：一片森林里，住着一只名叫小白的兔子。"
},
{
  "role": "assistant",
  "content": "有一天，小白"
}

响应（非流式）

HTTP 200，OpenAI 兼容 JSON。推理模型除 message.content 外，还可能返回 message.reasoning_content。

默认对话示例

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1710000000,
  "model": "doubao-seed-2-0-lite-260215",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "你好，有什么可以帮你？" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 10, "completion_tokens": 20, "total_tokens": 30 }
}

深度推理示例（含 reasoning_content）

{
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "最终给用户的回答……",
      "reasoning_content": "模型内部推理过程……"
    },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 50, "completion_tokens": 200, "total_tokens": 250 }
}

响应（流式 stream: true）

Content-Type 为 text/event-stream，每行 data: {...}，末尾 data: [DONE]。增量位于 choices[0].delta：

• delta.content：正文增量
• delta.reasoning_content：推理过程增量（深度推理时可能先输出此项，content 暂时为空）

客户端应同时监听两者，避免误判「长时间无输出」。设置 stream_options: {"include_usage": true} 可在末块获取 usage。

data: {"choices":[{"delta":{"reasoning_content":"……","content":""},"index":0}]}
data: {"choices":[{"delta":{"content":"你好"},"index":0}]}
data: [DONE]

常见错误

请求示例

默认对话（非流式）

curl -X POST https://api.xzzgm.cn/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-2-0-lite-260215",
    "messages": [
      {"role": "user", "content": "用一句话介绍 TokenFusion 平台"}
    ],
    "max_tokens": 256,
    "temperature": 0.7
  }'

流式输出

curl -N -X POST https://api.xzzgm.cn/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "model": "doubao-seed-2-0-lite-260215",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true,
    "stream_options": {"include_usage": true},
    "max_tokens": 512
  }'

续写模式

curl -X POST https://api.xzzgm.cn/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-2-0-lite-260215",
    "messages": [
      {"role": "user", "content": "请以童话故事为主题续写：一片森林里，住着一只名叫小白的兔子。"},
      {"role": "assistant", "content": "有一天，小白"}
    ],
    "continue_final_message": true,
    "add_generation_prompt": false,
    "max_tokens": 512,
    "temperature": 0.7
  }'

图片理解

curl -X POST https://api.xzzgm.cn/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-2-0-pro-260215",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "请用一句话描述这张图片的主要内容"},
        {"type": "image_url", "image_url": {"url": "https://ark-project.tos-cn-beijing.volces.com/images/view.jpeg"}}
      ]
    }],
    "max_tokens": 256,
    "temperature": 0.2
  }'

视频理解

curl -X POST https://api.xzzgm.cn/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-2-0-pro-260215",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "请用一句话概括这段视频在做什么"},
        {"type": "video_url", "video_url": {"url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"}}
      ]
    }],
    "max_tokens": 256,
    "temperature": 0.2
  }'

音频理解（input_audio）

curl -X POST https://api.xzzgm.cn/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-2-0-lite-260428",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "请用一句话描述这段音频的内容或氛围"},
        {"type": "input_audio", "input_audio": {"data": "BASE64_AUDIO_DATA", "format": "mp3"}}
      ]
    }],
    "max_tokens": 256,
    "temperature": 0.2
  }'

input_audio.data 为音频文件 Base64（不含 Data URI 前缀）；format 常用 mp3、wav。建议用 SDK 或脚本构造请求体。

深度推理

curl -X POST https://api.xzzgm.cn/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-2-0-lite-260215",
    "messages": [{
      "role": "user",
      "content": "一个农夫需要把狼、羊、白菜运过河，船每次只能载一样。狼不能和羊单独在一起，羊不能和白菜单独在一起。请给出可行步骤并说明理由。"
    }],
    "reasoning_effort": "high",
    "max_tokens": 1024,
    "temperature": 0.2
  }'

实际字段与错误码以模型服务返回为准；平台不做二次包装。

模型调用 · 生图（Images Generations）

OpenAI 兼容的图像生成接口。TokenFusion 校验 API Key 与模型权限后，将请求体原样转发至上游图像模型服务（火山方舟 Seedream 等），响应 JSON / SSE 亦原样透传。

平台当前主要接入火山方舟 Seedream 系列（如 doubao-seedream-4-5-251128、doubao-seedream-5-0-260128）。除 OpenAI 标准字段外，Seedream 扩展参数（image、sequential_image_generation、tools 等）可直接写入请求体，详见火山方舟图片生成 API。

能力模式对照

具体 Model ID 以模型广场实时列表为准；未绑定上游渠道的模型会返回 503 model_not_found。

请求头（Request Headers）

请求体（Request Body）

下表包含 OpenAI 兼容字段与 Seedream 常用扩展字段。TokenFusion 请求 Schema 对扩展字段允许透传（extra 字段不拦截）。

参考图（image）约束

• 格式：jpeg、png；Seedream 5.0 / 4.5 / 4.0 另支持 webp、bmp、tiff、gif
• 单张大小：不超过 10 MB；请求体总大小不超过 64 MB（大文件请用 URL，勿 Base64）
• 宽高比：Seedream 4.5 / 4.0 / 5.0 均为 [1/16, 16]；宽高像素 > 14，总像素 ≤ 6000×6000
• 数量：最多 14 张参考图；组图时参考图数 + 输出张数 ≤ 15

size 与分辨率（Seedream）

也可在 prompt 中用自然语言描述宽高比，配合 size: "2K" 由模型决定具体像素。

响应（非流式）

成功响应示例（Seedream 4.5 文生图）

{
  "model": "doubao-seedream-4-5-251128",
  "created": 1780281542,
  "data": [
    {
      "url": "https://example.com/generated.jpeg",
      "size": "2560x1440"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16280,
    "total_tokens": 16280
  }
}

联网搜索成功时，usage 可能包含 tool_usage.web_search 计数（Seedream 5.0）。

响应（流式 stream: true）

Content-Type 为 text/event-stream。每张图片生成完成后推送 image_generation.partial_succeeded，全部结束后推送 image_generation.completed，末尾为 data: [DONE]。详见火山方舟生图流式响应。

event: image_generation.partial_succeeded
data: {"type":"image_generation.partial_succeeded","model":"doubao-seedream-4-5-251128","image_index":0,"url":"https://..."}

event: image_generation.completed
data: {"type":"image_generation.completed","usage":{"generated_images":1,"output_tokens":16280,"total_tokens":16280}}

data: [DONE]

请求示例

文生图

curl -X POST https://api.xzzgm.cn/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "一只在窗台上晒太阳的橘猫，写实摄影风格，柔和自然光",
    "size": "2K",
    "watermark": false
  }'

图生图

curl -X POST https://api.xzzgm.cn/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "保持人物姿势不变，将服装材质改为透明清水，光影从反射变为折射",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png",
    "size": "2K",
    "watermark": false
  }'

多图融合

curl -X POST https://api.xzzgm.cn/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "将图1的服装换为图2的服装，保持图1的人物姿态",
    "image": [
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png",
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png"
    ],
    "sequential_image_generation": "disabled",
    "size": "2K",
    "watermark": false
  }'

多参考图生组图

curl -X POST https://api.xzzgm.cn/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "参考图1人物与图2服装风格，生成一组连贯时尚穿搭展示图",
    "image": [
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png",
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png"
    ],
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": {"max_images": 3},
    "size": "2K",
    "watermark": false
  }'

流式输出

curl -X POST https://api.xzzgm.cn/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "一只在窗台上晒太阳的橘猫，写实摄影风格",
    "size": "2K",
    "stream": true,
    "watermark": false
  }'

联网搜索（仅 Seedream 5.0）

curl -X POST https://api.xzzgm.cn/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "根据当前流行的时装周街拍趋势，生成一张都市时尚街拍照片，自然光，高清",
    "tools": [{"type": "web_search"}],
    "size": "2K",
    "watermark": false
  }'

实际字段与错误码以模型服务返回为准；平台不做二次包装。

模型调用 · 创建视频生成任务

创建异步视频生成任务。TokenFusion 平台校验 API Key、模型权限与账户可用余额，预冻结费用后调用对应视频模型服务。成功时仅返回任务 ID，需轮询查询接口获取结果。

请求体（Request Body）

Content 数组对象

文本对象

{ "type": "text", "text": "描述期望生成的视频内容" }

图片对象

{
  "type": "image_url",
  "image_url": { "url": "https://example.com/frame.jpg" },
  "role": "first_frame"
}

role 可选：first_frame（首帧）、last_frame（尾帧）、reference_image（参考图）。也支持 asset://{素材ID} 引用平台素材库（须为当前用户拥有的素材）。

响应

结果返回示例

{ "id": "cgt-2025xxxxxx-xxxx" }

仅返回任务 ID，不包含视频 URL。

模型调用 · 查询视频生成任务

查询任务状态与结果。仅可查询当前 API Key 所属用户创建的任务。平台对同一任务有进程内查询缓存与最小间隔限制，轮询过快返回 429（响应头含 Retry-After）。

路径参数

响应字段

请求示例

请求

curl https://api.xzzgm.cn/api/v1/video/generations/cgt-2025xxxxxx-xxxx \
  -H "Authorization: Bearer YOUR_API_KEY"

模型调用 · 取消视频生成任务

取消排队中的任务。仅 queued 状态可取消；响应结构与查询接口相同，返回取消后的任务状态。

请求

curl -X POST https://api.xzzgm.cn/api/v1/video/generations/cgt-2025xxxxxx-xxxx/cancel \
  -H "Authorization: Bearer YOUR_API_KEY"

模型调用 · 素材库（Assets API）

面向火山方舟（Volcano Ark）素材库的统一代理接口，用于将图片、视频、音频等参考素材入库，并在生视频请求中通过 asset://{素材ID} 引用。平台使用服务端配置的 AK/SK 访问上游 Assets API，下游仅需平台 API Key，不可在 URL 中指定上游账号（如 ?account=...）。

推荐调用流程

1. CreateAssetGroup — 创建素材组，记录返回的 Result.Id。
2. CreateAsset — 提交公网可访问的素材 URL，记录 Result.Id（素材 ID）。
3. GetAsset — 每 3~5 秒轮询，直到 Status 为 Active（失败为 Failed）。
4. POST /video/generations — 在 content 的 image_url.url / video_url.url / audio_url.url 中填写 asset://{素材ID}。

支持的 Action

以下操作均为 POST，路径中的 {Action} 与表内名称一致。

请求头（Request Headers）

通用字段

创建素材组 · CreateAssetGroup

POST https://api.xzzgm.cn/api/v1/assets/CreateAssetGroup

请求

curl -X POST https://api.xzzgm.cn/api/v1/assets/CreateAssetGroup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "Name": "brand-hero-v1",
  "Description": "品牌主视觉素材组",
  "GroupType": "AIGC",
  "ProjectName": "default"
}'

响应示例

{
  "Result": {
    "Id": "group-202604020001"
  }
}

创建素材 · CreateAsset

POST https://api.xzzgm.cn/api/v1/assets/CreateAsset

成功仅表示已提交预处理队列；新素材默认 Processing，须轮询 GetAsset 至 Active 后再用于生视频。图片/视频/音频的格式与大小限制以火山方舟素材库文档为准。

请求

curl -X POST https://api.xzzgm.cn/api/v1/assets/CreateAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "GroupId": "group-202604020001",
  "URL": "https://example.com/hero-face.png",
  "Name": "hero-face-closeup",
  "AssetType": "Image",
  "ProjectName": "default"
}'

响应示例

{
  "Result": {
    "Id": "asset-202604020001"
  }
}

查询素材 · GetAsset

POST https://api.xzzgm.cn/api/v1/assets/GetAsset

curl -X POST https://api.xzzgm.cn/api/v1/assets/GetAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "Id": "asset-202604020001",
  "ProjectName": "default"
}'

响应示例（可用）

{
  "Result": {
    "Id": "asset-202604020001",
    "Name": "hero-face-closeup",
    "URL": "https://example-cdn.com/asset/hero-face.png",
    "AssetType": "Image",
    "GroupId": "group-202604020001",
    "Status": "Active",
    "ProjectName": "default",
    "CreateTime": "2026-04-02T09:03:00Z",
    "UpdateTime": "2026-04-02T09:03:20Z"
  }
}

Result.URL 通常短期有效，请及时用于下载或生视频；入库轮询建议间隔 3~5 秒。

列表与其它操作

ListAssets — 仅返回当前用户拥有的素材；Filter.GroupType 必填 AIGC，可按 GroupIds、Statuses、Name 过滤。

ListAssets 请求示例

curl -X POST https://api.xzzgm.cn/api/v1/assets/ListAssets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "Filter": {
    "GroupIds": ["group-202604020001"],
    "GroupType": "AIGC",
    "Statuses": ["Active"]
  },
  "PageNumber": 1,
  "PageSize": 20,
  "SortBy": "CreateTime",
  "SortOrder": "Desc",
  "ProjectName": "default"
}'

ListAssetGroups、GetAssetGroup、UpdateAssetGroup、UpdateAsset、DeleteAsset 路径分别为 /assets/{Action}，请求体字段与火山方舟 Assets API 一致，由平台透传并维护本地归属记录。

在生视频中引用素材

素材 Status 为 Active 后，在创建视频任务时使用 asset:// 前缀（须为当前用户拥有的素材 ID）：

curl -X POST https://api.xzzgm.cn/api/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "人物看向镜头，电影感写实风格。"
    },
    {
      "type": "image_url",
      "image_url": { "url": "asset://asset-202604020001" },
      "role": "reference_image"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5
}'

提示词中建议用「图片1」「视频1」等顺序指代参考素材，勿将裸 Asset ID 写入提示词正文。仅支持素材引用的火山视频模型可使用 asset://；可灵等其它上游返回 400 类错误。

常见错误

部分上游业务错误会以原 HTTP 状态码与响应体透传，平台不做二次包装。

管理接口 · 查询账户余额

客户可使用平台登录账号和密码查询账户余额。账号即注册邮箱。该接口不会创建登录会话，也不会返回 API Key 或访问令牌；请不要将密码放入 URL Query。

请求体

响应体

请求示例

请求

curl -X POST https://api.xzzgm.cn/api/v1/user/balance \
  -H "Content-Type: application/json" \
  -d '{
    "account": "user@example.com",
    "password": "YourLoginPassword1"
  }'

响应示例

结果返回示例

{
  "account": "user@example.com",
  "balance": 100.0,
  "reserved_balance": 12.5,
  "available_balance": 87.5
}

模型能力支持

下列列表与 模型广场 同步，展示 TokenFusion 平台当前可用模型。完整能力说明、参数约束与价格请前往模型广场查看。

文本模型（生文）

图像模型（生图）

视频模型（生视频）

产品与计费

大语言模型（生文）

• 具体计费规则以模型广场及控制台说明为准。

图片生成模型（生图）

• 具体计费规则以模型广场及控制台说明为准。

素材库（Assets）

• 素材组/素材的创建、查询、更新、删除接口不单独按次计费；费用由平台配置的火山素材库上游账号承担。
• 素材入库本身不产生 TokenFusion 视频预冻结；仅在后续 /video/generations 引用 asset:// 时按视频模型规则计费。

视频生成模型（生视频）

• 创建任务前按模型定价规则预冻结可用余额；可用余额不足返回 402。
• 任务进入终态（成功/失败/取消等）后自动结算：释放冻结并按 Token 用量扣费。
• 费用计算依赖任务返回的 usage.total_tokens 与平台模型单价配置。
• 不同模型、分辨率、是否含视频输入等条件可能匹配不同价格规则。

余额查询

管理接口返回的 available_balance 可用于判断视频任务是否可创建。

错误与状态码

集成建议

1. 生文流式：设置 stream: true，按 SSE 规范解析 data: 行；深度推理时同时监听 delta.reasoning_content 与 delta.content。
2. 生文续写：末条 assistant 消息填前缀，并设 continue_final_message: true、add_generation_prompt: false。
3. 生文多模态：图片/视频用 Pro 模型；音频理解优先 doubao-seed-2-0-lite-260428，勿在 Chat 中使用 audio_url。
4. 生图流式：设置 stream: true 并传 Accept: text/event-stream；监听 image_generation.partial_succeeded 逐张渲染，以 data: [DONE] 结束。
5. 生图模式选型：文生图/图生图/融合/组图通过 image 与 sequential_image_generation 组合切换；联网搜索须使用 Seedream 5.0（doubao-seedream-5-0-260128）。
6. 生视频异步：创建任务后每 5~10 秒轮询查询接口；收到 429 时遵循 Retry-After 退避。
7. 素材入库：CreateAsset 后轮询 GetAsset 至 Active 再调用生视频；素材库用 PascalCase，生视频用小写字段。
8. asset:// 引用：仅用于支持素材引用的火山视频模型；须为当前用户已入库且状态为 Active 的素材。
9. 及时转存：视频、生图与素材库返回的 URL 通常有时效，请在成功后尽快下载到自有存储。
10. 错误处理：区分平台鉴权错误（detail）与 OpenAI 兼容格式的模型错误（error 对象）；生图 503 model_not_found 多为 Model ID 未在模型广场绑定渠道。
11. 余额监控：视频业务建议定期调用余额查询接口或关注控制台用量页。
12. 模型选型：以模型广场实时列表为准，勿硬编码已下线或未接入的 Model ID。