file_… ids that you can attach directly to products, posts, and more.
How generation works
Most media calls don’t return the finished asset inline. They start a background Job and return a job you poll until it’s done.1
Start a generation
Call
POST /images/generate, POST /videos/generate, or POST /audio/generate. You get back a job.2
Poll the job
Poll
GET /jobs/{id} (or list with GET /jobs) until its status is terminal. The completed job references the resulting MediaLibrary file.3
Use the file
The output lands in your MediaLibrary as a
file_… id. Use it anywhere a file is accepted — e.g. a product’s images array.Generated media always lands in the MediaLibrary first. You attach the
file_… id — you never hand a raw CDN URL to a product or post.Pricing
Per-unit prices in USD. Pick a model with themodel parameter; omit it to use the default.
Images
Video
Audio (text-to-speech)
Images
POST /images/generate starts an image generation. The one thing that trips people up: the prompt goes under input: { prompt }, not at the top level. The input object is forwarded verbatim to the underlying model, so any model-specific fields go there too.
- cURL
- SDK (TypeScript)
- MCP (agent)
file_… id.
Edit, upscale, and stock
Video
POST /videos/generate follows the same shape family — choose a model from GET /videos/models, describe what you want, then poll for the result.
GET /videos/{id} (or GET /jobs/{id}) until the render is done. Video can take a while — these are long-running jobs.
Audio (text-to-speech)
POST /audio/generate turns text into a voiceover. Pricing is per 1,000 characters, so pass the text you want spoken.
GET /audio/{id} for the finished audio file.
Web tools
Beyond media, Crevio exposes a suite of live web operations — the same tools your AI Tasks use to research the open web. All are metered.POST /web/research is the heavyweight: give it a query and a depth, and it fans out searches, reads sources, and synthesizes a cited answer.
depth enum controls how hard it digs — at the cost of more credits and time:
Worked example: generate a product image and attach it
A common flow — create a draft product, generate a cover image, and attach it.1
Create a draft product
"id": "prod_abc123").2
Generate the cover image
3
Poll until the image is ready
file_def456).4
Attach the file to the product
images becomes the cover. An empty array clears the gallery.Next steps
Launch a paid course
Chain products, pricing, and checkout end to end.
Tasks
Hand web research and content jobs to your AI workforce.
Usage & billing
How metered credits are consumed per call.
Conventions
The rules every endpoint follows.

