Create image

Create image

Create an image from a prompt.

post

/images

Authorizations

Body

promptstringrequired

The prompt to generate the image from.

aspect_ratiostring · enumrequired

The aspect ratio of the image.

Options: 9:16, 16:9, 1:1

image_style_idstring | null

The ID of the image style to use. Use the List image styles endpoint to get a list of available image styles.

scene_idstring | null

If you want to add the generated image to a video scene you can specify it here.

wait_for_generationboolean · default: false

If false, this endpoint immediately returns the incomplete image record, and you can poll the Get image endpoint until the task completes. If true, this endpoint waits until the image generation completes, then returns the complete image record. Defaults to false.

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://shortgenius.com/api/v1/images' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "text",
    "aspect_ratio": "9:16",
    "image_style_id": null,
    "scene_id": null,
    "wait_for_generation": false
  }'

200

400

401

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "url": null,
  "type": "text",
  "state": "pending",
  "created_at": "text",
  "updated_at": null,
  "prompt": "text",
  "is_nsfw": true,
  "aspect_ratio": "9:16",
  "image_style_id": null
}

Successful response