ShapelessAI Images API

The Images API from ShapelessAI — 1 operation(s) for images.

GitHub OpenAPI

Operations 1

POST /api/images Generate an image (tool generate_image): {name, prompt, aspectRatio, size?… #

Work with this as data

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 Specification

shapelessai-images-api-openapi.yml Raw ↑
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.