Get Video Status and Details

GEThttps://api.konpro.ai/v1/video_status

Retrieve the current status and detailed information about a specific generated video using its unique video ID.

Request History

TIME	STATUS	USER AGENT
Make a request to see history.

0 Requests This Month

Query Parameter

Parameter	Type	Description
video_id	string	Unique identifier of the video

Response Fields

Field	Type	Description
callback_id	string	Custom identifier returned as set during video creation, useful for tracking callbacks
caption_url	string	URL to the captions file in .ass format if captions were generated (requires captions enabled)
created_at	number	Unix timestamp indicating when the video was created
duration	float	Duration of the video in seconds
error	JSON	Error details if an error occurred; null if successful
gif_url	string	URL to a generated GIF preview of the video
id	string	Unique video identifier
status	string	Current video processing status. One of: - processing: Rendering in progress - completed: Rendering finished successfully - failed: An error occurred during rendering - pending: Waiting in the render queue
thumbnail_url	string	URL for the video thumbnail image
video_url	string	URL to the completed video file; expires after 7 days and can be regenerated by calling again
video_url_caption	string	URL to the captioned video file if captions were enabled; also expires after 7 days

cURL Request

shell

curl --request GET \
--url 'https://api.konpro.ai/v1/video_status?video_id=<video_id>' \
--header 'accept: application/json' \
--header 'x-api-key: <your-api-key>'

Example Response (Processing)

json

{
  "code": 100,
  "data": {
    "callback_id": null,
    "caption_url": null,
    "duration": null,
    "error": null,
    "gif_url": null,
    "id": "<video_id>",
    "status": "processing",
    "thumbnail_url": null,
    "video_url": null,
    "video_url_caption": null
  },
  "message": "Success"
}

Important Notes

• The video URL expires 7 days after generation. To maintain access, either download the video or query this endpoint again to get a refreshed URL.
• If the video does not exist or you lack access, HTTP 404 is returned.
• HTTP 400 response indicates bad requests or exceeding rate limits.
• HTTP 424 indicates invalid parameters.

Example Usage

Shell

curl --request GET \
--url 'https://api.konpro.ai/v1/video_status?video_id=<video_id>' \
--header 'accept: application/json' \
--header 'x-api-key: <your-api-key>'

LANGUAGE

CREDENTIALS

Header

HEADER

RESPONSE

Examples

Choose an example:

application/json

200 - Result

400 - Result

404 - Result

424 - Result

Create Avatar Video Retrieve Video List