Agent skill

glif-api-runner

Run Glif workflows via API. Use when executing AI image/text generation workflows or integrating Glif into apps.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/glif-api-runner

SKILL.md

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

bash
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):

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

Object (named):

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

Response Structure

json
{
  "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:

bash
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:

json
{"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

Didn't find tool you were looking for?

Be as detailed as possible for better results