Create

Create images from a text description. To learn more about the pricing for this endpoint, visit the pricing page.

POST https://api.reve.com/v1/image/create

Playground

API Key

Prompt

Aspect Ratio

16:93:24:31:13:42:39:16 auto

Version

latest

latest

latest-fast

reve-create@20250915

Test Time Scaling

Postprocessing

Add Post-processor

Generate Image

Result

Request Headers

• Authorization string required
  The API Key provided as a bearer token.

• Accept string
  One of image/png, image/jpeg, image/webp or application/json. For images, the response will be the bytes directly with the additional information provided as custom headers. For JSON, the response will be an object with the image base64 encoded (png) with additional information provided as separate properties.

Default: application/json

Request Body

• prompt string required
  The text description of the desired image. The maximum length is 2560 characters. This prompt will be automatically enhanced by the model.

• aspect_ratio string
  The desired aspect ratio of the generated image: One of 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, or 1:1.

Default: 3:2

• version string
  The specific model version to use when generating the image. Using latest will default to our most recently released image model. The only supported version strings are latest and reve-create@20250915.

Default: latest

• postprocessing array
  An optional argument. If you include it, the image will be processed further after generation. The supported postprocessing operations are:

• [{ "process": "upscale", "upscale_factor": 2 }] to upscale the image after generation. Supported upscale factors are 2, 3, and 4. Beware that a 4x upscaled image will be quite large.

  • [{ "process": "remove_background" }] to attempt to keep only the central subject, and make the background part of the image transparent.
  • [{ "process": "fit_image", "max_dim": 512 }] to resize the image to fit within specified dimensions while preserving aspect ratio. You can use max_dim to constrain the longest side, max_width to constrain width, or max_height to constrain height. At least one must be set. Maximum value for each is 4096. This operation has no additional cost.
  • [{ "process": "effect", "effect_name": "cmyk_halftone" }] to apply a post-processing effect to the image. Use the GET /v1/image/effect endpoint to list available effect names. You can optionally include effect_parameters to override default effect settings.

Postprocessing may add additional cost and processing time to the request in proportion to the size of the image (except for fit_image which is free). The best way to calculate exact cost is to send an example request and inspecting the credits_used field in the response.

Default: none

• test_time_scaling number
  An optional argument. If it is included, the model will spend more effort in an attempt at making better images. This will not make the request run slower. Any value above 1 will add additional API credits cost to the request in proportion to the scaling. Values between 1 and 15 are accepted, although values above 5 will only occasionally lead to noticeable improvements. The best way to calculate exact cost is to send an example request and inspecting the credits_used field in the response.

Default: 1

JSON Request

REVE_API_KEY=""

# Make the API request
curl -X POST https://api.reve.com/v1/image/create \
  -H "Authorization: Bearer $REVE_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A towering stack of golden fluffy pancakes drizzled with amber honey syrup, topped with fresh blackberries and sliced bananas, served on a white ceramic plate on a rustic wooden table with soft blue-gray background.",
    "aspect_ratio": "16:9",
    "version": "latest"
  }'

JSON Response Body (default)

For successful responses (200 status code)

• image string
  The base64 encoded image data. This will be empty if the request was not successful.

• version string
  The specific model version used in the generation process. For example, reve-create@20250915.

• content_violation boolean
  Indicates whether the generated image violates the content policy. True if there is a violation, False if there isn't.

• request_id string
  A unique id for the request.

• credits_used number
  The number of credits used for this request.

• credits_remaining number
  The number of credits remaining in your budget.

For failure (non-200 HTTP status code)

• error_code string
  The type of error. Could be strings like MISSING_REQUIRED_PARAMETER, etc.

• message string
  More information about the error that occurred.

• params object
  Specific parameters related to the error, if applicable.

Successful JSON Response (200)

// Status: 200
// Content-Type: application/json
// X-Reve-Content-Violation: false
// X-Reve-Request-Id: rsid-...

{
  "image": "...",
  "version": "reve-create@20250915",
  "content_violation": false,
  "request_id": "rsid-...",
  "credits_used": 18,
  "credits_remaining": 982
}

Image Response Body

For any response containing an X-Reve-Error-Code header, the response will be a small grey image in the format requested. Otherwise, successful responses (200 status code) with no content policy violations will return a base64 encoded image in the format requested.

Successful Image Response (200)

// Status: 200
// Content-Type: image/png (or image/jpeg, image/webp)
// Content-Length: ...
// X-Reve-Version: reve-create@20250915
// X-Reve-Content-Violation: false
// X-Reve-Request-Id: rsid-...
// X-Reve-Credits-Used: 18
// X-Reve-Credits-Remaining: 982

[Binary image data in the format requested]