List available models
https://api.imagemcpserver.com/playground/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. Authentication is optional here, but sending your key keeps the response consistent with what your account can use.
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 |
|---|---|---|
Authorization | string | Optional. Bearer <IMAGEMCP_API_KEY>. |
This endpoint takes no parameters — only the authorization header.
Examples
The same call in five forms. 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/playground/models" \
-H "Authorization: Bearer $IMAGEMCP_API_KEY"imagemcp.js models:listconst res = await fetch("https://api.imagemcpserver.com/playground/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/playground/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.