文档中心

数美 API

查询3D生成任务

GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id} 运行

查询 3D 生成任务的状态。

说明

仅支持查询最近 7 天的历史数据。时间计算统一采用 UTC 时间戳，返回的 7 天历史数据范围以用户实际发起查询请求的时刻为基准（精确到秒），时间戳区间为 [T-7天, T)。

快速入口

鉴权说明

体验中心

模型列表

模型计费

API Key

接口文档

常见问题

开通模型

请求参数

跳转响应参数

id string 必选（通过创建 3D 生成任务接口返回的任务 ID）

您需要查询的 3D 生成任务的 ID 。

说明

该参数为 Path Parameter。您需要将待查询的 3D 生成任务的 ID，直接替换 URL 中的 {id} 占位符。

响应参数

跳转请求参数

id string

3D 生成任务 ID 。

model string

任务实际使用的模型名称和版本，模型名称-版本。

status string

任务状态，以及相关的信息：

queued：排队中。

running：任务运行中。

cancelled：取消任务，取消状态24h自动删除（只支持queued状态的任务被取消）。

succeeded：任务成功。

failed：任务失败。

error object

错误提示信息。

任务失败时返回错误数据，具体参见错误处理。

属性

error. code string

错误码。

error. message string

错误提示信息。

created_at integer

任务创建时间的 Unix 时间戳（秒）。

updated_at integer

任务当前状态更新时间的 Unix 时间戳（秒）。

content object

3D 生成任务的输出内容。

属性

content. file_url string

生成的 3D 文件的 url。为保障信息安全，生成的 3D 文件会在24小时后被清理，请及时转存。

说明

模型会自动将生成的 3D 文件打包为.zip格式以供下载，压缩包内文件的格式与您创建任务时所指定的格式一致。

推荐配置火山引擎 TOS 提供的数据订阅功能，将您的模型推理产物自动转存到自己的 TOS 桶中，便于长期备份或二次加工。详细介绍请参见 TOS 数据订阅。

usage object

本次请求的 token 用量。

属性

usage. completion_tokens integer

模型输出 3D 文件消耗的 token 数量。

usage. total_tokens integer

本次请求消耗的总 token 数量。3D 生成模型不统计输入 token，输入 token 为 0，故 total_tokens = completion_tokens 。

默认

输入示例

TASK_ID="your_task_id"
curl -X GET "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/$TASK_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY"

输出示例

{
    "id": "cgt-2026******-****",
    "model": "hitem3d-2-0-251223",
    "status": "succeeded",
    "content": {
        "file_url": "https://xxx"
    },
    "usage": {
        "completion_tokens": 126875,
        "total_tokens": 126875
    },
    "created_at": 1775799170,
    "updated_at": 1775800281
}

最近更新时间：2026.08.21 11:18:10

这个页面对您有帮助吗？

有用

无用

火山方舟