GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id}
查询影眸 3D 生成任务的状态。
鉴权#
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。
- API Key 鉴权,请在 API Key 管理 页面,获取长效 API Key。
请求参数#
Path 参数#
id string 必选 | 任务 ID
您需要查询的影眸 3D 生成任务 ID,该 ID 由创建任务接口返回。
响应参数#
id string | 任务 ID
影眸 3D 生成任务 ID
model string | 模型名称与版本
任务使用的模型名称和版本,格式为 模型名称-版本
status string | 任务状态
任务状态,以及相关的信息:
queued:排队中。running:任务运行中。cancelled:取消任务,取消状态 24h 自动删除(只支持queued状态的任务被取消)。succeeded:任务成功。failed:任务失败。
content object | 输出内容
影眸 3D 生成任务的输出内容
file_url string | 文件 URL
content.file_url
生成的 3D 文件的 URL。为保障信息安全,生成的 3D 模型文件会在 24 小时后被清理,请及时转存。
created_at integer | 创建时间
任务创建时间的 Unix 时间戳(秒)
error object | 错误信息
错误提示信息。任务成功时返回 null,任务失败时返回错误数据,错误信息具体参见 错误处理
code string | 错误码
error.code
message string | 错误提示信息
error.message
updated_at integer | 更新时间
任务当前状态更新时间的 Unix 时间戳(秒)
usage object | token 用量
本次请求的 token 用量
completion_tokens integer | 生成 3D 内容消耗的 token 数
usage.completion_tokens
模型生成 3D 模型文件消耗的 token 数量,可作为计费对账依据。
total_tokens integer | 总 token 数
usage.total_tokens
本次请求消耗的总 token 数量。3D 生成模型不统计输入 token,输入 token 为 0,故 total_tokens = completion_tokens