Skip to main content
POST
/
api
/
partner
/
v1
/
studio
/
images
/
generate
{
  "model_id": "google/nano-banana",
  "prompt": "A cinematic beach sunset with palm trees",
  "params": {
    "aspect_ratio": "16:9",
    "output_format": "jpeg"
  }
}

{
  "ok": true,
  "code": 201,
  "message": "Image generated",
  "data": {
    "file_id": "11111111-1111-1111-1111-111111111111",
    "output_url": "https://cdn.example.com/partner-api/workspaces/ws_1/studio/images/image-123.jpeg",
    "preview_url": "https://cdn.example.com/partner-api/workspaces/ws_1/studio/images/image-123.jpeg",
    "provider": "fal",
    "model_id": "google/nano-banana",
    "credits_used": 1
  }
}
Generate one image synchronously and return its hosted output URL.

​
Body Parameters

​
model_id
string
required
Image model ID from Get Studio Models.
​
prompt
string
required
Generation prompt.
​
image_urls
string[]
Optional input/reference image URLs. Genviral may mirror public reference URLs to its own CDN before handing them to the upstream model so image-edit requests are less sensitive to third-party hotlinking or fetch-policy issues.
​
params
object
Normalized image params. Supported keys: aspect_ratio, resolution, output_format, size, max_images, sequential_image_generation, scale_factor.
​
raw_params
object
Optional model-specific passthrough params.

​
Example

{
  "model_id": "google/nano-banana",
  "prompt": "A cinematic beach sunset with palm trees",
  "params": {
    "aspect_ratio": "16:9",
    "output_format": "jpeg"
  }
}

{
  "ok": true,
  "code": 201,
  "message": "Image generated",
  "data": {
    "file_id": "11111111-1111-1111-1111-111111111111",
    "output_url": "https://cdn.example.com/partner-api/workspaces/ws_1/studio/images/image-123.jpeg",
    "preview_url": "https://cdn.example.com/partner-api/workspaces/ws_1/studio/images/image-123.jpeg",
    "provider": "fal",
    "model_id": "google/nano-banana",
    "credits_used": 1
  }
}

​
Error Responses

  • 400 invalid_json - request body is not valid JSON
  • 401 - authentication failed (missing/invalid/revoked token)
  • 402 subscription_required - active Creator/Professional/Business plan required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 403 insufficient_credits
  • 422 invalid_payload (includes unsupported model_id)
  • 422 invalid_input - upstream model rejected the provided prompt/image combination
  • 422 model_requires_image
  • 422 model_input_not_supported
  • 500 generation_failed