`GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id}` 查询 3D 生成任务的状态。 :::tip 仅支持查询最近 7 天的历史数据。时间计算统一采用 UTC 时间戳，返回的 7 天历史数据范围以用户实际发起查询请求的时刻为基准（精确到秒），时间戳区间为 [T\-7天, T)。 ::: ```mixin-react return ( ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2abecd05ca2779567c6d32f0ddc7874d.png =20x) [模型列表](https://www.volcengine.com/docs/82379/1330310?lang=zh) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a5fdd3028d35cc512a10bd71b982b6eb.png =20x) [模型计费](https://www.volcengine.com/docs/82379/1544106?lang=zh) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_afbcf38bdec05c05089d5de5c3fd8fc8.png =20x) [API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey?apikey=%7B%7D) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f45b5cd5863d1eed3bc3c81b9af54407.png =20x) [接口文档](https://www.volcengine.com/docs/82379/1856293) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1609c71a747f84df24be1e6421ce58f0.png =20x) [常见问题](https://www.volcengine.com/docs/82379/1359411) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bef4bc3de3535ee19d0c5d6c37b0ffdd.png =20x) [开通模型](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false) `}> ); ``` --- ## 请求参数 > 跳转 [响应参数](#fNRpGlkF) --- **id** `string` %%require%% 您需要查询的 3D 生成任务的 ID 。 :::tip 该参数为 Path Parameter。您需要将待查询的 3D 生成任务的 ID，直接替换 URL 中的 {id} 占位符。 ::: --- ## 响应参数 > 跳转 [请求参数](#QBQmkJP0) --- **id ** `string` 3D 生成任务 ID 。 --- **model** `string` 任务实际使用的模型名称和版本，`模型名称-版本`。 --- **status** `string` 任务状态，以及相关的信息： * `queued`：排队中。 * `running`：任务运行中。 * `cancelled`：取消任务，取消状态24h自动删除（只支持`queued`状态的任务被取消）。 * `succeeded`：任务成功。 * `failed`：任务失败。 --- **error** `object` 错误提示信息。任务失败时返回错误数据，具体参见 [错误处理](https://www.volcengine.com/docs/82379/1299023)。属性 --- 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小时后被清理，请及时转存。 :::tip * 模型会自动将生成的 3D 文件打包为.zip格式以供下载，压缩包内文件的格式与您创建任务时所指定的格式一致。 * 推荐配置火山引擎 TOS 提供的数据订阅功能，将您的模型推理产物自动转存到自己的 TOS 桶中，便于长期备份或二次加工。详细介绍请参见 [TOS 数据订阅](https://www.volcengine.com/docs/6349/2280949?lang=zh)。 ::: --- **usage** `object` 本次请求的 token 用量。属性 --- usage.**completion_tokens** `integer` 模型输出 3D 文件消耗的 token 数量。 --- usage.**total_tokens** `integer` 本次请求消耗的总 token 数量。3D 生成模型不统计输入 token，输入 token 为 0，故 **total_tokens**=**completion_tokens**。

火山方舟