> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://onepin.ai/docs/guides/use-your-own-script/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://onepin.ai/_mcp/server.

# Use your own script

Pass `script_text` when you start a run to speak your own text. The override applies to **that run only** — the stored workflow isn't changed, so concurrent runs with different scripts never collide. This is the pattern for agent-style callers: configure a workflow once, then send text per request.

#### Python

```python
run = client.workflows.runs.start(
    workflow_id,
    script_text="Hello! Your meeting starts in ten minutes.",
    source_language="en-us",
).data
```

#### CLI

```bash
onepin workflows run "$WORKFLOW_ID" \
  --script "Hello! Your meeting starts in ten minutes." \
  --source-language en-us --watch
```

`source_language` is optional — omit it to use the workflow's saved language. The workflow must have exactly one script node (a `422` explains it otherwise).

To change the voice or add languages instead, edit the workflow's [definition](/docs/workflow/overview).

## Related

* [Run a workflow](/docs/guides/run-a-workflow) — start, watch, download
* [Workflow](/docs/workflow/overview) — script and voice nodes

> Onepin is a voice workflow platform that orchestrates, validates, and ships production-ready audio across 33 TTS models.