MorphogenDocs
API

Video content

GET /v1/videos/{id}/content: the MP4 file of a finished job.

GET/v1/videos/{id}/content

Returns the finished clip in MP4 format. The file is available when the job status is completed. Before that, the endpoint answers 404 video_not_ready. The file is stored until you delete the job with Delete video.

Headers

HeaderValue
AuthorizationBearer <key>. Required. x-api-key: <key> is accepted instead

Path parameters

idstringrequired

The job identifier, like video_….

The response comes with Content-Type: video/mp4. The Content-Length header may be missing, and partial download with Range is not supported.

Request example

curl https://api.morphogen.ru/v1/videos/video_7f3a91c2/content \
  -H "Authorization: Bearer $MORPHOGEN_API_KEY" \
  -o boat.mp4

Response example

HTTP/1.1 200 OK
Content-Type: video/mp4

<бинарные данные MP4>

Errors

401invalid_api_keyThe key is not found, disabled or expired.
404video_not_foundThere is no such job, or it belongs to another organization.
404video_not_readyThe job is not finished yet.

Other codes: Errors.

Video status

GET /v1/videos/{id}: the status of a generation job.

Delete video

DELETE /v1/videos/{id}: cancel a job or delete a finished file.

On this page

HeadersPath parametersRequest exampleResponse exampleErrors