# Tools Every tool is called the same way: `POST https://api.morigraph.com/v1/tools/{name}` with the arguments as the JSON body, or `morigraph call {name}`. The list your key can call, with current prices and whether your workspace has each tool switched on, always comes from the API: ```sh curl https://api.morigraph.com/v1/tools -H "Authorization: Bearer $MORIGRAPH_API_KEY" ``` The argument tables below are generated from the same schemas the service validates against. ## Arguments every tool takes Each tool can be served by more than one provider. These optional arguments steer the choice: | Argument | Values | Meaning | |---|---|---| | `cost` | `low`, `medium`, `high` | The most you will pay. Default `medium` | | `depth` | `basic`, `standard`, `premium` | The least quality you accept. Default `standard` | | `speed` | `fast`, `balanced`, `slow_ok` | How long you will wait. Default `balanced` | | `provider` | A provider key | Pin one provider. The tool's description from `GET /v1/tools` lists the keys | ## Files in and out - **Inputs.** An argument that takes a file, such as `image` or `source_image`, must be a public `https://` URL. Transcription is the one exception: it also accepts the file itself as the request body. Files saved in your workspace cannot be used with an API key. - **Outputs.** Generated images and videos are saved to your workspace's Files, where your team can see them, and the response carries a download link in `output.data`: `image_url` for images, `download_url` for videos. Links expire; `expires_at` says when. Download what you need to keep. ## Jobs A tool marked as returning a job answers with HTTP 202, `status: "pending"` and `job.id`. Check `GET /v1/jobs/{id}` until `status` is `completed` or `failed`, waiting at least five seconds between checks. Checking is free. Credits are reserved when the job starts and settled when it finishes; a failed job releases them. ## Web search: `web_search` `POST /v1/tools/web_search` | Argument | Type | Required | Description | |---|---|---|---| | `query` | string | yes | What to search for, as a natural question or keywords. | | `num_results` | integer | no | How many results (1-10). Default 5. | | `include_domains` | array of string | no | Only results from these domains. | | `exclude_domains` | array of string | no | Never results from these domains. | | `recency` | `day`, `week`, `month`, `year` | no | Only results newer than this. | | `contents` | `snippets`, `full` | no | Excerpts, or fuller page text where the provider supports it. | | `news` | boolean | no | Search news articles only, with publisher and date. Best with recency. Default `false`. | ## Image generation: `image_gen` `POST /v1/tools/image_gen` | Argument | Type | Required | Description | |---|---|---|---| | `prompt` | string | yes | What to generate, described in words. | | `model` | string | no | Pin an exact model from the provider offerings, e.g. dola-seedream-5-0-pro-260628 or seedream-5-0-lite-260128. | | `negative_prompt` | string | no | What to avoid, where the provider supports it. | | `size` | `square`, `portrait`, `landscape`, `wide` | no | Aspect of the image. Default `"square"`. | | `resolution` | `draft`, `standard`, `high` | no | draft is smallest and always fits a terminal host. Default `"standard"`. | | `n` | integer | no | How many images (1-4). Default `1`. | | `seed` | integer | no | For a reproducible image, where the model supports it. | | `want_link` | boolean | no | Prefer a provider that returns a hosted URL for the full render. Default `true`. | ## Image editing: `image_edit` `POST /v1/tools/image_edit` | Argument | Type | Required | Description | |---|---|---|---| | `image` | string | yes | The image to change: a Files id or filename (e.g. a photo the person sent, or an earlier render), or an https URL. Through the API: a public https URL only. | | `instruction` | string | yes | What to do, in the person's words: 'unblur this', 'make it 4x bigger', 'remove the background', 'take out the car', 'make the sky a sunset'. | | `operation` | `auto`, `enhance`, `upscale`, `remove_background`, `erase`, `edit` | no | enhance = upscale and clean up (it does not undo heavy motion blur); upscale = make it bigger; remove_background; erase = remove something (say what in target); edit = change or restyle it. auto picks from the instruction. Default `"auto"`. | | `target` | string | no | For erase, or an edit that swaps one thing: what in the image to find, e.g. 'the car'. | | `scene` | string | no | What the picture shows, in a few words, as you see it. For erase, describe it WITHOUT the thing being removed ('an empty canoe on a calm lake, pine forest'). Makes erase and edit far more faithful; pass it whenever you can see the image. | | `format` | `jpeg`, `png` | no | Output format. remove_background is always png (transparent). | ## Video generation: `video_gen` `POST /v1/tools/video_gen`. Returns a job. | Argument | Type | Required | Description | |---|---|---|---| | `task_mode` | `reference`, `edit` | no | reference creates a new video; edit (Seedance 2.5) modifies source_video and retains its duration/aspect. For edit, omit duration_seconds and aspect; use a 4–30 second source video. Default `"reference"`. | | `prompt` | string | no | Describe the video and motion. Required for a new generation. | | `model` | `dreamina-seedance-2-0-260128`, `dreamina-seedance-2-5-260628` | no | Pin an exact Seedance model. | | `duration_seconds` | integer | no | Default `4`. | | `aspect` | `16:9`, `9:16`, `1:1`, `adaptive` | no | Default `"16:9"`. | | `resolution` | `480p`, `720p` | no | Default `"720p"`. | | `source_image` | string | no | Original https provider image URL, asset:// provider asset ID, or workspace Files id/filename. Portrait acceptance is provider-controlled; same-account untouched Seedream originals may qualify. Through the API: a public https URL only. | | `source_images` | array of string | no | Ordered image references: 1–30 for Seedance 2.5, 1–9 for 2.0. Each accepts an https URL, asset:// ID or workspace Files id/filename. Always reference_image mode; cannot combine with source_image. Can combine with source_video. Refer to Image 1, Image 2 etc. in the prompt; portrait eligibility remains provider-controlled. Through the API: a public https URL only. | | `image_role` | `first_frame`, `reference_image` | no | Applies to singular source_image only. first_frame locks the opening image. reference_image supplies character/scene identity while the prompt defines a new outfit, pose or angle; use original eligible assets. Default `"first_frame"`. | | `source_video` | string | no | Https reference video URL, asset:// provider asset ID, or workspace Files id/filename, for identity, scene or motion reference. Through the API: a public https URL only. | | `return_last_frame` | boolean | no | Save the provider-returned final frame as an untouched image in Files, for eligible future references. This is not a locally extracted screenshot. Default `false`. | | `audio` | `false` | no | Silent output only in this release. Default `false`. | ## Transcription: `audio_transcribe` `POST /v1/tools/audio_transcribe` Send the audio one of two ways, the same two a transcription API such as Deepgram's takes: - **A link.** A JSON body with `url`, plus any options below. - **The file itself.** The file's bytes as the request body, with `Content-Type` set to its type (`audio/mpeg`, `audio/wav`, `video/mp4`, or `application/octet-stream`), up to 25 MB. Options go in the query string: `?language=en&diarize=false`. From the CLI: `morigraph call audio_transcribe --file meeting.mp3`. The price is per minute of audio, known before anything is charged because the recording is measured first. `output.text` is the transcript; `output.data.segments` has a start time, end time and speaker for each line. | Argument | Type | Required | Description | |---|---|---|---| | `url` | string | no | Public https link to an audio or video file. Up to 30 minutes and 100 MB. Leave it out when you upload the file as the request body. | | `language` | string | no | multi for supported mixed-language speech (default; excludes Mandarin), auto for single-language detection, or a supported language code. | | `diarize` | boolean | no | Return numbered speaker labels where detected; labels are not identities. Default `true`. | ## Web page scraping: `web_scrape` `POST /v1/tools/web_scrape`. Free. | Argument | Type | Required | Description | |---|---|---|---| | `urls` | array of string | yes | 1-10 public page URLs to read (http or https). | | `format` | `markdown`, `html` | no | Page text as markdown (default) or HTML. | | `links` | boolean | no | Also list the links on each page, to follow up. Default `false`. | | `focus` | string | no | A question: prefer answering passages when supported. If focused extraction is unavailable, return capped page text and say so. | | `max_chars` | integer | no | Characters of text per page (default 8000); longer pages are cut and say so. | ## Prediction markets: `prediction_markets` `POST /v1/tools/prediction_markets`. Free. | Argument | Type | Required | Description | |---|---|---|---| | `op` | `search`, `odds`, `history`, `orderbook` | yes | search = find open markets by words; odds = one event's current odds; history = how one outcome's odds moved; orderbook = bids and asks for one outcome. | | `query` | string | no | For search: the question in plain words, e.g. 'fed rate cut december'. | | `id` | string | no | For odds, history, orderbook: a market or outcome id from an earlier result, or a polymarket.com / kalshi.com link the user pasted. | | `venue` | `polymarket`, `kalshi` | no | Only this venue. Omit to search both. | | `limit` | integer | no | For search: events per venue (1-10, default 5). | | `range` | `1d`, `1w`, `1m`, `max` | no | For history: the window. Default `"1w"`. | ## Perpetual futures: `perpetuals` `POST /v1/tools/perpetuals`. Free. | Argument | Type | Required | Description | |---|---|---|---| | `op` | `markets`, `quote`, `funding`, `history`, `orderbook` | yes | markets = screen perps across venues; quote = one asset on every venue; funding = funding rates compared (optionally with history); history = price candles; orderbook = bids and asks. | | `asset` | string | no | The coin, e.g. 'ETH', 'pepe'. Venue symbols like 1000PEPEUSDT or kPEPE work too. | | `venue` | `hyperliquid`, `binance`, `bybit` | no | Only this venue. Omit for all three (history and orderbook default to hyperliquid). | | `sort` | `open_interest`, `volume`, `funding_high`, `funding_low`, `change` | no | For markets: how to rank. Default `"open_interest"`. | | `limit` | integer | no | For markets: rows (default 20, max 50). For history: candles (default 100, max 1000). | | `history_range` | `1d`, `1w`, `1m` | no | For funding: also return past funding over this window. | | `interval` | `1m`, `5m`, `15m`, `1h`, `4h`, `1d` | no | For history: candle size. Default `"1h"`. | ## Free tools Web page scraping and the two market-data tools cost no credits. They are rate limited instead: 10 calls a minute and 200 a day for each workspace, counted across all of its keys. Past the limit the API answers `429 rate_limited` with a `Retry-After` header. `GET /v1/tools` shows them with a price of 0, and the CLI does not ask for `--yes`. ## Not available Photo and video editing work on files saved in a workspace, which an API key cannot reach. They are available through the MCP connection. Text to speech is not launched yet. --- Canonical page: https://morigraph.com/docs/tools/ Updated: 2026-11-11 All developer docs: https://morigraph.com/docs.md · For AI agents: https://morigraph.com/docs/agents.md · OpenAPI: https://api.morigraph.com/openapi.json · Site overview: https://morigraph.com/llms.txt