# snapwonders-com Hide API

**Canonical:** https://apis.io/apis/snapwonders-com/snapwonders-com-hide-api/  
**Provider:** snapwonders-com — https://apis.io/providers/snapwonders-com/  
**Base URL:** https://snapwonders.com  
**Documentation:** https://snapwonders.com/api

snapwonders-com Hide API is one of 8 APIs that [snapwonders-com](https://apis.io/providers/snapwonders-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Hide. The published artifact set on APIs.io includes an OpenAPI specification.

**Conceal content inside a cover image.** The output is a stego image visually identical to the original cover that carries an encrypted hidden payload. All endpoints require `X-Api-Key`. **Workflow — 7 steps:** **Step 1 — Create a session** `POST /api/session` · body: `{"type":"hide"}` Returns `upload_uid` — include it in every upload for this session. **Step 2 — Upload the content to hide (the secret)** `POST /api/upload` · headers `X-Upload-Uid`, `X-Filename`, `Content-Type`, `X-Upload-Step: 1`, file as the body. This is the image or video you want to conceal. **Step 3 — Upload the cover image** `POST /api/upload` · same headers but `X-Upload-Step: 2`. This is the carrier image the payload will be hidden inside. A hide job needs both steps — `ready_for_job_start` stays false until the cover arrives. Large files or unreliable connections: use TUS instead (`Upload-Metadata: upload_uid <b64(uid)>,step MQ==` / `Mg==`), `POST` to create then `PATCH` the raw binary until all bytes are sent. **Step 4 — Verify both uploads are complete** `GET /api/session/{uid}/files` Both files must show `"status":"completed"` before proceeding. If any show `"pending"`, the upload is still in progress. **Step 5 — Start the processing job** `POST /api/job` · Required: `upload_uid`, `password`, `expiry` Optional encoding: `output_format`, `packing_strategy`, `scale_secret_to_fit`, `strip_cover_metadata`, `strip_secret_metadata`, `video_output_format`, `secret_video_crf`, `secret_video_codec` Returns `{"status":"queued", ...}`. **Step 6 — Poll until done** `GET /api/job/{uid}` — repeat every few seconds. Watch `status`: `queued` → `processing` → `completed` (or `partial` / `failed`). `progress_message` shows per-cover progress while processing. **Step 7 — Download the stego output** `GET /api/job/{uid}/results` Returns `result_files` with a `download_url` for each stego output image (or video).

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/session` | Create an upload session |
| GET | `/api/session/{uid}/files` | List uploaded files for a session |
| POST | `/api/job` | Start a processing job |
| GET | `/api/job/{uid}` | Get job status |
| GET | `/api/job/{uid}/results` | Get job result files |
| GET | `/api/job/download/{assetId}` | Download a hide/reveal result file |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/snapwonders-com/openapi/snapwonders-com-hide-api-openapi.yml

## Other snapwonders-com APIs (7)

- [snapwonders-com Analyse API](https://apis.io/apis/snapwonders-com/snapwonders-com-analyse-api/)
- [snapwonders-com Convert API](https://apis.io/apis/snapwonders-com/snapwonders-com-convert-api/)
- [snapwonders-com MCP API](https://apis.io/apis/snapwonders-com/snapwonders-com-mcp-api/)
- [snapwonders-com Media Upload - Direct API](https://apis.io/apis/snapwonders-com/snapwonders-com-media-upload-direct-api/)
- [snapwonders-com Media Upload - TUS Resumable API](https://apis.io/apis/snapwonders-com/snapwonders-com-media-upload-tus-resumable-api/)
- [snapwonders-com Reveal API](https://apis.io/apis/snapwonders-com/snapwonders-com-reveal-api/)
- [snapwonders-com Status API](https://apis.io/apis/snapwonders-com/snapwonders-com-status-api/)

## Tags

Hide

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/snapwonders-com/snapwonders-com-hide-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/snapwonders-com/.