Bria modelsimage generation api

bria/text-to-image/base

Name: Bria Text-to-Image Base
Author: Bria

Base by Bria - generate stunning images from text prompts with state-of-the-art AI. Supports multiple aspect ratios, styles, and high-resolution output for creative and commercial use.

Input

Prompt(string)

The prompt you would like to use to generate images.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

Seed(integer)

02147483647

The same seed and the same prompt given to the same version of the model will output the same image every time. Range: 0 to 2147483647.

Guidance(array)

Guidance images to use for the generation. Up to 4 guidance methods can be combined during a single inference.

Medium(string)

Which medium should be included in your generated images. This parameter is optional. Allowed values: photography, art.

Prompt Enhancement(boolean)

When set to true, enhances the provided prompt by generating additional, more descriptive variations, resulting in more diverse and creative output images.

Guidance Scale(number)

020

Range: 0 to 20.

Num Inference Steps(integer)

2050

Range: 20 to 50.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDbria/text-to-image/base

Input Schema

8 parameters · 1 required · 7 optional

Parameter	Type	Required	Description
`prompt`	string	Required	The prompt you would like to use to generate images. · Min length: 1
`seed`	integer	Optional	The same seed and the same prompt given to the same version of the model will output the same image every time. · Min: 0 · Max: 2147483647
`medium`	string	Optional	Which medium should be included in your generated images. This parameter is optional. · Options: photography, art photographyart
`guidance`	object[]	Optional	Guidance images to use for the generation. Up to 4 guidance methods can be combined during a single inference. · Default: []
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`guidance_scale`	number	Optional	Min: 0 · Max: 20 · Default: 5
`prompt_enhancement`	boolean	Optional	When set to true, enhances the provided prompt by generating additional, more descriptive variations, resulting in more diverse and creative output images. · Default: false
`num_inference_steps`	integer	Optional	Min: 20 · Max: 50 · Default: 30

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "bria/text-to-image/base",
  "prompt": "A lone figure stands on the edge of a serene cliff at sunset, gazing out over a vast, mystical valley. The figure is clad in flowing robes that ripple in the gentle breeze, silhouetted against the golden and lavender hues of the sky. Below, a cascading waterfall pours into a sparkling river winding through a forest of bioluminescent trees. The scene blends the awe of nature with a touch of otherworldly wonder, inviting reflection and imagination.",
  "guidance": [],
  "guidance_scale": 5,
  "prompt_enhancement": false,
  "num_inference_steps": 30
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Bria Text-to-Image Base

API README

Bria Text To Image Base

Bria Text To Image Base is built for balanced text-to-image generation for general creative production. It gives creative and production teams a focused way to move from an approved brief or source asset to a reviewable result without fragmenting the job across unrelated tools. The model is most valuable when visual intent, brand suitability, and downstream usability all matter, because its output can enter an editorial, campaign, product, or content pipeline as a purposeful asset rather than an isolated experiment.

In practice, teams can use Bria Text To Image Base during a structured cycle of briefing, generation, comparison, and refinement. Establish the subject, audience, visual objective, and acceptance criteria first; prepare any reference media at suitable quality; then evaluate alternatives for composition, continuity, realism, and communication value before delivery. This workflow keeps creative judgment central while making repeated production easier to review, reproduce, and scale for the specific bria/text-to-image/base task.

Highlights

Reliable prompt interpretation. Reliable prompt interpretation gives bria › text to image › base a recognizable technical advantage: reviewers can assess this property directly in the generated asset instead of inferring it from request mechanics.

Balanced speed and fidelity. bria › text to image › base applies balanced speed and fidelity to the visual or temporal result itself, helping artists make a meaningful quality decision during selection and refinement.

Versatile style range. For bria › text to image › base, versatile style range supports coherent assets across the intended creative workflow and distinguishes this capability from a simple format or delivery option.

Strong everyday composition. The practical value of strong everyday composition is visible in the finished media from bria › text to image › base, where it supports repeatable art direction rather than merely exposing another request setting.

Pricing

Billing basis	Price
Per request	$0.040000

When to Use

✅ Good fit	❌ Consider alternatives
Use it when balanced text-to-image generation for general creative production is the central production goal	Choose a different model when the required media task is fundamentally different
The team needs several reviewable creative alternatives	Exact deterministic reproduction is mandatory
Visual quality and practical downstream use both matter	Editable source layers or native project files are required
A managed generation step fits the delivery workflow	A live frame-by-frame interactive editor is essential
The documented inputs cover the available source assets	Required source media or controls fall outside the documented fields

Prompt Guide

State the intended result first, then describe the subject, environment, action, visual treatment, and delivery constraints. Keep instructions concrete, avoid conflicting directions, and change one creative variable at a time when comparing outputs. For source-driven work, describe what should remain recognizable as clearly as what should change.

{
  "prompt": "A lone figure stands on the edge of a serene cliff at sunset, gazing out over a vast, mystical valley. The figure is clad in flowing robes that ripple in the gentle breeze, silhouetted against the golden and lavender hues of the sky. Below, a cascading waterfall pours into a sparkling river winding through a forest of bioluminescent trees. The scene blends the awe of nature with a touch of otherworldly wonder, inviting reflection and imagination."
}

Technical Specs

Property	Details
`seed`	Type / options: integer · 0–2147483647<br>Required: No<br>Description: The same seed and the same prompt given to the same version of the model will output the same image every time.
`medium`	Type / options: string · photography / art<br>Required: No<br>Description: Which medium should be included in your generated images. This parameter is optional.
`prompt`	Type / options: string<br>Required: Yes<br>Description: The prompt you would like to use to generate images.
`guidance`	Type / options: array<br>Required: No<br>Description: Guidance images to use for the generation. Up to 4 guidance methods can be combined during a single inference.
`aspect_ratio`	Type / options: string · 21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16<br>Required: No<br>Description: The aspect ratio of the generated image.
`guidance_scale`	Type / options: number · 0–20<br>Required: No<br>Description: Request option
`prompt_enhancement`	Type / options: boolean<br>Required: No<br>Description: When set to true, enhances the provided prompt by generating additional, more descriptive variations, resulting in more diverse and creative output images.
`num_inference_steps`	Type / options: integer · 20–50<br>Required: No<br>Description: Request option

Related Models

bria/background/remove
bria/background/replace
bria/embed-product