火山方舟支持将模型调用相关日志投递至火山引擎日志服务 TLS（Torch Log Service）。开启后，每次调用的请求、响应、状态码、时延和 Token 用量等会近实时写入您账号下的 TLS，便于检索日志、分析调用和排查问题。
前提条件#
当前账号具备日志服务 TLS 的开通权限。首次开启时，按控制台提示完成 TLS 开通与跨服务授权。
支持范围#
- 在线推理：日志投递按推理接入点开启，预置推理接入点和自定义推理接入点均支持。
- 模型：大语言模型、生图模型、生视频模型。
- 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 输入或输出的单条日志超过单条存储上限时，日志服务 TLS 会将其中的 Base64 内容自动解析并转存到 TLS 内置的多模态空间，并在日志原文中记录转存后的访问链接。TLS 中转存的 Base64 文件保留时长与对应日志原文一致。
- 产物链接：以 URL 形式返回的图片、视频等生成产物，日志中保留原始链接，链接有效期为 24 小时。如需长期保存，请在有效期内下载。延长日志保留时长不会延长链接有效期。
- 文件标识：以 File ID 引用的文件，日志中保留原始
file_id，不进行转存。