generate-image
/api/v1/generate-image
3 credits/call
examples
images
Generate an image from a text prompt. Returns a JobHandle; poll the get-job-status tool with the returned job_id (every 1-2s) until status is 'completed'. 3 credits per call.
Sign in + create an API key on the keys page to authenticate calls.
curl -X POST https://api.fulcrumgo.com/api/v1/generate-image \
-H "Authorization: Bearer mcpsk_<your_api_key>" \
-H "Content-Type: application/json" \
-d '{
"prompt": "",
"size": "1024x1024",
"style": "photoreal"
}'
Add this server to Claude Desktop's claude_desktop_config.json. The endpoint becomes a callable tool inside Claude. See the MCP setup guide for the full walk-through.
{
"mcpServers": {
"this-api": {
"url": "https://api.fulcrumgo.com/mcp",
"transport": "http",
"auth": {
"type": "bearer",
"token": "mcpsk_<your_api_key>"
}
}
}
}
Inside Claude this endpoint surfaces as the tool generate-image.
Standard requests — no custom SDK needed. pip install requests first.
import requests
r = requests.post(
"https://api.fulcrumgo.com/api/v1/generate-image",
headers={"Authorization": "Bearer mcpsk_<your_api_key>"},
json={
"prompt": "",
"size": "1024x1024",
"style": "photoreal"
},
)
r.raise_for_status()
print(r.json())
Plain fetch. Works in Node 18+, Deno, Bun, and any modern browser.
const r = await fetch("https://api.fulcrumgo.com/api/v1/generate-image", {
method: "POST",
headers: {
"Authorization": "Bearer mcpsk_<your_api_key>",
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "",
"size": "1024x1024",
"style": "photoreal"
}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());
Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| prompt | string | required | — |
What to draw, in natural language.
maxLength=1000
minLength=1
|
| size | string | optional | 1024x1024 |
Output size in pixels (WxH). Common: 512x512, 1024x1024, 1024x1536.
pattern=^\d{2,4}x\d{2,4}$
|
| style | string | optional | photoreal | Style preset (photoreal / illustration / pixel-art / line-art). |
Output
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| job_id | string | required | — | |
| status | string | required | — | |
| status_url | string | required | — |
Try it
Fires a real POST /api/v1/generate-image from your browser. Charges 3 credits per call against your account.