---
name: openai-image-edit
description: Discover and invoke the OPENAI_IMAGE_EDIT directory capability using its live contract. Use when a request maps to this exact capability.
---

# OPENAI_IMAGE_EDIT

This Skill is the behavioral expression of [the OPENAI_IMAGE_EDIT directory article](/a/directory/OPENAI_IMAGE_EDIT). The directory row remains the executable contract.

## Operate

1. Read GET /api/directory/OPENAI_IMAGE_EDIT immediately before use.
2. Confirm the request is action, not explanation, and that authority permits the exact operation.
3. Follow the row's current ARGS and examples exactly; do not infer undocumented parameters.
4. Invoke POST /api/dispatch with {"key":"OPENAI_IMAGE_EDIT","body":"<row-shaped args>"}.
5. Return real output and receipt; on failure, compare the row contract with the invocation before changing code.

## Human explanation

# WHAT: OpenAI gpt-image-1.5 edit from a reference image URL. Stores to R2 # WHEN_TO_USE: you need to openai image edit # ARGS: prompt|reference_url|size # EX: [OPENAI_IMAGE_EDIT]arg1|arg2|arg3[/OPENAI_IMAGE_EDIT] ["$1","$2","$3"]

## Call it

Every spelling below is the same call, with this row's own example arguments. `$TERMINAL_KEY` and `$MCP_TOKEN` are the owner's vault variables. Every spelling, with Run: https://miscsubjects.com/console#/api/OPENAI_IMAGE_EDIT

### HTTP · curl — the canonical call

Any terminal or script. {key, body}: the arguments are one string, pipe-separated in the order below. The answer is {ok, ran, result, trace_id, receipt}.

```bash
curl -sS -X POST 'https://ops.miscsubjects.com/api/dispatch' \
  -H "x-terminal-key: $TERMINAL_KEY" \
  -H 'content-type: application/json' \
  --data '{"key":"OPENAI_IMAGE_EDIT","body":"remake this image in 1x1|https://miscsubjects.com/img/up/eagle25.png|1024x1024"}'
```

### HTTP · curl — named arguments

The same door with arguments by name: dispatch puts them in the row's order. Add "idempotency_key":"…" to make a retry safe (72 hours), "shape":true to see the request without sending it.

```bash
curl -sS -X POST 'https://ops.miscsubjects.com/api/dispatch' \
  -H "x-terminal-key: $TERMINAL_KEY" \
  -H 'content-type: application/json' \
  --data '{"key":"OPENAI_IMAGE_EDIT","args":{"prompt":"remake this image in 1x1","reference_url":"https://miscsubjects.com/img/up/eagle25.png","size":"1024x1024"}}'
```

### HTTP · One URL — Safari, a Shortcut, any fetch tool

A GET that runs the call from one address. The address holds a link scoped to this row that expires (ttl in seconds, uses= to cap the count) — never the master key. https://miscsubjects.com/web/run/OPENAI_IMAGE_EDIT?body=…&share=… is the same call for a browser model. Run mints a one-use link for itself.

```
# 1. a link that runs only OPENAI_IMAGE_EDIT, for an hour (share_token in the answer):
curl -sS 'https://ops.miscsubjects.com/api/dispatch?mint_share=1&scope=row:OPENAI_IMAGE_EDIT&ttl=3600' \
  -H "x-terminal-key: $TERMINAL_KEY"

# 2. the address — paste it in Safari, a Shortcut or a model's fetch tool:
https://ops.miscsubjects.com/api/dispatch?invoke=OPENAI_IMAGE_EDIT&body=remake%20this%20image%20in%201x1%7Chttps%3A%2F%2Fmiscsubjects.com%2Fimg%2Fup%2Feagle25.png%7C1024x1024&share=<share_token>
```

### MCP · MCP over HTTP — misc_run

The build's MCP server. misc_run reaches every row by key and leaves a receipt; misc_find finds the key from a phrase. The answer is result.content[0].text.

```bash
curl -sS -X POST 'https://ops.miscsubjects.com/api/mcp' \
  -H 'accept: application/json, text/event-stream' \
  -H "authorization: Bearer $MCP_TOKEN" \
  -H 'content-type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"misc_run","arguments":{"key":"OPENAI_IMAGE_EDIT","args":{"prompt":"remake this image in 1x1","reference_url":"https://miscsubjects.com/img/up/eagle25.png","size":"1024x1024"}}}}'
```

### MCP · Claude Code

Claude Code (terminal, desktop, web). The same server works in any Claude Code session once added.

```
# once, on any machine:
claude mcp add --transport http miscsubjects https://ops.miscsubjects.com/api/mcp --header "Authorization: Bearer $MCP_TOKEN"
# then in a session, the model calls:
mcp__miscsubjects__misc_run {"key":"OPENAI_IMAGE_EDIT","args":{"prompt":"remake this image in 1x1","reference_url":"https://miscsubjects.com/img/up/eagle25.png","size":"1024x1024"}}
```

### CLI · misc (on your Mac)

The misc CLI in ~/.local/bin: its words go to /api/resolve (plan, then run), with TERMINAL_KEY from the vault. Arguments are positional, in the order above. `misc find "words"` finds a row.

```bash
misc run OPENAI_IMAGE_EDIT "remake this image in 1x1" https://miscsubjects.com/img/up/eagle25.png 1024x1024
misc openai image edit "remake this image in 1x1" https://miscsubjects.com/img/up/eagle25.png 1024x1024
```

### CLI · console-app

The Console's own CLI. It reads the key from ~/.build-vault.env or `console-app login`.

```bash
npm install -g https://miscsubjects.com/download/llmasos-console-1.1.0.tgz   # once
console-app call OPENAI_IMAGE_EDIT 'remake this image in 1x1|https://miscsubjects.com/img/up/eagle25.png|1024x1024'
console-app how OPENAI_IMAGE_EDIT   # this page, in the terminal
```

### CLI · One line of text — the build grammar

/api/resolve parses the same line everywhere: "run KEY a b" (arguments in order, quoted when they hold spaces), the key's words ("openai image edit …"), or a phrase it matches to a row. POST runs; {"run":false} returns the plan without running it.

```
# typed, texted to the build, or emitted by a model with no tools:
run OPENAI_IMAGE_EDIT "remake this image in 1x1" https://miscsubjects.com/img/up/eagle25.png 1024x1024

curl -sS -X POST 'https://ops.miscsubjects.com/api/resolve' \
  -H "x-terminal-key: $TERMINAL_KEY" \
  -H 'content-type: application/json' \
  --data '{"line":"run OPENAI_IMAGE_EDIT \"remake this image in 1x1\" https://miscsubjects.com/img/up/eagle25.png 1024x1024","run":true}'
```

### Agents · Tag form — inside an answer

What a model in this build writes mid-answer to call a row; both tags always, even with nothing between them. {"emit": text} runs every tag in a piece of text and returns each result.

```
[OPENAI_IMAGE_EDIT]remake this image in 1x1|https://miscsubjects.com/img/up/eagle25.png|1024x1024[/OPENAI_IMAGE_EDIT]

# run text that carries tags, exactly as a model wrote it:
curl -sS -X POST 'https://ops.miscsubjects.com/api/dispatch' \
  -H "x-terminal-key: $TERMINAL_KEY" \
  -H 'content-type: application/json' \
  --data '{"emit":"[OPENAI_IMAGE_EDIT]remake this image in 1x1|https://miscsubjects.com/img/up/eagle25.png|1024x1024[/OPENAI_IMAGE_EDIT]"}'
```

### Phone · iPhone Shortcut — Get Contents of URL

A Shortcut on the phone, a Siri phrase, an Action Button, or an automation. Swap body for Ask for Input to fill arguments at run time.

```
Action:   Get Contents of URL
URL:      https://ops.miscsubjects.com/api/dispatch
Method:   POST
Headers:  x-terminal-key  →  (Text) your terminal key
          content-type    →  application/json
Request Body: JSON
          key   (Text)  →  OPENAI_IMAGE_EDIT
          body  (Text)  →  remake this image in 1x1|https://miscsubjects.com/img/up/eagle25.png|1024x1024
Then:     Get Dictionary Value  result  from  Contents of URL
```

### Webhook · A webhook any service can call

Stripe, GitHub, Slack, Zapier, a form, a cron elsewhere. The hook id is the credential for an unsigned sender and it may run nothing but OPENAI_IMAGE_EDIT. mode "sync" answers with the result; "async" answers 202 at once.

```
# 1. once: make a hook that may run only OPENAI_IMAGE_EDIT (the answer holds its id and url)
curl -sS -X POST 'https://ops.miscsubjects.com/api/hooks' \
  -H "x-terminal-key: $TERMINAL_KEY" \
  -H 'content-type: application/json' \
  --data '{"label":"OPENAI_IMAGE_EDIT webhook","source":"url","allow_keys":["OPENAI_IMAGE_EDIT"],"effects_max":"write","mode":"sync"}'

# 2. then any service POSTs the arguments, by name, to that url:
curl -sS -X POST 'https://ops.miscsubjects.com/hook/<hook id>/OPENAI_IMAGE_EDIT' \
  -H 'content-type: application/json' \
  --data '{"prompt":"remake this image in 1x1","reference_url":"https://miscsubjects.com/img/up/eagle25.png","size":"1024x1024"}'
```

### Upstream · What runs it

Runs inside the build's own Worker as openaiImageEdit. It has no outside door of its own; every spelling above reaches it.

```
Runs inside the build's own Worker as openaiImageEdit. It has no outside door of its own; every spelling above reaches it.
```