Glif API Runner

Execute Glif workflows programmatically via the Simple API.

API Basics

Base URL: https://simple-api.glif.app Auth: Bearer token from https://glif.app/settings/api-tokens

Running a Glif

curl -X POST https://simple-api.glif.app \
  -H "Authorization: Bearer $GLIF_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "clgh1vxtu0011mo081dplq3xs",
    "inputs": ["your prompt here"]
  }'

Input Formats

Array (positional):

{"id": "glif_id", "inputs": ["input1", "input2"]}

Object (named):

{"id": "glif_id", "inputs": {"prompt": "value", "style": "anime"}}

Response Structure

{
  "output": "https://res.cloudinary.com/.../image.png",
  "outputFull": {"type": "IMAGE", "value": "..."},
  "price": 5,
  "nodes": {...}
}

Key fields:

• output - Final result (URL for images, text for text)
• price - Credits consumed
• error - Error message if failed (still returns 200)

Common Patterns

Image generation:

curl -X POST https://simple-api.glif.app \
  -H "Authorization: Bearer $GLIF_API_TOKEN" \
  -d '{"id": "IMAGE_GLIF_ID", "inputs": ["a cat wearing a hat"]}' \
  | jq -r '.output'

With visibility:

{"id": "glif_id", "inputs": [...], "visibility": "PUBLIC"}

Strict mode (fail on missing inputs):

https://simple-api.glif.app?strict=1

Error Handling

• API returns 200 even on errors - check error field
• Check price to verify credits were consumed
• Token issues return 401/403

Finding Glif IDs

1. Go to glif.app and find a workflow
2. ID is in the URL: glif.app/glifs/{GLIF_ID}
3. Or use the "API" tab on any glif page