# 获取任务状态

**方法**: `POST`
**路径**: `/higgsfield/feed/{task_id}`

HIGGSFIELD.2 获取视频任务状态 [查询结果]

## 请求参数

### Path 参数

```text
task_id
string
必需
```

### Header 参数

```text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json

```text
task_id
string
必需
任务ID，从生成任务接口返回获取
示例
{
"task_id"
:
"string"
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/higgsfield/feed/' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "task_id": "string"
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
id
string
任务ID
可选
type
string
任务类型
可选
project_id
string
可选
created_at
number
任务创建时间戳
可选
params
object
任务参数详情
可选
jobs
array
[object]
任务执行情况
可选
id
string
可选
status
enum<string>
可选
任务状态，可能值：queued、in_progress、completed
枚举值:
queued
in_progress
completed
result
object
可选
```

#### 示例

```json
{
    "id": "aca6c73e-aa4c-47bb-aa62-a100a0f7dd22",
    "type": "image2video",
    "project_id": "41ff94b3-91b5-424a-a455-0ecef47c9b77",
    "created_at": 1747790390.044471,
    "params": {
        "prompt": "The white cat sits poised...",
        "input_image": {
            "id": "657edc5b-0f39-43b6-8706-676d60366d7d",
            "url": "https://d2ol7oe51mr4n9.cloudfront.net/anon_user_id/657edc5b-0f39-43b6-8706-676d60366d7d.jpeg",
            "type": "media_input"
        },
        "seed": 374487,
        "steps": 20,
        "guide_scale": 6,
        "frames": 81,
        "width": 736,
        "height": 1312,
        "strength": 1,
        "model": "standard",
        "motion_id": "cd5bfd11-5a1a-46e0-9294-b22b0b733b1e",
        "motion": {
            "id": "cd5bfd11-5a1a-46e0-9294-b22b0b733b1e",
            "url": "https://d1xarpci4ikg0w.cloudfront.net/4c75250f-a508-4d36-b092-25cc0837f127.webp",
            "name": "Face Punch"
        },
        "enhance_prompt": true
    },
    "jobs": [
        {
            "id": "f0204af5-1b7e-4c43-a113-191ca66acd31",
            "status": "completed",
            "result": {
                "type": "video",
                "url": "https://d8j0ntlcm91z4.cloudfront.net/user_2xIzuhTaLzSSkbGluAOou1fpp32/5c0ac5f8-b3ff-4161-a77b-c248f02bfeca.mp4"
            },
            "results": {
                "raw": {
                    "type": "video",
                    "url": "https://d8j0ntlcm91z4.cloudfront.net/user_2xIzuhTaLzSSkbGluAOou1fpp32/5c0ac5f8-b3ff-4161-a77b-c248f02bfeca.mp4"
                },
                "min": {
                    "type": "video",
                    "url": "https://d8j0ntlcm91z4.cloudfront.net/user_2xIzuhTaLzSSkbGluAOou1fpp32/5c0ac5f8-b3ff-4161-a77b-c248f02bfeca_min.mp4"
                }
            },
            "meta": {
                "duration": 5
            }
        }
    ]
}
```