Get 1 image

Get 1 image

curl --request GET \
  --url https://api.wesog.com/imgs/{image_id} \
  --header 'API-Key: <api-key>'

{
  "image_id": "<string>",
  "src": "https://cdn.example.com/image/source.jpg",
  "url_img_watermark": "https://cdn.example.com/image/wm.jpg",
  "url_img_thumbnail": "https://cdn.example.com/image/thumb.jpg",
  "title": "image123",
  "headline": "Sunset over the Hudson River",
  "caption": "A vibrant orange sunset reflecting on the river with the city skyline in silhouette.",
  "alt_text": "<string>",
  "ai_generated": true,
  "model_release": true,
  "property_release": true,
  "nsfw": true,
  "status": "Active",
  "date": "2024-10-19",
  "location": "123 Main St, near Central Park",
  "city": "New York",
  "country": "United States",
  "event": "Oscar awards 2024",
  "author": "Jane Doe",
  "provider": "Acme Inc.",
  "shot": "Portrait",
  "scene": "Town square",
  "technique": "Drawing",
  "medium": "Oil on canvas",
  "keywords": [
    "Tree",
    "Dog",
    "Ball",
    "Water"
  ],
  "categories": [
    "Sport",
    "Fashion",
    "Politics"
  ],
  "collections": [
    "Steet pics",
    "Exclusive"
  ],
  "height": 123,
  "width": 123,
  "n_faces": 123
}

GET

imgs

{image_id}

Get 1 image

curl --request GET \
  --url https://api.wesog.com/imgs/{image_id} \
  --header 'API-Key: <api-key>'

{
  "image_id": "<string>",
  "src": "https://cdn.example.com/image/source.jpg",
  "url_img_watermark": "https://cdn.example.com/image/wm.jpg",
  "url_img_thumbnail": "https://cdn.example.com/image/thumb.jpg",
  "title": "image123",
  "headline": "Sunset over the Hudson River",
  "caption": "A vibrant orange sunset reflecting on the river with the city skyline in silhouette.",
  "alt_text": "<string>",
  "ai_generated": true,
  "model_release": true,
  "property_release": true,
  "nsfw": true,
  "status": "Active",
  "date": "2024-10-19",
  "location": "123 Main St, near Central Park",
  "city": "New York",
  "country": "United States",
  "event": "Oscar awards 2024",
  "author": "Jane Doe",
  "provider": "Acme Inc.",
  "shot": "Portrait",
  "scene": "Town square",
  "technique": "Drawing",
  "medium": "Oil on canvas",
  "keywords": [
    "Tree",
    "Dog",
    "Ball",
    "Water"
  ],
  "categories": [
    "Sport",
    "Fashion",
    "Politics"
  ],
  "collections": [
    "Steet pics",
    "Exclusive"
  ],
  "height": 123,
  "width": 123,
  "n_faces": 123
}

Authorizations

API-Key

string

header

required

Query Parameters

fields

enum<string>[]

List of fields to retrieve. Example: fields=title&fields=description

Available options:

image_id,

src,

url_img_watermark,

url_img_thumbnail,

title,

headline,

caption,

alt_text,

ai_generated,

model_release,

property_release,

nsfw,

status,

date,

location,

city,

country,

event,

author,

provider,

shot,

scene,

technique,

medium,

keywords,

categories,

collections,

height,

width,

n_faces

Response

Successful Response

image_id

string | null

src

string | null

Url of the image in high or medium resolution (used as source for the AI)

Example:

"https://cdn.example.com/image/source.jpg"

url_img_watermark

string | null

URL of the watermarked image.

Example:

"https://cdn.example.com/image/wm.jpg"

url_img_thumbnail

string | null

URL of the thumbnail image.

Example:

"https://cdn.example.com/image/thumb.jpg"

title

string | null

A shorthand reference for the image.

Example:

"image123"

headline

string | null

Short text describing the image.

Example:

"Sunset over the Hudson River"

caption

string | null

Long text describing the image.

Example:

"A vibrant orange sunset reflecting on the river with the city skyline in silhouette."

alt_text

string | null

Text describing the visual appearance of an image (Accessibility).

ai_generated

boolean | null

Image generated by Artificial Intelligence.

model_release

boolean | null

image with model release.

property_release

boolean | null

image with property release.

nsfw

boolean | null

Image Not Safe For Work.

status

string | null

Current status of the image.

Example:

"Active"

date

string | null

Date of the image creation in year-month-day format. Capture date for photographies.

Example:

"2024-10-19"

location

string | null

A detailed description of the location, complementing the specified country and city with additional details such as street address or notable landmarks.

Example:

"123 Main St, near Central Park"

city

string | null

Name of the country.

Example:

"New York"

country

string | null

Name of the country.

Example:

"United States"

event

string | null

Related event

Example:

"Oscar awards 2024"

author

string | null

The name of the individual or entity responsible for creating the image, such as a photographer or painter.

Example:

"Jane Doe"

provider

string | null

The identifier of the provider, which can be either a unique numeric ID or a descriptive name.

Example:

"Acme Inc."

shot

string | null

Type of photography shot.

Example:

"Portrait"

scene

string | null

Spot, place, visual location

Example:

"Town square"

technique

string | null

The specific method or process used in creating the artwork, reflecting the artist's unique approach or the traditional methods tied to certain mediums.

Example:

"Drawing"

medium

string | null

The material or substance used in the creation of the artwork or object. This field corresponds to various artistic mediums like oils, acrylics, or digital formats.

Example:

"Oil on canvas"

keywords

string[] | null

Specific tags describing the image

Example:

["Tree", "Dog", "Ball", "Water"]

Roles

Operations

Wesog Tag

Query Images

Images

Authorizations

Query Parameters

Response