Guides
Submitting generations
How to create try-on jobs and list them via the Integration API.
Submitting generations
Create a job
curl -sS -X POST "https://api.drapeiton.com/v1/generations" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"person_image_url": "https://…/person.jpg",
"garment_image_url": "https://…/garment.jpg",
"category": "tops",
"end_user_id": "shopper-optional-id"
}'Required fields
| Field | Description |
|---|---|
person_image_url | Public URL of the person image |
garment_image_url | Public URL of the garment image |
category | tops, bottoms, or one-pieces |
Optional fields
| Field | Description |
|---|---|
end_user_id | Your shopper id (string, max 100). Enables cooldown / monthly limits. |
seed | Integer seed for reproducibility (range documented in API reference) |
num_timesteps, guidance_scale | Quality-related parameters (defaults and bounds in API reference) |
Full schemas: API Reference.
Response
202 Accepted with:
{
"id": "job_…",
"status": "submitted",
"created_at": "…"
}One credit is reserved on accept. Continue with Handling results.
List jobs
curl -sS "https://api.drapeiton.com/v1/generations?limit=20&page=1" \
-H "X-API-Key: YOUR_API_KEY"Optional query: status filter using customer-facing statuses (submitted, queued, processing, succeeded, failed). Pagination fields are documented in the API reference.
Get one job
curl -sS "https://api.drapeiton.com/v1/generations/JOB_ID" \
-H "X-API-Key: YOUR_API_KEY"