文档中心

火山方舟

数美 API

查询3D生成任务

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

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

说明

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

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

API Key 鉴权，请在 API Key 管理页面，获取长效 API Key。

请求参数

Path 参数

id string 必选 | 任务 ID

响应参数

id string | 任务 ID

model string | 模型名称与版本

status string | 任务状态

content object | 输出内容

created_at integer | 创建时间

error object | 错误信息

updated_at integer | 更新时间

usage object | token 用量

默认

发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！

Request

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"

Response

{
    "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.09.29 14:48:36

这个页面对您有帮助吗？

有用

无用