Skip to main content
GET
/
images
/
{id}
JavaScript
import Weights from '@weights-ai/sdk';

const client = new Weights({
  bearerToken: 'My Bearer Token',
});

const image = await client.images.retrieve('id');

console.log(image.id);
{
  "id": "visual_123456789",
  "status": "SUCCEEDED",
  "prompt": "A beautiful sunset over mountains",
  "type": "IMAGE_GENERATION",
  "numImages": 1,
  "dimensions": "SQUARE",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:35:00Z",
  "outputUrls": [
    "https://storage.example.com/images/generated_1.jpg"
  ],
  "lora": null,
  "secondaryLora": null
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Response

Returns the status and results of a visual creation job.

​
id
string
required

Unique identifier for the visual creation job

Examples:

"visual_123456789"

​
status
enum<string>
required

Current status of the visual creation job

Available options:
QUEUED,
PENDING_WORKER,
PROCESSING,
ERRORED,
SUCCEEDED,
CANCELED
Examples:

"SUCCEEDED"

​
prompt
string
required

Text prompt used for the visual creation

Examples:

"A beautiful sunset over mountains"

​
type
enum<string>
required

Type of visual creation job

Available options:
IMAGE,
VIDEO,
EDIT,
REMIX,
INPAINT,
UPSCALE
Examples:

"IMAGE_GENERATION"

​
numImages
number
required

Number of images generated

Examples:

1

​
dimensions
enum<string>
required

Dimensions of the generated images

Available options:
SQUARE,
PORTRAIT,
LANDSCAPE
Examples:

"SQUARE"

​
createdAt
string
required

Timestamp when the job was created

Examples:

"2024-01-15T10:30:00Z"

​
updatedAt
string
required

Timestamp when the job was last updated

Examples:

"2024-01-15T10:35:00Z"

​
outputUrls
string[]
required

Array of URLs to the generated images

Examples:
[
  "https://storage.example.com/images/generated_1.jpg"
]
​
lora
object | null
required

Primary LoRA model used for generation

Examples:

null

​
secondaryLora
object | null
required

Secondary LoRA model used for generation

Examples:

null

⌘I