roasOSList ad formats
Every ad format roasOS makes: video formats, product effects, TikTok slideshows and statics. Each format has its premise, its beats, how to shoot it, what breaks it, what it needs, its default model roles (resolve them in `GET /v1/catalog` roles) and the pack skill that runs it. Ask for a format by name in `POST /v1/agent/completions`. This call is free.
Every ad format roasOS makes: video formats, product effects, TikTok slideshows and statics. Each format has its premise, its beats, how to shoot it, what breaks it, what it needs, its default model roles (resolve them in GET /v1/catalog roles) and the pack skill that runs it. Ask for a format by name in POST /v1/agent/completions. This call is free.
Authorization
bearerAuth API key authentication. Use your API key as the bearer token: Authorization: Bearer roasos_sk_...
In: header
Response Body
application/json
curl -X GET "https://example.com/v1/formats"{ "data": { "registry_version": "string", "formats": [ { "id": "string", "name": "string", "kind": "video", "aliases": [ "string" ], "premise": "string", "beats": [ "string" ], "shoot": "string", "avoid": "string", "needs": { "product": true, "person": true }, "aspect": "string", "duration_sec": 0, "roles": { "video": "string", "image": "string" }, "skill": "string", "starter": "string" } ] }}Get the model catalog
Every model roasOS can run, with its modes, request fields, credit examples, provider endpoints, and prompt guide. This is the source of truth for enums and prices.
Get one catalog model
One model from the catalog. A few model ids exist in several families (nano-banana-pro is an image, a scene, and an avatar model); read those as /v1/catalog/{family}/{model}.