Bulk jobs
Dry-run a bulk generation
Simulates a bulk run, returns validation blockers for each batch and previews credit usage. Never mutates.
Authorization
token_auth AuthorizationBearer <token>
Token-based authentication using access tokens.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://v2.api.piktid.com/bulk-jobs/preview" \ -H "Content-Type: application/json" \ -d '{ "tag_ids": [ "string" ], "job_type": "flat_2_model", "identity_code": "string", "instructions": [ {} ] }'{
"tags": [
{
"tag_id": "string",
"name": "string",
"image_count": 0,
"selected_count": 0,
"eligible": true,
"reason": "string"
}
],
"eligible_count": 0,
"credits": {
"per_job": 0,
"total": 0,
"in_progress": 0,
"available": 0
},
"blockers": [
{
"code": "images_need_picking",
"message": "string"
}
]
}{
"error": "Invalid request",
"detail": [
{
"field": null,
"message": "string",
"position": "query"
}
]
}Empty