Skip to main content
POST
/
generation
/
ideogram
/
ideogram
Ideogram V3
curl --request POST \
  --url https://open.skills.video/api/v1/generation/ideogram/ideogram \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>"
}
'
{
  "id": "<string>",
  "status": "starting",
  "usage": {
    "total": 0,
    "subscription": 0,
    "permanent": 0
  }
}
Ideogram image generation model

Authorizations

​
Authorization
string
header
required

API Key for API endpoints

Body

application/json
​
prompt
string
required

Text prompt for image generation

​
n
integer
default:1

Number of results to generate (1-4)

Required range: 1 <= x <= 4
​
image_url
string<uri>

Input image for image-to-image generation

​
aspect_ratio
enum<string>
default:1:1

The aspect ratio of the generated image

Available options:
10:16,
16:10,
9:16,
16:9,
4:3,
3:4,
1:1,
1:3,
3:1,
3:2,
2:3
​
resolution
enum<string>
default:1K

Target resolution used together with aspect ratio to build image_size

Available options:
1K,
2K,
4K
​
expand_prompt
boolean
default:true

Whether to expand the prompt with MagicPrompt functionality

​
seed
integer | null

Seed for the random number generator

Required range: -9007199254740991 <= x <= 9007199254740991
​
style
enum<string>
default:auto

The style of the generated image

Available options:
auto,
general,
realistic,
design,
render_3D,
anime

Response

Generation status

​
id
string
required

Generation id.

​
status
enum<string>
required

Generation status

Available options:
starting,
processing,
succeeded,
failed,
canceled
​
usage
object
required

Credit usage breakdown for the request