Jabbertoon Make Cartoon API

openapi: 3.2.0
info:
  title: Jabbertoon tools for AI assistants and developers Make…
  version: '1'
  summary: Read Jabbertoon's guide, moves, characters and looks, check a cartoon, a move or a character you write, and make a jabbertoon.com link that opens a move or a character, or the cartoon in the studio.
  description: 'The same tools as Jabbertoon''s MCP server (https://jabbertoon.com/mcp), over plain HTTP. No key and no account. GET answers the read tools whose arguments are plain values; POST a JSON object of arguments to any tool. Nothing sent to validate or share_link is stored or logged; report_problem keeps its report for a person to read. Errors are {code, where, says, fix, url}, with did_you_mean and an RFC 6902 patch when the fix is certain. Making the video is done on your own computer, by the jabbertoon tool (preview, render_video). The block language: https://jabbertoon.com/docs/language/'
  contact:
    name: Jabbertoon
    email: hello@jabbertoon.com
    url: https://jabbertoon.com/for-ai/
  license:
    name: Proprietary, 1211 Holding LLC
    url: https://jabbertoon.com/license/
servers:
- url: https://jabbertoon.com
security: []
tags:
- name: Make Cartoon
paths:
  /api/make_cartoon:
    post:
      operationId: make_cartoon
      summary: Make a talking cartoon from a plain script, in one call
      description: 'The quickest way to a cartoon: send the script as people write one, a line each, Name: what they say, and get the jabbertoon.com link that opens it in the editor ready to play and to record as a video (free, no account). Read too: (happy, waves) in a line; [Leo walks to Mia] on a line of its own; Place: Beach (another later starts the next scene); Cast: Mia (cat). Our characters come by name (Sunny, Grump, Ria, Bob, Kiki) and a new name becomes one of our 3D cast. What was not used is in notes. Example: {"script": "Place: Beach\nMia (cat): (worried) Have you seen my hat?\nLeo: (looks around) Is it on that crab?"}.'
      security: []
      responses:
        '200':
          description: What make_cartoon answers. ok is false when what you sent has problems; they are listed with where, says and fix.
          content:
            application/json:
              schema:
                type: object
                required:
                - ok
                - url
                properties:
                  ok:
                    type: boolean
                  url:
                    type: string
                    description: The guide page on writing a cartoon's script.
                  kind:
                    type:
                    - string
                    - 'null'
                    description: 'world: a cartoon in the editor''s own file.'
                  link:
                    type: string
                    description: 'The link to give the person: it opens the cartoon in the editor.'
                  title:
                    type: string
                    description: The cartoon's name.
                  place:
                    type: string
                    description: Where it is (a place's id).
                  lines:
                    type: integer
                    description: How many lines are spoken.
                  scenes:
                    type: integer
                    description: 'How many scenes: more than one is a film, each scene its own place and cast.'
                  cast:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        as:
                          type: string
                          description: Which of our cast (young_woman, dog, pirate...) or narrator.
                    description: Who is in it.
                  world_file:
                    type: object
                    description: The editor's own file the script made, to change and send to share_link yourself.
                  errors:
                    type: array
                    items:
                      $ref: '#/components/schemas/Problem'
                    description: The errors, in order.
                  error_count:
                    type: integer
                    description: How many errors the checks found.
                  warnings:
                    type: array
                    items:
                      $ref: '#/components/schemas/Problem'
                    description: The warnings, in order.
                  warning_count:
                    type: integer
                    description: How many warnings the checks found.
                  engine:
                    $ref: '#/components/schemas/Engine'
                  notes:
                    type: array
                    items:
                      type: string
                    description: What was not used, and what the person does next.
                  error:
                    $ref: '#/components/schemas/Problem'
        4XX:
          $ref: '#/components/responses/Problem'
        5XX:
          $ref: '#/components/responses/Problem'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                script:
                  type: string
                  maxLength: 20000
                  description: 'The script: a line each, Name: what they say.'
                title:
                  type: string
                  maxLength: 60
                  description: 'Its name (else the script''s Title: line).'
                place:
                  type: string
                  maxLength: 60
                  description: 'Where it is, by name: Beach, City, Space, Old Keep... (else its Place: line, else the Meadow).'
                cast:
                  type: object
                  additionalProperties:
                    type: string
                  description: 'Who each name is: {"Mia": "cat", "Leo": "pirate"}.'
              required:
              - script
              additionalProperties: false
            example:
              script: 'Place: Beach

                Mia (cat): (worried) Have you seen my hat?

                Leo: Your hat? (looks around) Is it the one on that crab?

                Mia: (laughing) It looks better on the crab!

                Narrator: And so the crab kept the hat.'
      tags:
      - Make Cartoon
components:
  schemas:
    Problem:
      type: object
      required:
      - code
      - where
      - says
      - fix
      properties:
        code:
          type: string
        where:
          type:
          - string
          - 'null'
        says:
          type: string
        fix:
          type:
          - string
          - 'null'
        url:
          type: string
          description: The code's entry on https://jabbertoon.com/docs/errors/.
        did_you_mean:
          type: array
          items:
            type: string
        patch:
          type: array
          items:
            type: object
          description: RFC 6902 operations on what you sent that make the fix, given only when the fix is certain.
    Engine:
      type: object
      properties:
        version:
          type: string
          description: The block language's version.
        git:
          type: string
          description: The git tree id of the engine that answered (the same on every door).
  responses:
    Problem:
      description: 'A request the server cannot use (400 bad_arguments, 404 not_found, 405, 413 too_large, 415, 503 busy or timeout: try again after Retry-After).'
      content:
        application/json:
          schema:
            type: object
            required:
            - ok
            - url
            - error
            properties:
              ok:
                const: false
              url:
                type: string
              error:
                $ref: '#/components/schemas/Problem'
externalDocs:
  description: 'Developers: quickstart in curl, Python and JavaScript'
  url: https://jabbertoon.com/developers/
x-mcp:
  url: https://jabbertoon.com/mcp
  transport: streamable-http