Generation Status

curl "https://your-store.myshopify.com/apps/proxy_genlook-x/public/generation/gen_xyz789abc"

const response = await fetch(`/apps/proxy_genlook-x/public/generation/${jobId}`);
const status = await response.json();

{
  "generationId": "gen_xyz789abc",
  "status": "COMPLETED",
  "resultImageKey": "generations/gen_xyz789abc.jpg",
  "resultImageUrl": "https://storage.googleapis.com/bucket-name/generations/gen_xyz789abc.jpg?X-Goog-Signature=...",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:32:15Z"
}

{
  "generationId": "gen_xyz789abc",
  "status": "FAILED",
  "errorMessage": "Failed to process image: Invalid image format",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:45Z"
}

{
  "generationId": "gen_xyz789abc",
  "status": "PENDING",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

GET

public

generation

:id

curl "https://your-store.myshopify.com/apps/proxy_genlook-x/public/generation/gen_xyz789abc"

const response = await fetch(`/apps/proxy_genlook-x/public/generation/${jobId}`);
const status = await response.json();

{
  "generationId": "gen_xyz789abc",
  "status": "COMPLETED",
  "resultImageKey": "generations/gen_xyz789abc.jpg",
  "resultImageUrl": "https://storage.googleapis.com/bucket-name/generations/gen_xyz789abc.jpg?X-Goog-Signature=...",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:32:15Z"
}

{
  "generationId": "gen_xyz789abc",
  "status": "FAILED",
  "errorMessage": "Failed to process image: Invalid image format",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:45Z"
}

{
  "generationId": "gen_xyz789abc",
  "status": "PENDING",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Poll this endpoint until status is COMPLETED or FAILED. Recommended interval: every 2 seconds, max 60 attempts.

Path Parameters

string

required

The jobId from the create generation response.

curl "https://your-store.myshopify.com/apps/proxy_genlook-x/public/generation/gen_xyz789abc"

const response = await fetch(`/apps/proxy_genlook-x/public/generation/${jobId}`);
const status = await response.json();

Response

string

required

The generation job ID.

string

required

PENDING | PROCESSING | COMPLETED | FAILED

string

Storage key of the generated image. Present when COMPLETED.

string

Temporary signed URL of the generated image. Present when COMPLETED.

string

Error description. Present when FAILED.

string

required

ISO 8601 timestamp.

string

required

ISO 8601 timestamp.

{
  "generationId": "gen_xyz789abc",
  "status": "COMPLETED",
  "resultImageKey": "generations/gen_xyz789abc.jpg",
  "resultImageUrl": "https://storage.googleapis.com/bucket-name/generations/gen_xyz789abc.jpg?X-Goog-Signature=...",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:32:15Z"
}

{
  "generationId": "gen_xyz789abc",
  "status": "FAILED",
  "errorMessage": "Failed to process image: Invalid image format",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:45Z"
}

{
  "generationId": "gen_xyz789abc",
  "status": "PENDING",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Polling Example

async function pollGeneration(jobId) {
  for (let i = 0; i < 60; i++) {
    const res = await fetch(`/apps/proxy_genlook-x/public/generation/${jobId}`);
    const data = await res.json();

    if (data.status === 'COMPLETED') return data;
    if (data.status === 'FAILED') throw new Error(data.errorMessage);

    await new Promise(r => setTimeout(r, 2000));
  }
  throw new Error('Generation timeout');
}

Most try-ons finish in 10 to 20 seconds. Allow up to 60 seconds before treating a generation as unusually slow.

Create Generation Rate a Generation

Getting Started

WooCommerce / WordPress

Virtual Try-On for Retail

Integrations

Custom Integrations (Developers)

Widget API Reference

Help

Path Parameters

Response

Polling Example

​Path Parameters

​Response

​Polling Example

Path Parameters

Response

Polling Example