Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/shapelessai:shapelessai-images-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: ShapelessAI Images API
version: '1'
description: 'The social media team an agent can call. Publish to LinkedIn, X, Instagram, TikTok, YouTube, Facebook, Threads, Bluesky, Reddit, Mastodon, Telegram, Discord and Pinterest, with each network''s limits checked first; make images, AI video, edits of your own footage, carousels, thumbnails, recorded product demos, speech and subtitles, one call each; or hand the whole goal to the agent team as a job. Every refusal says what to do next (a connect link, a checkout link, the question to ask). Bearer API key (Settings -> API keys) or the hosted MCP''s OAuth token. Read the docs live, not from memory: https://shapelessai.com/llms-full.txt is every docs and capability page in one fetch, prose at https://shapelessai.com/docs. What exists and what is planned: https://shapelessai.com/api/capabilities (an x-status: planned operation answers 501 with a want door).'
servers:
- url: https://shapelessai.com
tags:
- name: Images
paths:
/api/images:
post:
summary: 'Generate an image (tool generate_image): {name, prompt, aspectRatio, size?…'
operationId: postImages
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
name:
type: string
description: A 2-6 word filename for this image, the way you would describe it to a colleague - e.g. "founder desk golden hour". Becomes the file the user sees in their Assets.
prompt:
type: string
description: The full scene as 2-5 sentences of flowing prose, directing medium, subject, setting, light, and composition — YES "A photorealistic overhead shot of a cluttered founder desk at golden hour, one glowing laptop as the focal point, deep negative space on the right", NOT "desk, laptop, startup, 4k, trending, professional". When reference_keys are given, also say what each referenced object does in the scene.
aspectRatio:
type: string
enum:
- '1:1'
- '4:5'
- '3:4'
- '16:9'
- '9:16'
description: 'LinkedIn feed image: 4:5. Wide header: 16:9.'
size:
type: string
enum:
- 1K
- 2K
description: 1K draft, 2K final.
quality:
type: string
enum:
- standard
- premium
description: standard = the default model (default). premium = the fidelity escalation, several times the price.
reference_keys:
type: array
items:
type: string
description: 'Up to 6 media keys to condition on: brand-asset keys from the digest, mediaKeys of earlier generated images, or chat-upload keys. Omit for a purely imagined scene.'
budgetUsd:
type: number
description: The most this call may spend, in USD (default 2, max 10). Held while the tool runs, released after.
required:
- name
- prompt
- aspectRatio
x-tool: generate_image
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ToolResult'
'400':
description: The input does not match the tool's schema; the message names the field.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: No credential, or not valid.
'402':
description: Not enough credit to hold budgetUsd, or the call costs more than budgetUsd.
content:
application/json:
schema:
$ref: '#/components/schemas/NoCredit'
'403':
description: The key is missing the "write" scope.
'404':
description: No such tool on this deployment.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'422':
description: The tool refused this input; nothing was charged.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Over the key's rate limit (600 requests an hour).
'502':
description: The tool failed; nothing was charged.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
security:
- apiKey:
- write
- oauth:
- write
x-scope: write
x-status: live
tags:
- Images
components:
schemas:
ToolResult:
type: object
properties:
tool:
type: string
output:
description: The tool's own result; media it made is named by mediaKey.
media:
type: array
items:
type: object
properties:
key:
type: string
url:
type: string
format: uri
description: Every media key the output names, with the URL that streams it (read scope). Put a key on a post's mediaKeys.
chargedUsd:
type: number
required:
- tool
- output
- media
- chargedUsd
Upgrade:
type: object
description: Links a person clicks to pay. Every 402 carries one.
properties:
pricing:
type: string
format: uri
checkout:
type: array
items:
type: object
properties:
tier:
type: string
name:
type: string
priceUsd:
type: number
monthlyCreditUsd:
type: number
url:
type: string
format: uri
required:
- tier
- name
- priceUsd
- monthlyCreditUsd
- url
required:
- pricing
- checkout
NoCredit:
type: object
description: 'Out of credit. Hand upgrade.pricing (or one checkout url) to the human: one click signs in and pays.'
properties:
error:
type: string
code:
type: string
upgrade:
$ref: '#/components/schemas/Upgrade'
required:
- error
- upgrade
Error:
type: object
properties:
error:
type: string
required:
- error
securitySchemes:
apiKey:
type: http
scheme: bearer
description: slk_... key; scopes read, write, publish.
oauth:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://shapelessai.com/api/auth/mcp/authorize
tokenUrl: https://shapelessai.com/api/auth/mcp/token
scopes:
read: Read anything the account holds.
write: 'Create and edit: jobs, drafts, agents, Brand Memory.'
publish: Anything that goes out to a platform, or spends.
wiki: Write to the wiki at /vizipedia as this account, and nothing else. A key with `write` covers it.