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