samsarPlaygroundBase URL: https://api.samsar.one
Playground

Image Playground

Use the V2 image aliases, then poll the image status route for result URLs.

V2 request aliases0.5k/1k/2k/4kV1 image status

Endpoint

Send as POST /v2/image/enhance

Auth

Authorization: Bearer <API_KEY>

We will not display your full key.

Status

/v1/image/status?request_id=<request_id>

Image requests return request_id, session_id, and global_status_id. Poll GET /v1/image/status?request_id=<id> for result_url or result_urls and the final billing receipt. Submission has creditsCharged: 0 and billingStatus: PENDING.

Request

Compose and run

https://api.samsar.one/v2/image/enhance
Authorization: Bearer <API_KEY> Bearer ••••••.

Image requests are billed on completion. Retries of the same payload reuse an Idempotency-Key.

Use a new key only to generate another result. Keys stay in this page until it is reloaded.

Defaults
input.image_urlRequired
https://cdn.example.com/look.png
Add key/value

All optional keys are already included in the request payload.

JSON only
Replace input.image_url with your publicly accessible image URL.
Need progress?

Response

Awaiting first run

Expected 200 response shape

{
  "status": "queued",
  "request_id": "<request_id>",
  "session_id": "<request_id>",
  "global_status_id": "<request_id>",
  "case_type": "image_enhance",
  "image_url": "https://cdn.example.com/look.png",
  "resolution": "2K",
  "aspect_ratio": "16:9",
  "creditsCharged": 0,
  "remainingCredits": null,
  "billingStatus": "PENDING"
}
Status endpoint
/v1/image/status?request_id=

Image requests return request_id, session_id, and global_status_id. Poll GET /v1/image/status?request_id=<id> for result_url or result_urls and the final billing receipt. Submission has creditsCharged: 0 and billingStatus: PENDING.