Passer au contenu principal
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"
    }
  ]
}
Générez des images sûres pour un usage commercial à partir d’un simple prompt textuel. Pour une première requête sur CometAPI, envoyez prompt, conservez num_results à 1, et commencez avec aspect_ratio: "1:1" sauf si vous connaissez déjà la mise en page finale dont vous avez besoin.

Utilisez cette route quand

  • Vous voulez une image finale en un seul appel
  • Vous n’avez pas besoin de masques, d’images en entrée ni d’interrogation de tâche
  • Vous voulez un parcours Bria photoréaliste plus facile à mettre en œuvre via CometAPI

Commencez avec cette requête

  • Gardez le prompt court et concret
  • Utilisez num_results: 1 pour votre premier smoke test
  • Commencez avec aspect_ratio: "1:1" sauf si la mise en page cible est déjà définie
  • Téléchargez rapidement les URL renvoyées si vous avez besoin d’une conservation prolongée

Comportement de la réponse sur CometAPI

La documentation officielle de Bria décrit un pipeline de génération plus large et évoque des flux de statut asynchrones. Sur CometAPI, cette route utilise une requête JSON simplifiée et, dans les smoke tests actuels, a renvoyé immédiatement un tableau result final plutôt qu’un request_id avec un status_url.
CometAPI sert de proxy pour la capacité de Bria plutôt que de reproduire l’API publique de Bria champ par champ. Utilisez les formats de requête et de réponse affichés dans la référence d’API et le Playground de cette page comme source de vérité pour l’intégration.

Autorisations

Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json
prompt
string
requis

English text prompt for image generation.

Exemple:

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

num_results
integer
défaut:1

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

aspect_ratio
enum<string>
défaut:1:1

Requested output aspect ratio.

Options disponibles:
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
défaut:30

Optional refinement step count.

text_guidance_scale
integer
défaut:5

Optional prompt adherence setting.

medium
enum<string>

Optional visual medium.

Options disponibles:
photography,
art
prompt_enhancement
boolean
défaut:false

Optional prompt enhancement switch.

enhance_image
boolean
défaut:false

Optional image detail enhancement switch.

prompt_content_moderation
boolean
défaut:false

Optional moderation switch.

ip_signal
boolean
défaut:false

Optional IP warning flag.

sync
boolean
défaut:false

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

Réponse

200 - application/json

Image generation result.

result
object[]
requis