general

Create a scientific figure

Generate a publication-ready scientific figure (mechanism or pathway diagram, workflow, study design, graphical abstract, schematic) from a description. Returns an image URL, or a figure_id to fetch with get_figure if it is still rendering. Not for plots of numeric data — write plotting code for those.

Discipline pack: general. Cost: 100 credits per finished figure (paid accounts only).

post/api/v1/create_figure

Request

  • Base URL: https://scholarmuse.ai
  • URL: https://scholarmuse.ai/api/v1/create_figure
  • Auth: HTTP bearer

Request body

descriptionstring required

What the figure shows: the entities, their relationships and the order of events. Be specific and scientifically precise.

kind'mechanism' | 'workflow' | 'graphical_abstract' | 'schematic' | 'poster_panel'

Figure type. Default: schematic.

style'nature' | 'cell' | 'minimal_line' | 'flat_color' | 'textbook'

Visual style. Default: nature.

labelsstring[]

Exact text labels to appear in the figure.

aspect_ratio'16:9' | '4:3' | '1:1' | '3:4' | '9:16'

Default 16:9 for graphical abstracts and workflows, otherwise 4:3.

Response

The tool result.

summarystring required
partialboolean
extraobject
credits_usednumber required
call_idstring required

Example response

{
  "billing": {
    "lowBalanceThreshold": 20
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.