---
title: "POST /v1/agents/async-result"
method: POST
path: "/v1/agents/async-result"
---

# POST /v1/agents/async-result

`POST /v1/agents/async-result`

This endpoint is used to query the result of an asynchronous request.

## Headers

- `Accept-Language` 'en-US,en' — Config desired response language for HTTP requests.

## Request body

- CommonAgentResultRequest
  - `agent_id` string — Agent ID: `vidu_template_agent`.
  - `async_id` string — Task ID from async response.

## Response `200`

Processing successful

- CommonAgentResultResponse
  - `status` string — `pending` (processing), `success` (completed), `failed` (failed).
  - `agent_id` string — Agent ID
  - `async_id` string — Asynchronous task ID.
  - `choices` object[] — Agent output.
    - `index` integer — Result index.
    - `finish_reason` string — Reason for model inference termination. Can be ‘stop’, ‘tool_calls’, ‘length’, ‘sensitive’, or ‘network_error’.
    - `message` object[]
      - `role` string — Role: fixed as `assistant`.
      - `content` object[] — Video file metadata
        - `type` string — object type: `video_url`.
        - `video_url` string — MP4 video URL.

## Other responses

- `default` — The request has failed.

---

[API](https://skmtc.net/z/apis/z-ai-api.md) · [All operations](https://skmtc.net/z/apis/z-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/z/z-ai-api/revisions/62622aa47d10/schema)