POST
/
pub
/
v1
/
generations
/
estimate
curl --request POST \
  --url https://api.rendernet.ai/pub/v1/generations/estimate \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '[
  {
    "aspect_ratio": "1:1",
    "batch_size": 1,
    "cfg_scale": 7,
    "character": {
      "character_id": "chr_01",
      "weight": 0.6,
      "enable_facelock": true
    },
    "control_net": {
      "asset_id": "ast_01",
      "control_mode": 0,
      "name": "Normal",
      "resize_mode": 0
    },
    "facelock": {
      "asset_id": "ast_01"
    },
    "loras": [
      {
        "name": "lora_name",
        "weight": 0.5
      }
    ],
    "model": "JuggernautXL",
    "narrator": {
      "image_asset_id": "ast_imgxxxxx",
      "video_asset_id": "ast_vidxxxxx",
      "audio_asset_id": "ast_audxxxxx",
      "script": "Thank you for trying Narrator",
      "voice": "Rachel"
    },
    "prompt": {
      "negative": "nsfw, deformed, extra limbs, bad anatomy, deformed pupils, text, worst quality, jpeg artifacts, ugly, duplicate, morbid, mutilated",
      "positive": "a man looking into the camera"
    },
    "quality": "Plus",
    "sampler": "DPM++ 2M Karras",
    "seed": 1234,
    "segment": {
      "asset_id": "ast_01",
      "find": "red shirt",
      "replace": "blue shirt"
    },
    "steps": 20,
    "style": "Bokeh",
    "style_detail": {
      "name": "Black & White",
      "base_model": "flux"
    },
    "true_touch": {
      "asset_id": "ast_01",
      "enhance_strength": 0.5,
      "scale_factor": 1.5
    },
    "video_anyone": {
      "media_id": "ast_01",
      "prompt": "Camera static, a woman riding a bicycle",
      "duration": 5
    }
  }
]'
{
  "data": {
    "estimated": 5,
    "balance": 20
  },
  "error": {}
}

Headers

​
X-API-KEY
string
required

API key needed to access our public endpoints. You can find yours under the 'Account' section of the website

Body

application/json · object[]
​
aspect_ratio
enum<string>

The aspect ratio of the image for the generation

Available options:
1:1,
2:3,
3:2,
4:5,
16:9,
9:16
Example:

"1:1"

​
batch_size
integer

The batch size of the generation (Max permissible value depends on your subscription plan). Visit RenderNet pricing for more details

Example:

1

​
cfg_scale
number

AI guidance for this generation. Higher the value, the output will be closer to the prompt (but may result in distorted images after a point)

Required range: 4 <= x <= 12
Example:

7

​
character
object

If you want to create images of a character, use the character’s name in the positive prompt. Example: {character_name} riding a bike

​
control_net
object

The control net(pose control) for the generation if you want to use (optional)

​
facelock
object

The face you want to restore for the generation if you want to use (optional)

​
loras
object[]

Query the list resources endpoint GET /pub/v1/loras to view all available LoRAs. You can add multiple LoRAs to a single generation. Make sure your LoRAs have the same base model (SD 1.5 / SDXL) as your selected style/model.

​
model
string

Query the list models endpoint GET /pub/v1/models to view all available models.

Example:

"JuggernautXL"

​
narrator
object

For Narrator generation, pass either script or audio_asset_id along with other required details in narrator payload.

​
prompt
object

The prompt for the generation

​
quality
enum<string>

The quality of the image for the generation (Case Sensitive)

Available options:
Plus,
Regular
Example:

"Plus"

​
sampler
enum<string>

The sampler you want to use for the generation (Case Sensitive)

Available options:
DPM++ 2M Karras,
DPM++ 2M SDE Karras,
DPM++ 2S a Karras,
DPM++ SDE,
DPM++ SDE Karras,
Euler a
Example:

"DPM++ 2M Karras"

​
seed
integer

The seed for the generation (randomized if you don't want to use a seed)

Example:

1234

​
segment
object

Changes the input asset image based on the find and replace prompts

​
steps
integer

The number of steps you want AI to take for the generation

Required range: 10 <= x <= 30
Example:

20

​
style
string

Query the list styles endpoint GET /pub/v1/styles to view all available styles.

Example:

"Bokeh"

​
style_detail
object

Query the list styles endpoint GET /pub/v1/styles to view all available styles.

​
true_touch
object

Enhances and upscales the input image passed in the asset_id

​
video_anyone
object

Convert image to video seamlessly.

Response

200 - application/json
The estimated credits for the generation
​
data
object
​
error
object

The error if the request was not successful