Gallery

Gallery of images grouped by job

GET
/gallery/by-job

Returns image results organized by batch job with pagination support. Includes job statistics and filtered/sorted image results.

Authorization

token_auth
headerAuthorizationBearer <token>

Token-based authentication using access tokens.

Query Parameters

page?Page

Page number.

Default1
per_page?Per Page

Items per page.

Range1 <= value <= 100
Default20
order?Order

Sort order.

Default"desc"
Value in"asc""desc"
project_id?|

Filter by specific project ID (optional).

Defaultnull
status?|

Filter by image status (optional).

Defaultnull
feedback?array<>|

Filter by feedback status (optional). Can include multiple values.

Defaultnull
sort_by?Sort By

Sort by field (default: original_filename).

Default"original_filename"
Value in"original_filename""quality_score"
ownership?|

Filter by ownership: 'mine' for own items, 'shared' for group members' items.

Defaultnull
tag_ids?array<string>|

Filter to images assigned any of these tag IDs (OR). Repeated param: ?tag_ids=a&tag_ids=b.

Defaultnull
job_id?|

Filter by specific job ID (optional).

Defaultnull
job_type?|

Filter by job type (optional). model_swap, flat_2_model, or identity_preprocessing.

Defaultnull
max_images_per_job?Max Images Per Job

Limit images per job (default: 50, max: 200).

Range1 <= value <= 200
Default50
search?|

Search by job ID (optional). Overrides job_id if provided.

Defaultnull

Response Body

Successful Response

application/json
  1. response
pagination*

Pagination information.

jobs*array<>

List of jobs with their images.

curl -X GET "https://example.com/gallery/by-job"
{  "pagination": {    "page": 0,    "per_page": 0,    "total": 0,    "pages": 0,    "has_next": true,    "has_prev": true  },  "jobs": [    {      "job_id": "string",      "job_type": "string",      "job_status": "string",      "identity_code": "string",      "identity_name": "string",      "identity_thumbnail": null,      "project_id": 0,      "project_name": "string",      "project_key": "string",      "created_at": "string",      "updated_at": "string",      "created_by": "string",      "total_images": 0,      "completed_images": 0,      "failed_images": 0,      "images": [        {          "id": 0,          "job_id": "string",          "image_index": 0,          "group_index": 0,          "version": 0,          "original_filename": "string",          "download_filename": null,          "inputs": [            {              "full_size": null,              "thumbnail": null,              "uuid": null,              "tags": []            }          ],          "output": {            "full_size": null,            "thumbnail": null,            "uuid": null          },          "input_description": {},          "model_used": null,          "output_dims": null,          "detail_needs_review": false,          "detail_review_reason": null,          "quality": null,          "quality_pending": false,          "quality_history": [],          "takes": null,          "garment_drift": null,          "status": "string",          "quality_score": 0,          "processing_time": 0,          "error_message": "string",          "feedback": "like",          "feedback_comment": "string",          "created_at": "string",          "review_status": null,          "reviewed_before": false,          "review_annotations": null,          "produced_by": null,          "previous_output": null,          "previous_annotations": null,          "approved_round": null,          "retouch_package": null,          "retouch_claim": null,          "ai_retouch": null,          "ai_fix": null,          "tags": [],          "provenance": null,          "reviews": []        }      ],      "processing_options": null,      "quality_summary": null,      "review": null    }  ]}