Przejdź do głównej treści
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"
    }
  ]
}
Generuj obrazy bezpieczne do użytku komercyjnego na podstawie zwykłego Prompt. W przypadku pierwszego żądania w CometAPI wyślij prompt, ustaw num_results na 1 i zacznij od aspect_ratio: "1:1", chyba że już wiesz, jaki finalny układ jest Ci potrzebny.

Użyj tej ścieżki, gdy

  • Chcesz otrzymać gotowy obraz w jednym wywołaniu
  • Nie potrzebujesz masek, obrazów wejściowych ani odpytywania o status zadania
  • Chcesz użyć fotorealistycznej ścieżki Bria, którą łatwiej wdrożyć operacyjnie przez CometAPI

Zacznij od tego żądania

  • Zachowaj krótki i konkretny prompt
  • Użyj num_results: 1 w pierwszym teście smoke test
  • Zacznij od aspect_ratio: "1:1", chyba że docelowy układ jest już ustalony
  • Pobierz zwrócone adresy URL możliwie szybko, jeśli potrzebujesz dłuższego przechowywania

Zachowanie odpowiedzi w CometAPI

Oficjalna dokumentacja Bria opisuje szerszy pipeline generowania i omawia asynchroniczne przepływy statusu. W CometAPI ta ścieżka używa uproszczonego żądania JSON i w aktualnych testach smoke test zwracała od razu końcową tablicę result zamiast request_id i status_url.
CometAPI pośredniczy w dostępie do możliwości Bria, zamiast odwzorowywać publiczne API Bria pole po polu. Podczas integracji używaj kształtów żądania i odpowiedzi pokazanych w referencji API i Playground na tej stronie jako źródła prawdy.

Autoryzacje

Authorization
string
header
wymagane

Bearer token authentication. Use your CometAPI key.

Treść

application/json
prompt
string
wymagane

English text prompt for image generation.

Przykład:

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

num_results
integer
domyślnie:1

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

aspect_ratio
enum<string>
domyślnie:1:1

Requested output aspect ratio.

Dostępne opcje:
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
domyślnie:30

Optional refinement step count.

text_guidance_scale
integer
domyślnie:5

Optional prompt adherence setting.

medium
enum<string>

Optional visual medium.

Dostępne opcje:
photography,
art
prompt_enhancement
boolean
domyślnie:false

Optional prompt enhancement switch.

enhance_image
boolean
domyślnie:false

Optional image detail enhancement switch.

prompt_content_moderation
boolean
domyślnie:false

Optional moderation switch.

ip_signal
boolean
domyślnie:false

Optional IP warning flag.

sync
boolean
domyślnie:false

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

Odpowiedź

200 - application/json

Image generation result.

result
object[]
wymagane