List available models
https://api.imagemcpserver.com/v1/modelsReturns the models currently marked live for image output, ordered by priority. Each entry carries the costPerReq that model-priced tools bill, so an agent can pick a cheaper model when the balance is low. The call is free, but like every other /v1 endpoint it needs a key.
Overview
List every live image model you can pass as the model parameter, with its credit cost.
This endpoint never deducts credits.
Request
Headers
| Field | Type | Description |
|---|---|---|
Authorizationrequired | string | Bearer <IMAGEMCP_API_KEY>. The header x-api-key: <key> is accepted as an alternative. |
This endpoint takes no parameters — only the authorization header.
Examples
The same call in every form we support. The MCP tab is what an MCP client sends under the hood; the CLI tab is what an agent with the agent skill runs.
curl "https://api.imagemcpserver.com/v1/models" \
-H "Authorization: Bearer $IMAGEMCP_API_KEY"imagemcp.js models:listconst res = await fetch("https://api.imagemcpserver.com/v1/models", {
headers: { Authorization: `Bearer ${process.env.IMAGEMCP_API_KEY}` },
});
const data = await res.json();
console.log(data);import os
import requests
res = requests.get(
"https://api.imagemcpserver.com/v1/models",
headers={"Authorization": f"Bearer {os.environ['IMAGEMCP_API_KEY']}"},
timeout=30,
)
print(res.json()){
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_models",
"arguments": {}
}
}Response
Response fields
| Field | Type | Description |
|---|---|---|
count | number | Number of models returned. |
models[].modelId | string | Value to pass as the model parameter. |
models[].name | string | Human-readable model name. |
models[].costPerReq | number | Credits deducted per request on model-priced tools. |
models[].priority | number | Routing priority; higher sorts first. |
models[].isLive | boolean | Whether the model is currently selectable. |
{
"success": true,
"count": 3,
"models": [
{
"modelId": "google/gemini-2.5-flash-image",
"name": "Google: Gemini 2.5 Flash Image",
"costPerReq": 15,
"priority": 100,
"outputsSupported": ["image"],
"isLive": true
},
{
"modelId": "black-forest-labs/flux-1.1-pro",
"name": "Black Forest Labs: FLUX 1.1 Pro",
"costPerReq": 20,
"priority": 80,
"outputsSupported": ["image"],
"isLive": true
}
]
}When it fails
success: false with a message. See errors & troubleshooting for the status codes and whether a retry is worth it.FAQ
Which model is used when I omit the model parameter?
Requests fall back to google/gemini-2.5-flash-image. The same fallback applies when the model you pass is not an image model.
How do I know what a model will cost me?
Read costPerReq on the model entry. Model-priced tools deduct exactly that amount, or 15 credits when a model has no cost recorded.