TryDrobe agent try-on docs

Endpoint

POST https://trydrobe.com/api/agent/try-on

Request body

{
  "personImageUrl": "https://example.com/person.jpg",
  "garmentImageUrl": "https://example.com/garment.png",
  "callbackUrl": "https://agent.example.com/callback",
  "metadata": {
    "source": "agent"
  }
}

Image URLs must be public HTTPS URLs. Private networks, localhost, oversized files, and unsupported image types are rejected before generation.

Payment flow

A request without payment credentials returns HTTP 402 with a standard MPPWWW-Authenticate: Paymentchallenge. Agents create a Stripe Shared Payment Token scoped to TryDrobe’s Stripe profile, then retry the same request withAuthorization: Payment ....

HTTP/1.1 402 Payment Required
WWW-Authenticate: Payment id="...", method="stripe", intent="charge", ...
Cache-Control: no-store

The challenge includes the amount, currency, Stripe method details, and the Stripe profile/network ID. Test integrations should use profile_test_...; live integrations should use profile_....

Example retry

npx @stripe/link-cli mpp pay https://trydrobe.com/api/agent/try-on \
  --spend-request-id lsrq_... \
  --method POST \
  --data '{
    "personImageUrl": "https://example.com/person.jpg",
    "garmentImageUrl": "https://example.com/dress.png",
    "metadata": { "source": "agent" }
  }'

curl https://trydrobe.com/api/agent/try-on \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: tryon_123" \
  -H "Authorization: Payment <mpp-credential>" \
  -d '{
    "personImageUrl": "https://example.com/person.jpg",
    "garmentImageUrl": "https://example.com/dress.png",
    "metadata": { "source": "agent" }
  }'

Successful responses include a standardPayment-Receiptheader whose Stripe reference is the PaymentIntent ID.

Successful response

{
  "success": true,
  "jobId": "uuid",
  "paymentId": "uuid",
  "paymentIntentId": "pi_...",
  "amount_cents": 35,
  "currency": "usd",
  "status": "succeeded",
  "resultUrl": "https://...",
  "resultUrlExpiresIn": 3600,
  "generator": "vertex",
  "latencyMs": 18000
}