Zum Hauptinhalt springen
POST
/
bria
/
text-to-image
Generate Bria images
curl --request POST \
  --url https://api.cometapi.com/bria/text-to-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A paper boat floating on calm water at sunrise."
}
'
{
  "result": [
    {
      "urls": [
        "https://example.com/generated.png"
      ],
      "seed": 278741175,
      "uuid": "27c39b06-1dfe-11f1-ad57-6ac2c454c04d_278741175"
    }
  ]
}
Generieren Sie kommerziell sichere Bilder aus einem einfachen Text-Prompt. Senden Sie für eine erste Anfrage an CometAPI prompt, belassen Sie num_results auf 1 und beginnen Sie mit aspect_ratio: "1:1", sofern Sie das endgültige Layout nicht bereits kennen.

​
Verwenden Sie diese Route, wenn

  • Sie in einem einzigen Aufruf ein fertiges Bild möchten
  • Sie keine Masken, Bildeingaben oder Task-Polling benötigen
  • Sie einen fotorealistischen Bria-Pfad möchten, der sich über CometAPI einfacher operationalisieren lässt

​
Beginnen Sie mit dieser Anfrage

  • Halten Sie den Prompt kurz und konkret
  • Verwenden Sie num_results: 1 für Ihren ersten Smoke-Test
  • Beginnen Sie mit aspect_ratio: "1:1", sofern das Ziellayout nicht bereits feststeht
  • Laden Sie zurückgegebene URLs zeitnah herunter, wenn Sie eine lange Aufbewahrung benötigen

​
Antwortverhalten bei CometAPI

Die offiziellen Docs von Bria beschreiben eine umfassendere Generierungspipeline und behandeln asynchrone Statusabläufe. Bei CometAPI verwendet diese Route eine vereinfachte JSON-Anfrage und gab in aktuellen Smoke-Tests sofort ein finales result-Array zurück statt einer request_id plus status_url.
CometAPI proxyt die Bria-Funktionalität, anstatt Brias öffentliche API Feld für Feld zu spiegeln. Verwenden Sie die in der API-Referenz und im Playground dieser Seite gezeigten Anfrage- und Antwortformate als maßgebliche Quelle für die Integration.

Autorisierungen

​
Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Body

application/json
​
prompt
string
erforderlich

English text prompt for image generation.

Beispiel:

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

​
num_results
integer
Standard:1

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

​
aspect_ratio
enum<string>
Standard:1:1

Requested output aspect ratio.

Verfügbare Optionen:
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
Standard:30

Optional refinement step count.

​
text_guidance_scale
integer
Standard:5

Optional prompt adherence setting.

​
medium
enum<string>

Optional visual medium.

Verfügbare Optionen:
photography,
art
​
prompt_enhancement
boolean
Standard:false

Optional prompt enhancement switch.

​
enhance_image
boolean
Standard:false

Optional image detail enhancement switch.

​
prompt_content_moderation
boolean
Standard:false

Optional moderation switch.

​
ip_signal
boolean
Standard:false

Optional IP warning flag.

​
sync
boolean
Standard:false

Optional sync hint. Current CometAPI smoke tests returned final results immediately without setting this field.

Antwort

200 - application/json

Image generation result.

​
result
object[]
erforderlich