Image Processing API

Check API status and discover available endpoints. No authentication required.

curl https://launch.pics/api/v1/health

{
  "status": "ok",
  "version": "1.0.0",
  "api": "launch.pics Image Processing API",
  "tools_count": 38,
  "endpoints": {
    "docs": "https://launch.pics/docs/",
    "tools": "/api/v1/tools",
    "process": "/api/v1/{tool}",
    "pipeline": "/api/v1/pipeline",
    "generate": "/api/v1/generate-workflow",
    "batch": "/api/v1/batch"
  }
}

List all available tools with their parameter specifications. No authentication required.

curl https://launch.pics/api/v1/tools

List all available fonts for text overlays, organized by category. No authentication required.

curl https://launch.pics/api/v1/fonts

Returns fonts organized into categories: sans-serif, serif, monospace, and display. Includes aliases like sans, serif, mono, bold, impact for convenience.

Use font names in any text tool via the font parameter: "font": "roboto-bold"

Popular Fonts

Name	Category	Best For
roboto	Sans-serif	General purpose, clean UI text
roboto-bold	Sans-serif	Headlines, emphasis
open-sans	Sans-serif	Body text, readable at small sizes
lato	Sans-serif	Modern, elegant headings
lato-black	Display	Bold statements, headers
noto-serif	Serif	Classic, formal text
fira-code	Monospace	Code snippets, technical text
impact	Display	Memes, bold impact text

Apply a single tool to an image. Accepts both JSON (base64) and multipart form uploads.

Input Options

Option A: JSON body

curl -X POST https://launch.pics/api/v1/resize \
  -H "X-API-Key: lp_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_base64": "iVBORw0KGgo...",
    "width": 800,
    "height": 600,
    "mode": "contain"
  }'

Option B: Multipart form data

curl -X POST https://launch.pics/api/v1/resize \
  -H "X-API-Key: lp_your_key" \
  -F "image=@photo.jpg" \
  -F "width=800" \
  -F "mode=contain"

Output

Default response is JSON with base64-encoded image:

{
  "image_base64": "iVBORw0KGgo...",
  "format": "PNG",
  "size": {"width": 800, "height": 600},
  "tool": "resize"
}

For binary image response, set Accept: image/png (or image/jpeg, image/webp):

curl -X POST https://launch.pics/api/v1/resize \
  -H "X-API-Key: lp_your_key" \
  -H "Accept: image/png" \
  -F "image=@photo.jpg" \
  -F "width=800" \
  --output resized.png

Chain multiple tools in sequence. Steps execute in order, each receiving the output of the previous step. Maximum 20 steps.

Request

curl -X POST https://launch.pics/api/v1/pipeline \
  -H "X-API-Key: lp_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_base64": "iVBORw0KGgo...",
    "steps": [
      {"tool": "resize", "params": {"width": 800}},
      {"tool": "contrast", "params": {"factor": 1.3}},
      {"tool": "sharpen", "params": {"amount": 1.5}},
      {"tool": "watermark", "params": {"text": "© 2026", "position": "bottom-right", "opacity": 128}},
      {"tool": "compress", "params": {"quality": 85, "format": "WEBP"}}
    ],
    "output_format": "WEBP",
    "quality": 85
  }'

Response

{
  "image_base64": "UklGRp4A...",
  "format": "WEBP",
  "original_size": {"width": 3000, "height": 2000},
  "final_size": {"width": 800, "height": 533},
  "steps_completed": [
    {"step": 0, "tool": "resize", "status": "ok", "size": {"width": 800, "height": 533}},
    {"step": 1, "tool": "contrast", "status": "ok", "size": {"width": 800, "height": 533}},
    {"step": 2, "tool": "sharpen", "status": "ok", "size": {"width": 800, "height": 533}},
    {"step": 3, "tool": "watermark", "status": "ok", "size": {"width": 800, "height": 533}},
    {"step": 4, "tool": "compress", "status": "ok", "size": {"width": 800, "height": 533}}
  ]
}

Describe what you want in natural language, and AI generates a pipeline configuration you can execute with /api/v1/pipeline.

Request

curl -X POST https://launch.pics/api/v1/generate-workflow \
  -H "X-API-Key: lp_your_key" \
  -H "Content-Type: application/json" \
  -d '{"description": "Make it 800px wide, add a vintage film look, and compress as JPEG"}'

Response

{
  "description": "Make it 800px wide, add a vintage film look, and compress as JPEG",
  "steps": [
    {"tool": "resize", "params": {"width": 800}},
    {"tool": "sepia", "params": {"intensity": 0.6}},
    {"tool": "vignette", "params": {"strength": 0.4}},
    {"tool": "contrast", "params": {"factor": 0.9}},
    {"tool": "film-grain", "params": {"amount": 0.3}},
    {"tool": "compress", "params": {"quality": 85, "format": "JPEG"}}
  ],
  "step_count": 6
}

Process up to 10 images with the same tool or pipeline in a single request.

Single tool on multiple images

curl -X POST https://launch.pics/api/v1/batch \
  -H "X-API-Key: lp_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "images": ["base64_image_1...", "base64_image_2...", "base64_image_3..."],
    "tool": "resize",
    "params": {"width": 400},
    "output_format": "WEBP",
    "quality": 80
  }'

Pipeline on multiple images

{
  "images": ["base64_1...", "base64_2..."],
  "steps": [
    {"tool": "resize", "params": {"width": 800}},
    {"tool": "sharpen", "params": {"amount": 1.5}},
    {"tool": "compress", "params": {"quality": 85, "format": "JPEG"}}
  ]
}

Response

{
  "results": [
    {"index": 0, "image_base64": "...", "size": {"width": 400, "height": 300}},
    {"index": 1, "image_base64": "...", "size": {"width": 400, "height": 267}},
    {"index": 2, "error": "Invalid image: cannot identify image file"}
  ],
  "processed": 2,
  "errors": 1,
  "format": "WEBP"
}

Check your API key usage statistics.

curl https://launch.pics/api/v1/keys/usage \
  -H "X-API-Key: lp_your_key"

{
  "name": "my-app",
  "requests": 1247,
  "rate_limit": "200/hour",
  "created": "2026-04-01T21:00:00Z",
  "last_used": "2026-04-01T22:30:00Z"
}