Create an image - Orvado

POST

/

v1

/

images

/

generations

Create an image

curl --request POST \
  --url https://orvado.dev/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "amethyst perfume bottle on plum velvet, studio light",
  "size": "1024x1024",
  "response_format": "url",
  "n": 1
}
'

import requests

url = "https://orvado.dev/v1/images/generations"

payload = {
    "prompt": "amethyst perfume bottle on plum velvet, studio light",
    "size": "1024x1024",
    "response_format": "url",
    "n": 1
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'amethyst perfume bottle on plum velvet, studio light',
    size: '1024x1024',
    response_format: 'url',
    n: 1
  })
};

fetch('https://orvado.dev/v1/images/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "created": 1792500000,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>"
    }
  ]
}

{
  "error": {
    "message": "No token provided (request id: 2026102015161442847504045555018)",
    "type": "one_api_error"
  }
}

{
  "error": {
    "message": "No token provided (request id: 2026102015161442847504045555018)",
    "type": "one_api_error"
  }
}

{
  "error": {
    "message": "No token provided (request id: 2026102015161442847504045555018)",
    "type": "one_api_error"
  }
}

{
  "error": {
    "message": "No token provided (request id: 2026102015161442847504045555018)",
    "type": "one_api_error"
  }
}

{
  "error": {
    "message": "No token provided (request id: 2026102015161442847504045555018)",
    "type": "one_api_error"
  }
}

Authorizations

Authorization

string

header

required

Your td- key from Tokens

Body

application/json

model

enum<string>

required

Available options:

gpt-image-2.5-flare,

gpt-image-2.5-sunburst,

nano-banana-pro,

nano-banana-2.1,

nano-banana,

nano-banana-2-lite

prompt

string

required

What to draw

Example:

"amethyst perfume bottle on plum velvet, studio light"

size

string

default:1024x1024

Any pixel size, such as 1024x1024 or 2048x1152. The longest side sets the price tier: under 1800 (or auto) is 1K, 1800 and up is 2K, 3000 and up is 4K. 1k, 2k and 4k give a square image

Example:

"1024x1024"

quality

enum<string>

GPT Image 2.5 only. Does not change the price

Available options:

low,

medium,

high,

xhigh,

max,

auto

response_format

enum<string>

default:url

Available options:

url,

b64_json

n

integer

default:1

Images per request. Send 1 and run requests in parallel for more

Response

The finished image

created

integer

Unix time in seconds

Example:

1792500000

data

object[]

Show child attributes

Create an image

curl --request POST \
  --url https://orvado.dev/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "amethyst perfume bottle on plum velvet, studio light",
  "size": "1024x1024",
  "response_format": "url",
  "n": 1
}
'

import requests

url = "https://orvado.dev/v1/images/generations"

payload = {
    "prompt": "amethyst perfume bottle on plum velvet, studio light",
    "size": "1024x1024",
    "response_format": "url",
    "n": 1
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'amethyst perfume bottle on plum velvet, studio light',
    size: '1024x1024',
    response_format: 'url',
    n: 1
  })
};

fetch('https://orvado.dev/v1/images/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "created": 1792500000,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>"
    }
  ]
}

{
  "error": {
    "message": "No token provided (request id: 2026102015161442847504045555018)",
    "type": "one_api_error"
  }
}

{
  "error": {
    "message": "No token provided (request id: 2026102015161442847504045555018)",
    "type": "one_api_error"
  }
}

{
  "error": {
    "message": "No token provided (request id: 2026102015161442847504045555018)",
    "type": "one_api_error"
  }
}

{
  "error": {
    "message": "No token provided (request id: 2026102015161442847504045555018)",
    "type": "one_api_error"
  }
}

{
  "error": {
    "message": "No token provided (request id: 2026102015161442847504045555018)",
    "type": "one_api_error"
  }
}