Generate a Bria image

POST

bria

text-to-image

cURL

curl https://api.cometapi.com/bria/text-to-image \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "prompt": "A paper boat floating on calm water at sunrise.",
      "num_results": 1,
      "aspect_ratio": "1:1"
    }'

import os
import requests

response = requests.post(
    "https://api.cometapi.com/bria/text-to-image",
    headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
    json={
            "prompt": "A paper boat floating on calm water at sunrise.",
            "num_results": 1,
            "aspect_ratio": "1:1"
    },
)

print(response.json())  # the route responds synchronously with result[].urls

const response = await fetch("https://api.cometapi.com/bria/text-to-image", {
    method: "POST",
    headers: {
        Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
        "Content-Type": "application/json",
    },
    body: JSON.stringify({
            "prompt": "A paper boat floating on calm water at sunrise.",
            "num_results": 1,
            "aspect_ratio": "1:1"
        }),
});

console.log(await response.json()); // the route responds synchronously with result[].urls

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/bria/text-to-image",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => 'A paper boat floating on calm water at sunrise.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/bria/text-to-image"

	payload := strings.NewReader("{\n  \"prompt\": \"A paper boat floating on calm water at sunrise.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cometapi.com/bria/text-to-image")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A paper boat floating on calm water at sunrise.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/bria/text-to-image")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"A paper boat floating on calm water at sunrise.\"\n}"

response = http.request(request)
puts response.read_body

{
  "result": [
    {
      "urls": [
        "https://temp.bria.ai/api/generate_image/A_paper_boat_..._seed_934469972.png"
      ],
      "seed": 934469972,
      "uuid": "<uuid>"
    }
  ]
}

Generate commercial-safe images from a plain text prompt. For a first request on CometAPI, send prompt, keep num_results at 1, and start with aspect_ratio: "1:1" unless you already know the final layout you need.

Use this route when

You want a finished image in one call
You do not need masks, image inputs, or task polling
You want a photorealistic Bria path that is easier to operationalize through CometAPI

Start with this request

Keep the prompt short and concrete
Use num_results: 1 for your first request
Start with aspect_ratio: "1:1" unless the target layout is already fixed
Download returned URLs promptly if you need long retention

Response behavior on CometAPI

Bria’s official docs describe a broader generation pipeline and discuss async status flows. On CometAPI, this route uses a simplified JSON request and returns a final result array immediately rather than a request_id plus status_url.

CometAPI proxies Bria capability rather than mirroring Bria’s public API field-for-field. Use the request and response shapes shown in this page’s API reference and Playground as the source of truth for integration.

Authorizations

Authorization

string

header

required

Bearer token authentication. Use your CometAPI key.

Body

application/json

prompt

string

required

English text prompt for image generation.

Example:

"A paper boat floating on calm water at sunrise."

num_results

integer

default:1

Number of images to generate. Use 1 for the simplest integration test.

aspect_ratio

enum<string>

default:1:1

Requested output aspect ratio.

Available options:

1:1,

2:3,

3:2,

3:4,

4:3,

4:5,

5:4,

9:16,

16:9

seed

integer

Optional seed for reproducible results.

negative_prompt

string

Optional exclusions for the generated image.

steps_num

integer

default:30

Optional refinement step count.

text_guidance_scale

integer

default:5

Optional prompt adherence setting.

medium

enum<string>

Optional visual medium.

Available options:

photography,

art

prompt_enhancement

boolean

default:false

Optional prompt enhancement switch.

enhance_image

boolean

default:false

Optional image detail enhancement switch.

prompt_content_moderation

boolean

default:false

Optional moderation switch.

ip_signal

boolean

default:false

Optional IP warning flag.

sync

boolean

default:false

Optional sync hint. CometAPI returns final results immediately without setting this field.

Response

200 - application/json

Image generation result.

result

object[]

required

Show child attributes

Last modified on October 15, 2026

cURL

curl https://api.cometapi.com/bria/text-to-image \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "prompt": "A paper boat floating on calm water at sunrise.",
      "num_results": 1,
      "aspect_ratio": "1:1"
    }'

import os
import requests

response = requests.post(
    "https://api.cometapi.com/bria/text-to-image",
    headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
    json={
            "prompt": "A paper boat floating on calm water at sunrise.",
            "num_results": 1,
            "aspect_ratio": "1:1"
    },
)

print(response.json())  # the route responds synchronously with result[].urls

const response = await fetch("https://api.cometapi.com/bria/text-to-image", {
    method: "POST",
    headers: {
        Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
        "Content-Type": "application/json",
    },
    body: JSON.stringify({
            "prompt": "A paper boat floating on calm water at sunrise.",
            "num_results": 1,
            "aspect_ratio": "1:1"
        }),
});

console.log(await response.json()); // the route responds synchronously with result[].urls

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/bria/text-to-image",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => 'A paper boat floating on calm water at sunrise.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/bria/text-to-image"

	payload := strings.NewReader("{\n  \"prompt\": \"A paper boat floating on calm water at sunrise.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cometapi.com/bria/text-to-image")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A paper boat floating on calm water at sunrise.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/bria/text-to-image")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"A paper boat floating on calm water at sunrise.\"\n}"

response = http.request(request)
puts response.read_body

{
  "result": [
    {
      "urls": [
        "https://temp.bria.ai/api/generate_image/A_paper_boat_..._seed_934469972.png"
      ],
      "seed": 934469972,
      "uuid": "<uuid>"
    }
  ]
}

Content moderation

API keys

Use this route when

Start with this request

Response behavior on CometAPI

Authorizations

Body

Response