Gallery of images grouped by job
Returns image results organized by batch job with pagination support. Includes job statistics and filtered/sorted image results.
Authorization
token_auth Token-based authentication using access tokens.
In: header
Query Parameters
Page number.
1Items per page.
201 <= value <= 100Sort order.
"desc""asc" | "desc"Filter by specific project ID (optional).
nullFilter by image status (optional).
nullFilter by feedback status (optional). Can include multiple values.
nullSort by field (default: original_filename).
"original_filename""original_filename" | "quality_score"Filter by ownership: 'mine' for own items, 'shared' for group members' items.
nullFilter to images assigned any of these tag IDs (OR). Repeated param: ?tag_ids=a&tag_ids=b.
nullFilter by specific job ID (optional).
nullFilter by job type (optional). model_swap, flat_2_model, or identity_preprocessing.
nullLimit images per job (default: 50, max: 200).
501 <= value <= 200Search by job ID (optional). Overrides job_id if provided.
nullResponse Body
application/json
application/json
curl -X GET "https://v2.api.piktid.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",
"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,
"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,
"tags": []
}
],
"processing_options": null
}
]
}{
"error": "Invalid request",
"detail": [
{
"field": null,
"message": "string",
"position": "query"
}
]
}