How much does the Image 2 PRO API cost?

The default 1 image at 2K costs 4 credits, about $0.08 at the shared USD reference. Read the live models endpoint before submitting.

Which inputs does Image 2 PRO accept?

It accepts a prompt, listed size and aspect ratio, and an image count from 1 to 4 subject to the model limit. Reference inputs are not available through this v1 endpoint.

How do I retrieve Image 2 PRO output?

Poll the returned status URL until the job is ready, then download the signed output URL or URLs before they expire.

REVIRALAPI DOCS

OpenAPI Status Support Get API key

Browse API docs

Models · Image

Image 2 PRO API

Was this page helpful?

Image 2 PRO is good for generating still images when you need its listed output sizes and aspect ratios.

Pricing

Default example: 1 image at 2K costs 4 credits, or $0.08 at the shared USD reference.

Resolution	Unit	Credits	USD
2K	Per image	4 cr	$0.08
4K	Per image	4 cr	$0.08

Accepted inputs

Kind: image
Durations: Not applicable
Resolutions: 2K, 4K
Aspect ratios: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 9:21
Defaults: 2K · 1:1 · count 1

Sample request

The request uses the current default settings for this model and the public GenerateMediaRequest schema.

curl -X POST "https://reviral.ai/api/v1/generate-media" \
  -H "Authorization: Bearer $REVIRAL_API_KEY" \
  -H "Idempotency-Key: first-video" \
  -H "Content-Type: application/json" \
  --data '{"model":"image-2-pro","prompt":"A clean product photograph on a warm neutral background","size":"2K","aspectRatio":"1:1","count":1,"maxCredits":4}'

Response and output

Accepted job

{
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "kind": "image",
    "model": "image-2-pro",
    "creditsCharged": 4,
    "status": "queued",
    "statusUrl": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000"
  }
}

Ready job

{
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "kind": "image",
    "model": "image-2-pro",
    "creditsCharged": 4,
    "status": "ready",
    "statusUrl": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000",
    "outputUrls": [
      "https://reviral.ai/signed-output"
    ]
  }
}

Error cases

404 model_not_available: the ID is no longer in the live catalog.
409 price_changed: the current cost differs from maxCredits.
422 validation_error: duration, resolution, aspect ratio, size, or count is not accepted.
429 rate_limit_exceeded: wait for Retry-After before retrying.

Frequently asked questions

How much does the Image 2 PRO API cost?: The default 1 image at 2K costs 4 credits, about $0.08 at the shared USD reference. Read the live models endpoint before submitting.
Which inputs does Image 2 PRO accept?: It accepts a prompt, listed size and aspect ratio, and an image count from 1 to 4 subject to the model limit. Reference inputs are not available through this v1 endpoint.
How do I retrieve Image 2 PRO output?: Poll the returned status URL until the job is ready, then download the signed output URL or URLs before they expire.

All models Generate media Credits and pricing