# Bria v1 | Text to Image | HD

Create stock-photo quality, high-resolution, and detailed commercial images suitable for print media and marketing materials with bria-v1-text-to-image-hd.

## API Information

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

## Pricing

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

### Pricing Rules

| Condition | Pricing |
| --- | --- |
| Rule 1 | Fixed pricing: $0.04 per HD 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.2 | 2.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. |
| 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. |
| 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. |
| content_moderation | boolean | No | false | - | When enabled, applies content moderation to generated outputs.  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. |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bria-v1-text-to-image-hd",
  "input": {
    "model_version": "2.2",
    "prompt": "A lone figure stands on the edge of a serene cliff at sunset, gazing out over a vast, mystical A dreamy surreal landscape at dawn, floating islands wrapped in soft mist, pastel pink and lavender sky, golden-sunbeams piercing through clouds, delicate silvery waterfalls cascading into a mirror-like lake, ultra-high detail, cinematic wide angle"
  }
}'
```

## 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 "X-API-Key: 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 `X-API-Key` |
| `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-hd — Text-to-Image AI Model**

Generate **stock-photo quality, high-resolution images** from text prompts with bria-v1-text-to-image-hd, Bria's advanced text-to-image AI model designed for commercial print media and marketing materials. Part of the bria-v1 family from provider Bria, this model excels at producing detailed, photorealistic visuals suitable for professional use, solving the challenge of creating print-ready assets without expensive photoshoots. Developers and marketers searching for a reliable **bria-v1-text-to-image-hd API** or **Bria text-to-image** solution will find it delivers consistent, high-fidelity outputs optimized for e-commerce and advertising.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `X-API-Key: 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.