Skip to content

Fibo · Structured Prompt

Integrate

Model id bria/fibo/generate/structured_prompt
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bria/fibo/generate/structured_prompt?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: $0.01 10 API credits Run it on this page

Get API key
Bria AI LLM #bria#fibo#structured-prompting

Turns a prompt or reference image into Fibo's structured JSON description instead of rendering an image

Bria AI · Data (JSON)

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

Prompt used to generate images.

Advanced image · seed · structured_prompt
image_url
Drop a file, or

Reference image supplied as a file or URL.

default 5555

Seed controlling randomness for reproducible results.

Structured prompt used for image generation.

POST /run/bria/fibo/generate/structured_prompt?wait=20 quote → $0.01
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bria/fibo/generate/structured_prompt?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Fibo · Structured Prompt

Language-model style endpoint that returns the structured prompt for an image rather than the image itself. Inputs are `prompt`, an existing `structured_prompt` or a reference `image_url`, plus `seed`. The JSON output includes fields such as aesthetics, lighting, objects, photographic characteristics, short description, style medium and text to render.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptoptional
Typestring | null
Prompt used to generate images.
structured_promptoptional
Typeobject
Structured prompt used for image generation.
structured_prompt.short_descriptionoptional
Typestring | null
Brief description of the intended output image.
structured_prompt.objectsoptional
Typeobject[]
Default[]
Specify the generated image's contents as a list, recording each object's attributes and its relationships with the other depicted objects.
structured_prompt.objects[].descriptionoptional
Typestring | null
Description of the intended output object.
structured_prompt.objects[].locationoptional
Typestring | null
Object position within the image.
structured_prompt.objects[].relationshiprequired
Typestring
Object's relationship to the image's other objects.
structured_prompt.objects[].relative_sizeoptional
Typestring | null
Object size relative to the image.
structured_prompt.objects[].shape_and_coloroptional
Typestring | null
Object's shape and color.
structured_prompt.objects[].textureoptional
Typestring | null
Object's texture.
structured_prompt.objects[].appearance_detailsoptional
Typestring | null
Details describing the object's appearance.
structured_prompt.objects[].number_of_objectsoptional
Typeinteger | null
Count of objects within the image.
structured_prompt.objects[].poseoptional
Typestring | null
Pose of the depicted object.
structured_prompt.objects[].expressionoptional
Typestring | null
Expression shown by the depicted object.
structured_prompt.objects[].clothingoptional
Typestring | null
Clothing worn by the depicted object.
structured_prompt.objects[].actionoptional
Typestring | null
Action performed by the depicted object.
structured_prompt.objects[].genderoptional
Typestring | null
Gender of the depicted object.
structured_prompt.objects[].skin_tone_and_textureoptional
Typestring | null
Skin texture and tone of the depicted object.
structured_prompt.objects[].orientationoptional
Typestring | null
Orientation of the depicted object.
structured_prompt.background_settingoptional
Typestring | null
Background setting for the generated image.
structured_prompt.lightingoptional
Typeobject
Lighting for the generated image.
structured_prompt.lighting.conditionsoptional
Typestring | null
Lighting conditions for the generated image.
structured_prompt.lighting.directionoptional
Typestring | null
Lighting direction for the generated image.
structured_prompt.lighting.shadowsoptional
Typestring | null
Shadows to depict in the generated image.
structured_prompt.aestheticsoptional
Typeobject
Aesthetic qualities for the generated image.
structured_prompt.aesthetics.compositionoptional
Typestring | null
Composition for the generated image.
structured_prompt.aesthetics.color_schemeoptional
Typestring | null
Color palette for the generated image.
structured_prompt.aesthetics.mood_atmosphereoptional
Typestring | null
Mood and atmosphere for the generated image.
structured_prompt.aesthetics.aesthetic_scoreoptional
Typestring | null
Aesthetic score for the image being generated.
structured_prompt.aesthetics.preference_scoreoptional
Typestring | null
Preference score for the image being generated.
structured_prompt.photographic_characteristicsoptional
Typeobject
Photographic properties for the generated image.
structured_prompt.photographic_characteristics.depth_of_fieldoptional
Typestring | null
Depth of field for the generated image.
structured_prompt.photographic_characteristics.focusoptional
Typestring | null
Focus for the generated image.
structured_prompt.photographic_characteristics.camera_angleoptional
Typestring | null
Camera angle for the generated image.
structured_prompt.photographic_characteristics.lens_focal_lengthoptional
Typestring | null
Lens setting for the generated image, expressed as a focal length.
structured_prompt.style_mediumoptional
Typestring | null
Stylistic medium for the generated image.
structured_prompt.text_renderoptional
Typeany[]
Default[]
List of text entries to include in the image.
structured_prompt.contextoptional
Typestring | null
Context for the generated image.
structured_prompt.artistic_styleoptional
Typestring | null
Artistic style for the generated image.
structured_prompt.trigger_wordoptional
Typestring | null
structured_prompt.sub_trigger_wordoptional
Typestring | null
structured_prompt.art_directionoptional
Typestring | null
structured_prompt.action_descriptionoptional
Typestring | null
structured_prompt.actor_prefixoptional
Typestring | null
image_urloptional image
Typeurl · image
Reference image supplied as a file or URL.
seedoptional
Typeinteger
Default5555
Seed controlling randomness for reproducible results.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/fibo/generate/structured_prompt",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 10,
    "usd": "0.01",
    "charged": 10,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "short_description": "string",
    "objects": [
      {
        "description": "string",
        "location": "string",
        "relationship": "string",
        "relative_size": "string",
        "shape_and_color": "string",
        "texture": "string",
        "appearance_details": "string",
        "number_of_objects": 1,
        "pose": "string",
        "expression": "string",
        "clothing": "string",
        "action": "string",
        "gender": "string",
        "skin_tone_and_texture": "string",
        "orientation": "string"
      }
    ],
    "background_setting": "string",
    "lighting": {
      "conditions": "string",
      "direction": "string",
      "shadows": "string"
    },
    "aesthetics": {
      "composition": "string",
      "color_scheme": "string",
      "mood_atmosphere": "string",
      "aesthetic_score": "string",
      "preference_score": "string"
    },
    "photographic_characteristics": {
      "depth_of_field": "string",
      "focus": "string",
      "camera_angle": "string",
      "lens_focal_length": "string"
    },
    "style_medium": "string",
    "text_render": [],
    "context": "string",
    "artistic_style": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
short_description
string | nullBrief description of the intended output image.
objects
array of object {description, location, relationship, relative_size, shape_and_color, texture, appearance_details, number_of_objects, pose, expression, clothing, action, gender, skin_tone_and_texture, orientation} | nullSpecify the generated image's contents as a list, recording each object's attributes and its relationships with the other depicted objects.
background_setting
string | nullBackground setting for the generated image.
lighting
object {conditions, direction, shadows} | nullLighting for the generated image.
aesthetics
object {composition, color_scheme, mood_atmosphere, aesthetic_score, preference_score} | nullAesthetic qualities for the generated image.
photographic_characteristics
object {depth_of_field, focus, camera_angle, lens_focal_length} | nullPhotographic properties for the generated image.
style_medium
string | nullStylistic medium for the generated image.
text_render
array of any | nullList of text entries to include in the image.
context
string | nullContext for the generated image.
artistic_style
string | nullArtistic style for the generated image.

More models: LLM

For AI agents: this page as Markdown is at https://doitong.com/developers/models/bria/fibo/generate/structured_prompt.md. All models and guides: https://doitong.com/developers/llms.txt