查询视频任务

GET

https://api.tokenhot.ai/v1/video/generations/{task_id}

实际请求地址: GET https://api.tokenhot.ai/v1/video/generations/{task_id}

查询视频生成任务的状态与结果(kling-v3 / kling-v3-omni 共用)。轮询直到 data.status 为 SUCCESS。

data.status: IN_PROGRESS(处理中) / SUCCESS(成功) / FAILURE(失败)。

data.result_url: 网关代理播放地址(推荐前端用此地址预览,会做 SSRF 校验 + 缓存)。

data.data.metadata.url: 上游真实视频直链(mp4)。

Request

Authorization

Path Params

Responses

🟢200

application/json

查询成功

Bodyapplication/json

🟠400

🟠401

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.tokenhot.ai/v1/video/generations/task_fyDSCKxabqkXPyMi08jvIN81J4cuEHHq'

Response Example

200 - 成功示例

{
    "code": "success",
    "message": "",
    "data": {
        "id": 8172,
        "created_at": 1781160537,
        "updated_at": 1781160644,
        "task_id": "task_fyDSCKxabqkXPyMi08jvIN81J4cuEHHq",
        "platform": "1",
        "user_id": 1,
        "group": "default",
        "channel_id": 126,
        "quota": 280000,
        "action": "textGenerate",
        "status": "SUCCESS",
        "fail_reason": "",
        "result_url": "https://api.tokenhot.ai/v1/videos/task_fyDSCKxabqkXPyMi08jvIN81J4cuEHHq/content",
        "submit_time": 1781160537,
        "start_time": 1781160539,
        "finish_time": 1781160644,
        "progress": "100%",
        "properties": {
            "input": "",
            "upstream_model_name": "kling-v3",
            "origin_model_name": "kling-v3"
        },
        "data": {
            "completed_at": 1781160636,
            "created_at": 1781160536,
            "id": "1500062068-AigcVideoTask-e3d76366ae4ccd8865f22f41c2d743c5t",
            "metadata": {
                "url": "http://251000800.vod2.myqcloud.com/.../aigcVideoGenFile.mp4"
            },
            "model": "kling-v3",
            "object": "video",
            "progress": 100,
            "status": "completed"
        }
    }
}

查询主体

gemini-2.5-flash-preview-tts