API
Video status
GET /v1/videos/{id}: the status of a generation job.
GET
/v1/videos/{id}Returns the state of a job created with Create video. Poll the status every 10 seconds until it becomes completed or failed. Only the organization that owns the key sees the job.
Headers
| Header | Value |
|---|---|
Authorization | Bearer <key>. Required. x-api-key: <key> is accepted instead |
Path parameters
idstringrequiredThe job identifier from the POST /v1/videos response, like video_….
Statuses
| Status | Meaning |
|---|---|
queued | the job is in the queue |
in_progress | the model is generating the clip |
completed | the file is ready and can be downloaded |
failed | generation failed, the reason is in the error field |
Cancelling a job in the queue also shows as failed with the code cancelled. A job that did not finish within an hour gets failed with the code timeout. No money is charged for failed.
Request example
curl https://api.morphogen.ru/v1/videos/video_7f3a91c2 \
-H "Authorization: Bearer $MORPHOGEN_API_KEY"Response example
{
"id": "video_7f3a91c2",
"object": "video",
"model": "grok-imagine-video",
"status": "completed",
"seconds": "4",
"size": "854x480",
"created_at": 1760104212,
"usage": { "cost": "0.2" }
}A finished job has the usage.cost field: the generation cost at the provider in dollars, as a string. The price for your balance is shown in the operation history in the console.
Errors
401
invalid_api_keyThe key is not found, disabled or expired.404
video_not_foundThere is no such job, or it belongs to another organization.Other codes: Errors.