---
title: "Start or price a guided draft"
method: POST
path: "/script/draft"
tags: ["Script"]
---

# Start or price a guided draft

`POST /script/draft`

## Request

- Base URL: `https://getziztu.com/api/v1`
- URL: `https://getziztu.com/api/v1/script/draft`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Story plan, scenes, editor pass. Returns a job: poll GET /projects/{pid}/script/jobs/{jid}. Needs max_credits (dry_run: true prices it; confirm: true above 500).

## Request body

- object
  - `idea` string
  - `format` 'short-film' | 'anime-ep' | 'ad' | 'youtube'
  - `project_id` string
  - `plan_only` boolean
  - `plan_job_id` string
  - `replace_existing` boolean
  - `max_credits` number
  - `confirm` boolean
  - `dry_run` boolean

## Response `200`

Quote (dry_run)

## Other responses

- `202`: Job 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)
