Image Processing
Task progress is available through WebSocket. See Task Progress Query.
Gitruck Cloud image processing APIs provide a variety of AI-powered capabilities including removing black borders, canvas resize, smart collage generation, camera movement effects, watermark removal, and more.
General Notes
All image processing APIs use an asynchronous task model:
- Upload file: Call the File Upload API to get a
file_id. - Create task: Call the corresponding processing API (
POST) with thefile_idto create a task and receive atask_id. - Poll for result: Call the query API (
GET) to poll the task status. Results are available whenstatusbecomescompleted.
💡 Tip: Poll every 2–5 seconds.
API List
| API | Path | Description |
|---|---|---|
| Remove Black Borders | /task/image_blackborder_remove | Auto-detect and remove black borders |
| Canvas Resize | /task/image_canvas_adapt | Resize image to a target canvas size |
| Smart Collage / Cover | /task/image_classic_template | Generate collage or cover from multiple images |
| Image Matting | /task/image_matting | Automatically separate subjects from backgrounds and generate transparent-background assets |
| Image Camera Move | /task/image_move | Convert static image to video with camera movement |
| Remove Watermark | /task/image_purify | Remove watermarks and logos from images |
| Image to Live Photo | /task/image_to_live | Convert static image to a micro-animated video |
| Long Image to Square | /task/image_to_square | Intelligently split and stitch a long image into a square |
| Vertical Stitch | /task/image_vertical_stitch | Stitch multiple images vertically into a long image |
Supported File Formats
Image processing APIs support: jpg, jpeg, png, webp, bmp.