Skip to main content
All APIs

Studio API

Ask your AI. Studio does the edit.

Your assistant writes an edit recipe. POUYAM Studio shows every step and applies it in your browser — photos, video, PDF, Word and spreadsheets.

Three steps. No uploads.

  1. 01

    Ask

    Tell your assistant what you want, in any language.

  2. 02

    Review

    Open the link. Studio lists every step before anything changes.

  3. 03

    Apply

    Choose your file. The edit runs on your device; export when you like it.

Connect in a minute

Use the MCP server wherever you can — it gives your assistant the live tools. No key or sign-in needed.

In Claude, open Settings → Connectors → Add custom connector, and paste this URL.

MCP URL
https://www.pouyam.com/mcp

Agent Skill

Install the POUYAM Studio skill in Claude, Claude Code, Cursor or any agent that reads SKILL.md files. It knows every step, limit and example.

Claude Code
~/.claude/skills/pouyam-studio/SKILL.md
---
name: pouyam-studio
description: Edit photos, video, PDF, Word
  and spreadsheets in POUYAM Studio.
---

1. create_studio_link (MCP)
2. POST /api/studio/recipe-link
3. No tools? Paste the recipe.

What your AI can edit

Five kinds of files, one recipe format. Unknown steps are skipped with a clear warning.

Photo & RAW

Looks, light and color, LUTs, portrait retouch, crop, rotate, straighten and text.

  • look
  • adjust
  • lut
  • retouch
  • crop
  • text

Video

Grade, trim, speed, fades, volume and captions.

  • trim
  • speed
  • fade
  • volume
  • caption

PDF

Rotate, delete and reorder pages, and add notes.

  • pdf.rotate
  • pdf.delete
  • pdf.reorder
  • pdf.note

Word & text

Find and replace, and add paragraphs or headings.

  • doc.replace
  • doc.append
  • doc.prepend

Spreadsheet

Fill cells with values. Formulas are never written.

  • sheet.set

Try it live

Pick an example. It goes to the real endpoint, and you see exactly what your assistant gets back.

POST /api/studio/recipe-link
{
  "format": "pouyam.studio.recipe/1",
  "title": "Cinematic city post",
  "target": "photo",
  "steps": [
    {
      "op": "look",
      "preset": "cinematic",
      "strength": 70
    },
    {
      "op": "adjust",
      "shadows": 30,
      "vibrance": 15,
      "vignette": -20
    },
    {
      "op": "crop",
      "aspect": "4:5"
    },
    {
      "op": "text",
      "text": "POUYAM SMART CITY",
      "position": "bottom",
      "size": 56
    }
  ]
}

Run an example to see the steps and the Studio link.

Endpoints and files

  • MCP · Streamable HTTP POST https://www.pouyam.com/mcp
  • Capabilities GET https://www.pouyam.com/api/studio/recipe-link
  • Create link POST https://www.pouyam.com/api/studio/recipe-link
  • Guide for assistants GET https://www.pouyam.com/studio-ai/guide.md
  • Recipe JSON Schema GET https://www.pouyam.com/studio-ai/recipe.schema.json
  • OpenAPI · GPT Actions GET https://www.pouyam.com/studio-ai/openapi.json
  • Agent Skill GET https://www.pouyam.com/studio-ai/skill/SKILL.md
  • llms.txt GET https://www.pouyam.com/llms.txt

Limits and privacy

Recipes carry instructions only — no files and no account access. The recipe travels after # in the link, so it never reaches our server when you open it.

60
requests a minute
1,000
requests a day
0
files stored

Quick navigation