# Bria v1 | Text to Image | Base

Safely produce copyright-free images for corporate projects using the bria-v1-text-to-image-base model, trained on fully licensed data for commercial compliance.

## API Information

- **Model Slug:** bria-v1-text-to-image-base
- **Branded URL:** https://www.eachlabs.ai/bria/bria-v1/bria-v1-text-to-image-base
- **Provider:** Bria
- **Category:** Text to Image
- **Output Type:** array
- **Status:** active
- **Version:** 0.0.1
- **Base Cost:** Fixed pricing: $0.04 per text-to-image request
- **Estimated Processing Time:** 15 seconds
- **Last Updated:** 2026-04-16
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/bria-v1-text-to-image-base

## Pricing

- **Charge Type:** dynamic
- **Estimated Price (default example):** $0.0400
- **Pricing Details:** Fixed pricing: $0.04 per text-to-image request

### Pricing Rules

| Condition | Pricing |
| --- | --- |
| Rule 1 | Fixed pricing: $0.04 per text-to-image request |

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| prompt | string | Yes | - | - | The prompt you would like to use to generate images. Bria currently supports prompts in English only. |
| model_version | string | Yes | 2.3 | 2.3,3.2 | The model version you would like to use in the request. |
| num_results | integer | No | 4 | 1–4 | How many images you would like to generate. |
| aspect_ratio | string | No | 1:1 | 1:1,2:3,3:2,,3:4,4:3,4:5,5:4,9:16,16:9 | The aspect ratio of the image. |
| seed | integer | No | - | - | You can choose whether you want your generated result to be random or predictable. You can recreate the same result in the future by using the seed value of a result from the response with the prompt, model type and model version. You can exclude this parameter if you are not interested in recreating your results. This parameter is optional. |
| negative_prompt | string | No | - | - | Specify here elements that you didn't ask in the prompt, but are being generated, and you would like to exclude. This parameter is optional. Bria currently supports prompts in English only. |
| steps_num | integer | No | 30 | 20–50 | The number of iterations the model goes through to refine the generated image. This parameter is optional. |
| text_guidance_scale | integer | No | 5 | 1–10 | Determines how closely the generated image should adhere to the input text description. This parameter is optional. |
| medium | string | No | - | photography,art | Which medium should be included in your generated images. This parameter is optional. |
| enhance_image | boolean | No | false | - | When set to true, generates images with richer details, sharper textures, and enhanced clarity. Slightly increases generation time per image. |
| prompt_content_moderation | boolean | No | true | - | When enabled (default: true), the input prompt is scanned for NSFW or ethically restricted terms before image generation. If the prompt violates Bria's ethical guidelines, the request will be rejected with a 408 error. |
| content_moderation | boolean | No | false | - | When enabled, applies content moderation to both input visuals and generated outputs. Processing stops at the first image that fails moderation. If some images pass and others fail, returns a 200 response with successful generations and "blocked" objects for failed ones. |
| ip_signal | boolean | No | false | - | Flags prompts with potential IP content. If detected, a warning will be included in the response. |
| image_prompt_mode | string | No | regular | regular,style_only | regular: Uses the image’s content, style elements, and color palette to guide generation. style_only: Uses the image’s high-level style elements and color palette to influence the generated output. The support for image prompt is currently available only when model_version="2.3" |
| image_prompt_urls | array | No | - | - | A list of URLs of images that should be used as guidance. The images can be of different aspect ratios. Accepted formats are jpeg, jpg, png, webp. The URLs should point to accessible, publicly available images. The support for image prompt is currently available only when model_version="2.3". |
| image_prompt_scale | number | No | 1 | 0–1 | The impact of the provided image on the generated results. A value between 0.0 (no impact) and 1.0 (full impact). |
| prompt_enhancement | boolean | No | false | - | When set to true, enhances the provided prompt by generating additional, more descriptive variations, resulting in more diverse and creative output images. Note that turning this flag on may result in a few additional seconds to the inference time. Built with Meta Llama 3. |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bria-v1-text-to-image-base",
  "input": {
    "model_version": "2.3",
    "prompt": "A tranquil underwater world filled with glowing coral reefs, jellyfish emitting soft turquoise light, shafts of sunlight cutting through the water, photorealistic yet dreamlike, slow-motion ambience, 16:9 cinematic frame"
  }
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "array",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "Authorization: Bearer YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `Authorization` bearer token |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

**bria-v1-text-to-image-base — Text-to-Image AI Model**

Generate copyright-free, commercially safe images for enterprise projects with **bria-v1-text-to-image-base**, a text-to-image AI model from Bria trained exclusively on fully licensed data to ensure legal compliance without watermark risks or IP concerns. Developed by Bria as part of the bria-v1 family, this base model powers deterministic image creation ideal for corporate workflows needing reliable, high-fidelity visuals from text prompts. Unlike generic text-to-image models, bria-v1-text-to-image-base emphasizes hyper-controllable outputs using structured prompts, making it perfect for Bria text-to-image applications in marketing, design, and e-commerce where precision and safety matter most.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `Authorization: Bearer YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.