Skip to main content
POST
/
v1
/
jobs
/
submit
Gen 4 Image — Text to 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>",
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "style": "<string>",
    "diversity": 123
  }
}
'
{
  "jobId": "<string>",
  "status": "<string>",
  "estimatedCompletionTime": "<string>",
  "costMicroCents": 123
}
Generate images from text descriptions with Runway’s Gen 4 Image model. Supports multiple aspect ratios, resolution tiers, style presets, and diversity control.
PropertyValue
ProviderRunway
ModelGen 4 Image
CapabilityText 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/text-to-image for text-to-image generation.
input
object
required
Input parameters for text-to-image generation.
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/text-to-image",
    "input": {
      "prompt": "A futuristic cityscape at sunset with flying cars",
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "style": "vivid"
    }
  }'