火山方舟支持将模型调用相关日志投递至火山引擎日志服务 TLS（Torch Log Service）。开启后，每次调用的请求、响应、状态码、时延和 Token 用量等会近实时写入您账号下的 TLS，便于检索日志、分析调用和排查问题。
前提条件#
当前账号具备日志服务 TLS 的开通权限。首次开启时，按控制台提示完成 TLS 开通与跨服务授权。
支持范围#
- 在线推理：日志投递按推理接入点开启，预置推理接入点和自定义推理接入点均支持。
- 模型：大语言模型、生图模型、生视频模型、生 3D 模型。
- API：Chat API、Responses API、Messages API、Image Generation API、Video Generation API。
- 投递时机：同步调用在请求结束后投递；异步任务在返回最终结果后投递。
开启日志投递#
- 访问 创建推理接入点 ，展开 更多，打开 日志投递 开关；或进入已有接入点的详情页，在 日志投递 卡片中打开开关。
- 首次开启时，在 开启日志投递 窗口中勾选同意条款，点击 一键授权并开通。方舟自动完成 TLS 开通和跨服务授权。
查看调用日志#
开启日志投递后，方舟会在您的 TLS 同一地域同一项目下创建日志项目 ark_inference_project_<project_name>（<project_name> 为推理接入点所属的项目名称）和日志主题 ark-inference-log。该推理接入点后续新发起的请求会统一投递至 ark_inference_project_<project_name> 下的 ark-inference-log。
进入 日志服务 TLS 控制台 ，在对应日志主题中检索、分析日志。
日志字段说明#
一条日志对应一次 API 调用，字段说明如下。
| 字段 | 类型 | 说明 |
|---|---|---|
request_id |
string | 请求唯一标识，用于日志检索和问题排查。 |
X-Client-Request-Id |
string | 客户端请求标识，用于关联客户端请求与对应的调用日志。 |
account_id |
string | 火山引擎账号 ID。 |
project_name |
string | 项目名称。 |
endpoint_id |
string | 推理接入点 ID。 |
api_type |
string | 接口类型。 |
model_name |
string | 模型名称和版本。 |
service_tier |
string | 推理服务等级。 |
api_key |
string | API Key ID，以脱敏形式记录。 |
client_ip |
string | 客户端来源 IP。 |
status |
string | 请求处理状态，以字符串形式记录。 |
extra.status.status_code |
int | HTTP 状态码。 |
extra.status.code |
string | 请求错误码。 |
extra.status.message |
string | 请求错误描述。 |
usage |
string(JSON) | 响应体中的用量信息。 |
input |
string(JSON) | 请求内容，包含模型、消息、提示词或生成参数等信息。 |
output |
string(JSON) | 模型响应或生成结果，包含回答内容、用量信息或产物链接等信息。 |
usage、input 和 output 为 JSON 字符串，具体结构以对应 API 的请求参数和响应参数为准。
多模态内容存储说明#
多模态内容按数据形式采用以下存储方式，输入与输出中的 Base64 内容均适用统一转存规则。
- Base64 内容：所有形式的 Base64 内容，包括图片、视频、音频、PDF/文档等输入，以及以 Base64 返回的生成产物，均统一转存为 TLS 的 TOS URL，日志中记录转存后的 URL。转存文件的 TTL 与对应日志的 TTL 一致，按日志保留周期管理。
- 其他产物 URL：以 URL 返回的图片、视频、视频尾帧和 3D 产物保留原始 URL，有效期为 24 小时。日志保存时间不会延长原产物 URL 的有效期。
- File ID：以 File ID 引用的文件保留原始
file_id，不修改该标识，也不转换为 TOS URL。
免责声明#
特殊情况下，日志采集可能存在遗漏。日志数据仅供调用追踪和问题排查参考，不作为方舟侧模型计费的依据，实际费用请以账单为准。
日志仅写入您账号下的 TLS，方舟侧不会存储您的日志数据。