Skip to main content
POST
/
v1
/
jobs
/
submit
Submit Job
curl --request POST \
  --url https://api.muvi.video/v1/jobs/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {
    "prompt": "<string>"
  }
}
'
{
  "jobId": "<string>",
  "requestId": "<string>",
  "status": "<string>",
  "estimatedCompletionTime": "<string>",
  "costMicroCents": 123
}

​
Authentication

This endpoint requires an API key with the submit_job scope. 
Authorization: Bearer YOUR_API_KEY

​
Request Body

​
model
string
required
The model slug to use for generation. Example: "google/veo-3.1-fast/text-to-video"
​
version
string
Optional model version. If omitted, the latest stable version is used.
​
input
object
required
Model-specific input parameters. The structure depends on the selected model. See the Video Models and Image Models pages for model-specific “Try it” panels with pre-filled parameters.
​
webhookUrl
string
An HTTPS URL to receive a webhook notification when the job completes or fails. Must use the https:// scheme.

​
Response

​
jobId
string
Unique identifier for the submitted job.
​
requestId
string
Unique request identifier for tracing and support purposes.
​
status
string
Initial job status. Always "pending" on successful submission.
​
estimatedCompletionTime
string
ISO 8601 timestamp of the estimated completion time.
​
costMicroCents
number
The cost of the job in micro-cents (1/1,000,000 of a dollar).

​
Error Codes

CodeDescription
MODEL_NOT_FOUNDThe specified model slug does not exist or is not available.
INSUFFICIENT_BALANCEYour account does not have enough credits to submit this job.
INVALID_INPUTThe input object does not match the model’s expected schema.
CONCURRENT_JOBS_EXCEEDEDYou have reached the maximum number of concurrent jobs for your plan.
MODEL_ACCESS_DENIEDYour API key does not have access to the requested model.
PUBSUB_PUBLISH_FAILEDInternal error while queuing the job. Please retry.

​
Examples

curl -X POST https://api.muvi.video/v1/jobs/submit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3.1-fast/text-to-video",
    "input": {
      "prompt": "A cinematic drone shot of a mountain landscape at sunset"
    },
    "webhookUrl": "https://example.com/webhooks/pixelbyte"
  }'

​
Example Response

{
  "jobId": "job_abc123def456",
  "requestId": "req_789xyz",
  "status": "pending",
  "estimatedCompletionTime": "2026-02-18T15:30:00Z",
  "costMicroCents": 500000
}