API Documentation

Call the ColorizerX public endpoint with a single HTTP POST (see path example below; the app slug is colorizerx). Include the application key in the X-App-Key header. For billed calls, also include the end-user X-Api-Key (generated in the Console).

Getting started

The application identifier is a fixed constant: send it in the X-App-Key header (Monitor field Application.apiKey). When you are signed in, the samples below pick it up from your profile as appKey.
For billed calls, create or copy an end-user API key in the Console and send it as X-Api-Key.
POST multipart/form-data with a single field image: binary file, or text (http(s) URL, raw base64, or data:image/...;base64,...) — the server detects the format automatically.

Endpoint

Replace {MONITOR_URL} with your Monitor deployment origin (no trailing slash; the path already includes /api).

POSThttps://your-monitor.example.com/api/v1/colorize

Request

Name	In	Description
X-App-Key	Header	Required. Application API key (Application.apiKey).
X-Api-Key	Header	Optional. End-user API key for authenticated billing (must belong to that application and be active).
image	Multipart	Required. File (≤ 25 MB) or text — http(s) URL, base64, or data URL; format is auto-detected.
model	Multipart	Optional. Model preference: "large" (default, better quality) or "tiny" (faster inference). Omit to use the server default.

Without X-Api-Key, the request may be treated as anonymous and subject to deployment-specific limits.

Response

On success, returns application/json containing a public download URL for the colorized image.

{ "outputUrl": "https://…/out.png" }

Field / Status	Description
outputUrl	String. The colorized image URL (publicly accessible, time-limited CDN link).
Content-Type	application/json; charset=utf-8
200	Success.

Sample code

Examples use https://your-monitor.example.com as the Monitor base URL.

Input

Model

Language

Sample code

curl -X POST \
  -H 'X-App-Key: INSERT_YOUR_APPLICATION_API_KEY' \
  -H 'X-Api-Key: INSERT_YOUR_USER_API_KEY' \
  -F 'image=@/path/to/file.jpg' \
  -F 'model=large' \
  'https://your-monitor.example.com/api/v1/colorize'
# Response: {"outputUrl":"https://…/out.png"}

HTTP errors

Status	Typical cause
400	Missing X-App-Key, invalid multipart, conflicting `image` file+text, or empty/invalid `image` content.
401	Invalid X-Api-Key, or key does not match the application from X-App-Key.
403	Insufficient credits for authenticated usage.
404	No Monitor application matches the X-App-Key value.
429	Anonymous daily limit or throttling.
503	Application integration is not enabled or not configured.
502	Upstream provider error or unreachable.