Get Video Generation | Mesh API Docs

{
  "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
  "status": "succeeded",
  "model": "byteplus-video-gen-v2",
  "error": null,
  "created_at": 1685600000,
  "updated_at": 1685603600,
  "content": {
    "video_url": "https://cdn.byteplus.com/videos/generated/abc123def456.mp4",
    "last_frame_url": "https://cdn.byteplus.com/videos/generated/abc123def456_last_frame.jpg"
  },
  "seed": 987654321,
  "resolution": "1920x1080",
  "ratio": "16:9",
  "duration": 30,
  "frames": 900,
  "framespersecond": 30,
  "generate_audio": true,
  "safety_identifier": "safe_content_001",
  "priority": 5,
  "draft": false,
  "draft_task_id": null,
  "service_tier": "premium",
  "execution_expires_after": 3600,
  "usage": {
    "completion_tokens": 1500,
    "total_tokens": 3000
  }
}

Retrieve the status and result of a BytePlus video generation task.

Returns from DB when the task is in a terminal state. Otherwise polls BytePlus live and syncs the DB row.

Poll until status is one of: succeeded — content.video_url is populated, failed — check error field, expired — task timed out.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

task_idstringRequired

Response

Task status and result when succeeded

idstring

statusstring

modelstring or null

errorobject or null

created_atinteger or null

updated_atinteger or null

contentobject or null

seedinteger or null

resolutionstring or null

ratiostring or null

durationinteger or null

framesinteger or null

framespersecondinteger or null

generate_audioboolean or null

safety_identifierstring or null

priorityinteger or null

draftboolean or null

draft_task_idstring or null

service_tierstring or null

execution_expires_afterinteger or null

usageobject or null

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

502

Bad Gateway Error

$	curl https://api.meshapi.ai/v1/video/generations/task_id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"