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
}

POST

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.

Property	Value
Provider	Runway
Model	Gen 4 Image
Capability	Edit Image
Category	Image to Image
Base Cost	50,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.

Hide properties

prompt

string

required

Text description for editing the image.

image_urls

array

Reference image URLs for editing. Provide up to 3 image URLs. Max items: 3.

aspect_ratio

string

Output aspect ratio. Default: 16:9. Options: 16:9, 9:16, 1:1, 2:3, 3:2, 4:3, 3:4, 4:5, 5:4, 21:9.

resolution

string

Output resolution. Default: 720p. Options: 720p, 1080p.

style

string

Style preset for the edited image. Options: vivid, vivid-warm, vivid-cool, high-contrast, high-contrast-warm, high-contrast-cool, bw, bw-contrast, muted-pastel, dreamscape, nordic-minimal, light-anime, dark-anime, painted-anime, 3d-cartoon, sketch, low-angle, in-motion, terracotta.

diversity

integer

Controls output diversity. Range: 1–5. Higher values produce more varied results.

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

Factor	Option	Multiplier
Resolution	`720p`	1x
	`1080p`	1.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"
    }
  }'

Gen 4 Image — Text to Image Gen 4 Turbo Image

​Request Body

​Pricing

​Response

​Code Examples

Request Body

Pricing

Response

Code Examples