TryRobe API quickstart
This quickstart describes the public Business API contract. Create and verify a Business account, generate a license key, keep it on your server, and use a unique idempotency key for each customer action.
1. Authenticate from your backend
Send the Business license key as a Bearer token. Never expose it to a browser or app binary. Every generation request must include an Idempotency-Key of 8 to 100 supported characters.
Authorization: Bearer tr_live_REPLACE_WITH_YOUR_KEY
Idempotency-Key: customer-action-unique-id2. Submit public HTTPS image URLs
Use POST /v1/tryon with clear person and product image URLs.
POST https://api.tryrobe.in/v1/tryon
Content-Type: application/json
{
"human_image_url": "https://merchant.example/person.jpg",
"product_image_url": "https://merchant.example/product.jpg",
"product_url": "https://merchant.example/products/example",
"garment_scope": "complete_outfit"
}3. Persist and check the job
Store the returned job_id and request_id. Poll GET /v1/tryon/:jobId or configure a signed webhook for production completion.
Frequently asked questions
What status means the result is ready?
Treat the job as complete only when status is succeeded and an output image URL is present.
Can a failed request consume credits?
Credits are locked atomically when a valid job is accepted and released for terminal generation failures or timeouts according to the credit engine.