Metadata

API metadata and available options

Get all metadata

get

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Responses

200

Metadata object

application/json

modelsstring[]Required

image_modelsstring[]Required

get

/v1/meta

HTTPcURLJavaScriptPython

GET /v1/meta HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

Metadata object

{
  "languages": [
    {
      "name": "text",
      "code": "text"
    }
  ],
  "regions": [
    {
      "name": "text",
      "code": "text"
    }
  ],
  "models": [
    "text"
  ],
  "image_models": [
    "text"
  ]
}

Get available models

get

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Responses

200

A list of model names

application/json

string[]Optional

get

/v1/meta/models

HTTPcURLJavaScriptPython

GET /v1/meta/models HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

A list of model names

[
  "text"
]

Get available image models

get

Returns all available image generation models. Models are grouped by provider:

OpenAI models (require OpenAI API key):

• gpt-image-2: GPT Image 2, latest state-of-the-art OpenAI image model. Sizes: 1024x1024, 1536x1024, 1024x1536

• gpt-image-1.5: GPT Image 1.5, fast and high quality. Sizes: 1024x1024, 1536x1024, 1024x1536

• gpt-image-1: GPT Image 1, photorealistic quality. Sizes: 1024x1024, 1536x1024, 1024x1536

Replicate models (require Replicate API key):

• black-forest-labs/flux-1.1-pro-ultra: Flux 1.1 Pro Ultra, highest quality Flux model

• black-forest-labs/flux-1.1-pro: Flux 1.1 Pro, high quality with custom dimensions

• black-forest-labs/flux-dev: Flux Dev, fast iteration

• black-forest-labs/flux-pro: Flux Pro, balanced quality and speed

• black-forest-labs/flux-schnell: Flux Schnell, fastest Flux model

• stability-ai/stable-diffusion-3: Stable Diffusion 3

• replicate:nano-banana-pro: Nano Banana Pro, supports 1K/2K/4K resolution output

• replicate:imagen-4: Google Imagen 4 via Replicate

Google models (require Google AI API key):

• imagen-4.0-generate-001: Google Imagen 4, native Google API

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Responses

200

A list of image model names

application/json

string[]OptionalExample: ["gpt-image-2","gpt-image-1.5","gpt-image-1","black-forest-labs/flux-1.1-pro-ultra","black-forest-labs/flux-1.1-pro","black-forest-labs/flux-dev","black-forest-labs/flux-pro","black-forest-labs/flux-schnell","stability-ai/stable-diffusion-3","replicate:nano-banana-pro","replicate:imagen-4","imagen-4.0-generate-001"]

get

/v1/meta/image_models

HTTPcURLJavaScriptPython

GET /v1/meta/image_models HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

A list of image model names

[
  "gpt-image-2",
  "gpt-image-1.5",
  "gpt-image-1",
  "black-forest-labs/flux-1.1-pro-ultra",
  "black-forest-labs/flux-1.1-pro",
  "black-forest-labs/flux-dev",
  "black-forest-labs/flux-pro",
  "black-forest-labs/flux-schnell",
  "stability-ai/stable-diffusion-3",
  "replicate:nano-banana-pro",
  "replicate:imagen-4",
  "imagen-4.0-generate-001"
]

Get available languages

get

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Responses

200

A list of supported languages

application/json

namestringRequired

codestringRequired

get

/v1/meta/languages

HTTPcURLJavaScriptPython

GET /v1/meta/languages HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

A list of supported languages

[
  {
    "name": "text",
    "code": "text"
  }
]

Get available regions

get

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Responses

200

A list of supported regions

application/json

namestringRequired

codestringRequired

get

/v1/meta/regions

HTTPcURLJavaScriptPython

GET /v1/meta/regions HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

A list of supported regions

[
  {
    "name": "text",
    "code": "text"
  }
]