orc creative
orc creative calls the Creative API (/v1/creative) from the terminal. Generate images, video and speech, then check each job's status and artifacts. CI and scripts run the same commands.
Install
curl -fsSL https://orchestor.io/install | shFor Windows and npm, see Installation.
Quickstart
Sign in:
orc auth loginGenerate an image, wait for it to finish, and print the artifacts:
orc creative image generate --model gpt-image-2 --prompt "A red cube on a white background" --waitIn CI and scripts, set an API key in ORCHESTOR_API_KEY. The API key takes precedence over a stored sign-in. Browser dashboard sessions are not accepted on /v1/creative.
export ORCHESTOR_API_KEY="<API key>"How generation works
Generation is an asynchronous job.
- Pick a model, for example with
orc creative image models list. - Create the job with
image generate,video generate,tts generateorvoice change. Add--idempotency-keyto resend the same input safely. - With
--wait, the CLI waits until the job isCOMPLETED,FAILEDorCANCELED, then prints the artifacts. Tune it with--timeoutand--poll-interval. - Without
--wait, read the state withorc creative jobs status <id>and the artifacts withorc creative jobs result <id>. You can also receive completion at--webhook-url.
To use a local file as input, issue an upload URL with orc creative files upload-url create and pass the returned public URL to the input.
Commands
| Command | What it does |
|---|---|
orc creative image | List image models and generate images |
orc creative video | List video models and generate videos |
orc creative tts | List speech models and voices and generate speech |
orc creative voice | Convert the voice in audio or video |
orc creative jobs | Check job status, artifacts and history, and cancel jobs |
orc creative files | Issue upload URLs for input files |
orc creative webhooks | Get and rotate the webhook signing secret |
Every command accepts global options such as --json and --workspace.
Models
Available models and prices depend on the Workspace. Check them with models list before generating.
orc creative image models list
orc creative video models list
orc creative tts models listPer-model input parameters and pricing shapes are in Models.
Pricing
You pay for the jobs you generate. See Models for per-model pricing shapes and Billing and retention for failed and canceled jobs.