The image object

Represents the url or the content of an image generated by the TheB.AI API.

  • Name
    url
    Type
    string
    Description

    The URL of the generated image, if response_format is url (default).

The image object

{
  "url": "...."
}

Create image

POST https://api.theb.ai/v1/images/generations

POST https://api.baizhi.ai/v1/images/generations

Creates an image given a prompt.

Available parameters

model string Required ID of the model to use. See the model endpoint compatibility table for details on which models work with the Images API.

prompt string Required A text description of the desired image(s). The maximum length is 1000 characters.

model_params object Optional Each model is different Used to set various parameters of the model.

  • n number or null Optional
    • The number of images to generate. Must be between 1 and 10.
  • Obtain the other configurable parameters from the model interface.

Example Request

POST
/v1/images/generations
curl --location 'https://api.theb.ai/v1/images/generations' \
# curl --location 'https://api.baizhi.ai/v1/images/generations' \
  --header 'Authorization: Bearer $API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "dall-e-2",
    "model_params": {
      "n": 2,
      "size": "1024x1024"
    },
    "prompt": "a cute cat"
  }'

Response

{
  "id": "a71f6681d8e24b1ebcccc5966be884d1",
  "created": 1692157133,
  "data": [
    {
      "url": "https://example.com/a71f6681d8e24b1ebcccc5966be884d1_0"
    },
    {
      "url": "https://example.com/a71f6681d8e24b1ebcccc5966be884d1_1"
    }
  ]
}