Creative Studio
Start Creative Studio generation
Start an asynchronous image or video generation.
Requires an API key with the creative:generate scope. Credits are checked before the job starts and charged when processing begins.
Authorization
bearerAuth AuthorizationBearer <token>
API key authentication. Create a key in your Account settings.
Pass the full key in the Authorization header:
Authorization: Bearer vsl_...Keys are shown only once at creation. Treat them like passwords.
In: header
Request 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
curl -X POST "https://example.com/v1/creative-studio/generations" \ -H "Content-Type: application/json" \ -d '{ "modelId": "nano-banana-2", "prompt": "A cinematic product photo on marble", "parameters": { "aspect_ratio": "1:1" } }'{ "id": "string", "status": "processing", "assetType": "image", "modelId": "string", "createdAt": "2019-08-24T14:15:22Z", "statusUrl": "http://example.com"}{ "error": { "code": "missing_api_key", "message": "string" }}{ "error": { "code": "missing_api_key", "message": "string" }}{ "error": { "code": "missing_api_key", "message": "string" }}{ "error": { "code": "missing_api_key", "message": "string" }}{ "error": { "code": "missing_api_key", "message": "string" }}{ "error": { "code": "missing_api_key", "message": "string" }}