List Image Model Endpoints

GET /v1/images/models/{author}/{slug}/endpoints No API key needed View .md

The endpoint record of one image model, the endpoints link of its list entry. author is not checked; the gateway's model ids have none, and vultr is the documented one. allowed_passthrough_parameters are the names the model takes under provider.options (vultr or any other slug, flat or under parameters; OpenRouter's SDKs keep only stealth): every declared parameter and alias, steps included. They are also accepted at the top level of the request.

Path parameters

author string required
slug string required

Responses

application/json · image-model-endpoints-response

2 fields

id string required
endpoints array of objects required
13 fields
- provider_name string
- provider_slug string
- provider_tag string or null
- supported_parameters object
- allowed_passthrough_parameters array of strings
- passthrough_parameters object
  
  What each provider option takes.
- pricing array of objects
  3 fields
  - billable string
  - cost_usd number
    
    Dollars per unit.
  - unit string
- supports_streaming boolean
- quality_tiers array of objects or null
  
  Not in OpenRouter's record: the values of quality that select a tier, null for a model that ignores quality (RND-400).
  6 fields
  - name string
  - steps integer or null
    
    The base steps the tier runs; null for the tier that runs the model's own Turbo schedule.
  - step_range object or null
    
    The steps counts billed at the tier, first to last; null for the Turbo tier.
    
    2 fields
    
    min integer
    
    max integer
  - multiplier number
    
    Megapixels billed per megapixel of output.
  - aliases array of strings
  - price_per_megapixel string or null
- prompt_max_length integer or null
  
  The most characters prompt may have.
- inputs object or null
  
  The media a request may carry; null for a model that takes none (a request with an image or a mask is a 400).
  2 fields
  - reference object
    
    Reference images (input_references, image[] on /v1/images/edits, or images).
    
    5 fields
    
    image integer
    
    The most reference images a request may carry.
    
    formats array of strings
    
    The image types read as references, by their bytes.
    
    max_megapixels number or null
    
    The gateway scales a larger reference down to this many megapixels before the engine gets it; null for as sent.
    
    max_bytes integer
    
    The most bytes one image may have (a larger one is a 413).
    
    max_total_bytes integer
    
    The most bytes the images of a request may have together.
  - mask object
    
    The model takes a mask beside its references.
    
    1 field
    
    formats array of strings or null
- modes array of objects
  
  The model's modes in the order they are tried; the first whose when holds is the request's.
  6 fields
  - mode string
  - when object
    
    What selects the mode: inputs, media kinds that must all be present; parameters, values the request sent. Empty for the last mode, which takes the rest.
  - defaults object
    
    Parameter defaults the mode sets, by parameter name.
  - also object
    
    Values a parameter takes in this mode beside its range (minimax-h3: steps 8 with references, 4 without).
  - only object
    
    Values the mode holds a parameter to; anything else sent is a 400.
  - bill_multiplier object or null
    
    The megapixels a request in this mode bills are multiplied by base plus per_reference times the image references sent.
    
    2 fields
    
    base number
    
    per_reference number
- rules array of objects
  
  What a parameter value does to the others.
  3 fields
  - when object
    
    The parameter values that bring the rule in.
  - require object
    
    Values another parameter must then take; an unsent one takes the first.
  - refuse array of strings
    
    Parameters the request may not send then.

curl https://api.vultrinference.com/v1/images/models/vultr/z-image-turbo/endpoints

import requests

response = requests.get(
    "https://api.vultrinference.com/v1/images/models/vultr/z-image-turbo/endpoints",
)
print(response.json())

const response = await fetch("https://api.vultrinference.com/v1/images/models/vultr/z-image-turbo/endpoints");
console.log(await response.json());

Response · 200

{
    "id": "string",
    "endpoints": [
        {
            "prompt_max_length": 4000,
            "inputs": {
                "reference": {},
                "mask": {}
            },
            "modes": [
                {}
            ],
            "rules": [
                {}
            ]
        }
    ]
}