API Reference
Job Status
Poll a try-on job by id to retrieve its status and output image URLs. Works for every try-on type.
Every try-on endpoint (clothes, hairstyle, tattoo) is asynchronous: it returns a
jobId immediately, and you poll this endpoint until the job is completed.
The same endpoint works for all try-on types.
GET
https://tryiton.now/api/v1/status/{id}
{id} is the jobId returned when you submitted the try-on.
Request
With an official SDK, use waitForResult to poll until the job is
done, or getStatus to check it once.
// Poll until completion and get the output image URLs
const output = await client.waitForResult(jobId);
// Or check the status once
const status = await client.getStatus(jobId); // { status, output, error }# Poll until completion and get the output image URLs
output = client.wait_for_result(job_id)
# Or check the status once
status = client.get_status(job_id) # Status(status, output, error)curl -X GET https://tryiton.now/api/v1/status/64b7f1a9d9a3b8e5c7f9a123 \
-H "Authorization: Bearer YOUR_API_KEY"Response Fields
| Field | Type | Description |
|---|---|---|
status | string | processing, completed, or failed. |
output | string[] | Present when completed — CDN URLs of the result image(s). |
error | object | null | Present when failed — { name, message }. |
Processing:
Response
{
"ok": true,
"status": "processing",
"error": null
}Completed:
Response
{
"ok": true,
"status": "completed",
"output": [
"https://cdn.tryiton.now/USER_ID/tryons/RESULT.webp"
],
"error": null
}Failed:
Response
{
"ok": true,
"status": "failed",
"output": [],
"error": {
"name": "ProcessingError",
"message": "Try-on failed. Please try again."
}
}Output URLs expire after 72 hours. Download and store any results you want to keep. Jobs can be polled for up to 3 days after they are created. See Data Retention & Privacy.