Validate and clean AI images from your pipeline.

Returns the authenticated account, plan, available credits, and concurrent job limit.

{
  "account": { "uuid": "account-uuid", "email": "you@example.com" },
  "plan": {
    "code": "pro",
    "name": "Pro",
    "monthly_credits": 1000,
    "concurrent_jobs": 2,
    "api_access": true
  },
  "credits": { "available": 850 },
  "concurrent_job_limit": 2
}

Creates an API upload record and returns a presigned S3 form. The form expires after 15 minutes.

curl https://twotensors.ai/api/v1/uploads/presign \
  -H "Authorization: Bearer tt_live_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "sample.jpg",
    "content_type": "image/jpeg",
    "byte_size": 123456
  }'

{
  "upload": {
    "uuid": "upload-uuid",
    "status": "awaiting_upload",
    "upload_method": "presigned"
  },
  "presigned_post": {
    "url": "https://...",
    "fields": { "key": "incoming/..." },
    "key": "incoming/...",
    "bucket": "uploads-bucket"
  }
}

Validates an image and returns upload metadata, detected dimensions, slop_score, and visible Gemini watermark status. Provide exactly one input: upload_id, multipart image, or image_url.

• Presigned
• Multipart
• URL import

curl https://twotensors.ai/api/v1/validations \
  -H "Authorization: Bearer tt_live_your_token" \
  -H "Content-Type: application/json" \
  -d '{ "upload_id": "upload-uuid" }'

curl https://twotensors.ai/api/v1/validations \
  -H "Authorization: Bearer tt_live_your_token" \
  -F "image=@sample.jpg;type=image/jpeg"

curl https://twotensors.ai/api/v1/validations \
  -H "Authorization: Bearer tt_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: validation-001" \
  -d '{ "image_url": "https://example.com/sample.jpg" }'

{
  "upload": {
    "uuid": "upload-uuid",
    "status": "validated",
    "upload_method": "multipart",
    "original_filename": "sample.jpg",
    "content_type": "image/jpeg",
    "byte_size": 123456,
    "image_uuid": "image-uuid",
    "slop_score": 0.42,
    "gemini_watermark_removed": true,
    "gemini_watermark_status": "removed",
    "image_width_pixels": 1024,
    "image_height_pixels": 768
  }
}

Fetches the current upload status and validation result for an API upload UUID.

curl https://twotensors.ai/api/v1/image_uploads/upload-uuid \
  -H "Authorization: Bearer tt_live_your_token"

Starts a cleaning job for a validated upload. Supported detector strengths are strong and medium. The aliases balanced and subtle map to those values. detector_bypass defaults to true, while remove_synthid_watermark defaults to false. Set remove_synthid_watermark to true to run SynthID removal, and set synthid_strength to low, medium, high, or x_high. synthid_strength defaults to medium. Set detector_bypass to false when you only want the SynthID stage.

curl https://twotensors.ai/api/v1/bypasses \
  -H "Authorization: Bearer tt_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: bypass-001" \
  -d '{
    "api_image_upload_id": "upload-uuid",
    "strength": "strong",
    "synthid_strength": "high",
    "downscale_to_longest_side": 1024,
    "detector_bypass": true,
    "remove_synthid_watermark": true
  }'

{
  "bypass": {
    "bypass_job_uuid": "job-uuid",
    "uuid": "job-uuid",
    "status": "succeeded",
    "strength": "strong",
    "synthid_strength": "high",
    "detector_bypass_requested": true,
    "credit_cost": 6,
    "output_url": "https://..."
  }
}

Returns bypass job status, processing dimensions, cost, errors, and a temporary output_url when the job succeeded.

curl https://twotensors.ai/api/v1/bypasses/job-uuid \
  -H "Authorization: Bearer tt_live_your_token"

Redirects with 303 See Other to a presigned download URL for the final cleaned output of a succeeded bypass job.

curl -I https://twotensors.ai/api/v1/bypasses/job-uuid/download \
  -H "Authorization: Bearer tt_live_your_token"

Deletes an API upload or its validated user image. Pass either an API upload UUID or the linked image UUID.

curl -X DELETE https://twotensors.ai/api/v1/images/upload-or-image-uuid \
  -H "Authorization: Bearer tt_live_your_token"

{ "success": true }