获取任务状态

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

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

请求参数

Path 参数

task_id
string
必需

Header 参数

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

Body 参数 application/json

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

请求示例代码

Shell

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

响应结构

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
可选

示例

{
    "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
            }
        }
    ]
}