Skip to main content
POST
/
v1
/
jobs
/
submit
Gen 4 Image — Edit Image
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>",
    "image_urls": [
      {}
    ],
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "style": "<string>",
    "diversity": 123
  }
}
'
{
  "jobId": "<string>",
  "status": "<string>",
  "estimatedCompletionTime": "<string>",
  "costMicroCents": 123
}
Edit and transform existing images using Runway’s Gen 4 Image model. Provide reference images along with a text prompt to guide the editing process.
PropertyValue
ProviderRunway
ModelGen 4 Image
CapabilityEdit Image
CategoryImage to Image
Base Cost50,000 micro-cents/request ($0.05)
Processing Time~30 seconds

​
Request Body

​
model
string
required
Model slug. Use runway/gen-4-image/edit-image for image editing.
​
input
object
required
Input parameters for image editing.
​
webhookUrl
string
HTTPS URL to receive a webhook notification when the job completes or fails.

​
Pricing

Base cost: 50,000 micro-cents per request ($0.05) 
finalCost = baseCost × resolution
FactorOptionMultiplier
Resolution720p1x
1080p1.6x
Default cost: 720p resolution = 50,000 × 1 = 50,000 micro-cents ($0.05)1080p cost: 50,000 × 1.6 = 80,000 micro-cents ($0.08)

​
Response

​
jobId
string
Unique identifier for the submitted job.
​
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.

​
Code Examples

curl -X POST https://api.muvi.video/v1/jobs/submit \
  -H "Authorization: Bearer $PIXELBYTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway/gen-4-image/edit-image",
    "input": {
      "prompt": "Edit an image by replacing the background",
      "image_urls": ["https://example.com/your-image.jpg"],
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "style": "vivid"
    }
  }'