roasOSAPI referenceScenes
Create a scene
View as MarkdownOpen in ClaudeOpen in ChatGPTConnect the roasOS MCP server: https://mcp.roasos.com/mcp
Deprecated
Authorization
bearerAuth AuthorizationBearer <token>
API key authentication. Use your API key as the bearer token: Authorization: Bearer roasos_sk_...
In: header
Header Parameters
Idempotency-Key*string
A unique string that makes retries safe. Any value 16-255 characters; reuse it only when retrying the exact same request.
Match
^[A-Za-z0-9._:-]+$Length
16 <= length <= 255X-RoasOS-Project?string
Optional label to group this request under one of your projects. Appears in your usage records.
Match
^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$Length
1 <= length <= 64X-RoasOS-Cost-Center?string
Optional label to attribute this request to a cost center. Appears in your usage records.
Match
^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$Length
1 <= length <= 64Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scenes" \ -H "Idempotency-Key: stringstringstri" \ -H "Content-Type: application/json" \ -d '{ "name": "Morning vanity", "prompt": "Premium skincare bottle on a warm stone vanity", "model": "nano-banana-pro", "resolution": "1K", "options": { "aspect_ratio": "9:16", "mode": "product" } }'{ "data": { "kind": "quote", "quote_id": "3c071a1d-db86-46a7-9dc8-72ba3fbca992", "reserved_credits": 1, "expires_at": "2019-08-24T14:15:22Z", "pricing_version": "string", "authorization": { "status": "auto_approved" }, "confirmation": { "generation_type": "image", "model": "string", "mode": "string", "resolution": "string", "output_count": 1, "duration_seconds": 1, "generate_audio": true, "reference_count": 0, "text_length": 0 } }}