Gallery
Gallery of images grouped by project
Returns image results organized by project with pagination support. Includes project statistics and filtered/sorted image results.
Authorization
token_auth AuthorizationBearer <token>
Token-based authentication using access tokens.
In: header
Query Parameters
page?Page
Page number.
Default
1per_page?Per Page
Items per page.
Default
20Range
1 <= value <= 100order?Order
Sort order.
Default
"desc"Value in
"asc" | "desc"project_id?|
Filter by specific project ID (optional).
Default
nullstatus?|
Filter by image status (optional).
Default
nullfeedback?array<>|
Filter by feedback status (optional). Can include multiple values.
Default
nullsort_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.
Default
nullmax_images_per_project?Max Images Per Project
Limit images per project (default: 50, max: 200).
Default
50Range
1 <= value <= 200search?|
Search by project name, key, or ID (optional).
Default
nullResponse Body
application/json
application/json
curl -X GET "https://v2.api.piktid.com/gallery/by-project"{
"pagination": {
"page": 0,
"per_page": 0,
"total": 0,
"pages": 0,
"has_next": true,
"has_prev": true
},
"projects": [
{
"project_id": 0,
"project_name": "string",
"project_key": "string",
"created_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
}
],
"output": {
"full_size": null,
"thumbnail": null,
"uuid": null
},
"input_description": {},
"model_used": null,
"detail_needs_review": false,
"detail_review_reason": 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,
"retouch_claim": null
}
]
}
]
}{
"error": "Invalid request",
"detail": [
{
"field": null,
"message": "string",
"position": "query"
}
]
}Empty