Build against Cannon Studio with a clear async request model.
Cannon Studio exposes 19 documented API operations across prompt enhancement, image generation, video generation, audio, and post-production workflows. Submit work once, poll a stable request URL, and consume the final hosted asset or prompt output when the request reaches a terminal state.
Start here
Create a key and verify your connection with the status endpoint.
Validate a key and read current credits without creating work.
Use a single API key in either the `x-api-key` header or a bearer token.
Submit async work only after the status check passes.
What the API covers
Cannon Studio's developer platform is an async media generation API for applications, internal tools, and creative automation pipelines. The docs cover a single request contract for prompt enhancement, image generation, video generation, music, narration, sound effects, image edit, lip sync, subtitles, smart motion, and video upscale workflows.
Image and video generation endpoints, plus image editing, with the same request object and result polling model.
Generate Video, Generate Image, Edit Image, Generate Sora 2 Character Video, Create Sora 2 Character.
Prompt rewrite endpoints for image, video, location, and variant workflows when you want cleaner inputs before generation.
Enhance Video Prompt, Enhance Image Prompt, Enhance Location Prompt, Enhance Variant Prompt.
Music, narration, and sound effect generation for products or pipelines that need hosted audio output.
Generate Music, Generate Narration, Generate Sound Effects.
Finishing workflows such as lip sync, subtitles, smart motion, and video upscale through the same API contract.
Generate Lip Sync, Generate Subtitles, Generate Smart Motion, Upscale Video, Edit Sora 2 Video, Extend Sora 2 Video, Remix Sora 2 Video.
How integrations usually work
Call `GET /api/v1/status` to confirm the API key is wired and read available credits.
Create every job through `POST /api/v1/requests`, including prompt, media, audio, and finishing operations.
Poll `GET /api/v1/requests/{requestId}` or receive webhook events until the request reaches `succeeded` or `failed`.
Common developer use cases
Add image generation, video generation, prompt enhancement, or narration to your own app without stitching together multiple model-specific APIs.
Route requests through a single async contract for batch generation, editorial review, and downstream asset handling.
Chain lip sync, subtitles, smart motion, or video upscale jobs after generation while preserving a consistent request lifecycle.
Developer FAQ
What kind of API is Cannon Studio exposing?
Cannon Studio exposes an async REST API centered on request objects. You submit work to POST /api/v1/requests, then poll or receive webhook updates until the request reaches a terminal state.
Which workflows are covered in the developer docs?
The docs cover prompt enhancement, image generation, video generation, music, sound effects, narration, image edit, lip sync, subtitles, smart motion, and video upscale workflows.
Do these docs include a machine-readable schema?
Yes. The OpenAPI document at /api/v1/openapi is available for typed clients, internal tooling, and endpoint discovery.