---
title: "Start a tool run"
method: POST
path: "/tools/{tool}/runs"
tags: ["Tools"]
---

# Start a tool run

`POST /tools/{tool}/runs`

## Request

- Base URL: `https://getziztu.com/api/v1`
- URL: `https://getziztu.com/api/v1/tools/{tool}/runs`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `tool` 'animate' | 'manga' | 'kamishibai' | 'manzai' | 'zukai', required

## Request body

- object
  - `prompt` string, required: What to make
  - `settings` object
  - `max_credits` number, required: Hard spend cap. Required.
  - `confirm` boolean: Required above 500 credits
  - `dry_run` boolean
  - `project_id` string
  - `title` string
  - `inputs` unknown[]
    - unknown

## Response `200`

Quote (dry_run)

## Other responses

- `202`: Run started

---

[API](https://skmtc.dev/getziztu/apis/ziztu-api.md) · [All operations](https://skmtc.dev/getziztu/apis/ziztu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getziztu/apis/ziztu-api/revisions/120b9e1e8f5e?raw)