Skip to content
Skills Library
Design & UX · Tool integration

ttapi-openai-image

/ttapi-openai-image

Generate and edit images with TTAPI OpenAI GPT Image 2 and GPT Image 2.5 routes. Use for OpenAI Image, GPT Image, 商品图、海报、图片编辑 and existing GPT image jobs; use another product Skill when the user names Nano Banana or another image family.

Licence
MIT
Last repository change
26.10.2026

Assessment and security

95/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content30 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
9
Scripts
3
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 3 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/catalog.mjs, scripts/local-edit.mjs, scripts/ttapi.mjs

What it does and when to use it

Generate and edit images with TTAPI OpenAI GPT Image 2 and GPT Image 2.5 routes. Use for OpenAI Image, GPT Image, 商品图、海报、图片编辑 and existing GPT image jobs; use another product Skill when the user names Nano Banana or another image family.

Original author description

Generate and edit images with TTAPI OpenAI GPT Image 2 and GPT Image 2.5 routes. Use for OpenAI Image, GPT Image, 商品图、海报、图片编辑 and existing GPT image jobs; use another product Skill when the user names Nano Banana or another image family.

How it works

  1. Operations
  2. Run in the user's project
  3. Product references
Original SKILL.md headings · 41 lines, 472 words
SKILL.md preview
---
name: ttapi-openai-image
description: Generate and edit images with TTAPI OpenAI GPT Image 2 and GPT Image 2.5 routes. Use for OpenAI Image, GPT Image, 商品图、海报、图片编辑 and existing GPT image jobs; use another product Skill when the user names Nano Banana or another image family.
---

# TTAPI OpenAI Image

Use the self-contained Node.js 20+ client in this directory. Read `TTAPI_API_KEY` from the agent's execution environment; requests send the `TT-API-KEY` header to the documented TTAPI gateway. If missing, ask the user to configure it locally, without pasting a secret into chat, source files, request JSON or command arguments.

Read the relevant reference and inspect `schema` for the selected operation. The [official docs index](https://docs.ttapi.io/llms.txt) locates current endpoint documentation. Keep the user's chosen product, model and requested quantity. The local `models` command lists this version's supported contract, not account availability.

## Operations

| Operation | Use | Result |
| --- | --- | --- |
| `image2-generate` | Generate images with gpt-image-2 or the standard GPT Image 2.5 Flare/Sunburst variants. Returns base64 directly. | Synchronous response |
| `image2-edit` | Edit with gpt-image-2 using JSON image URL/data URL/File ID references. Returns base64 directly; no multipart upload. | Synchronous response |
| `image2-async` | Use TTAPI’s separately documented unofficial GPT Image 2/2 Plus/2.5 route. Generate or guide edits with public reference URLs and retrieve by jobId. | Task ID; resume the same job |

## Run in the user's project

Resolve this installed directory before running the client; the following commands run from it.

```sh
node scripts/ttapi.mjs models
node scripts/ttapi.mjs schema image2-generate
node scripts/ttapi.mjs submit image2-generate --input request.json --dry-run
node scripts/ttapi.mjs submit image2-generate --input request.json --wait --output /absolute/path/to/project/assets
```

Build `request.json` from the user's actual brief and the selected schema. Bundled examples demonstrate input shapes; replace their sample prompts, example.com media URLs and placeholder previous IDs. A local file is not a public URL; use local file helpers only where the selected reference explicitly supports them.

`models`, `schema` and `--dry-run` work locally without a Key or API call. An explicit creation/edit request authorizes that requested paid operation; submit it once without another confirmation cycle. Do not add paid variants, batches or replacement jobs without a request. For unspecified quantity, default to one generation and explain products that intrinsically return multiple outputs.

For asynchronous operations retain the operation and returned task ID, then resume with `node scripts/ttapi.mjs get OPERATION --task SAVED_ID --wait --output /absolute/project/assets`. Submission acknowledgement is not completion. A timeout or unknown POST outcome must not trigger another paid submission. For synchronous endpoints, do not invent an asynchronous fetch workflow. Report errors and remaining uncertainty faithfully.

Save completed outputs to the user's existing project asset directory when asked, integrate them into the requested component and check the resulting page/player. Return the actual model, status, saved file paths and task ID when available. Retention varies; download useful outputs promptly. Check current [pricing](https://docs.ttapi.io/grids/en/start/pricing/image) before quoting costs.

## Product references

- [gpt image standard](references/gpt-image-standard.md)
- [gpt image async](references/gpt-image-async.md)

Install just this product with `npx skills add ttapi-io/ttapi-skills --skill ttapi-openai-image`. This directory is independent of the legacy combined Skills and needs no MCP server.
Files in this package (9)
  • SKILL.md 4 KB
  • examples/image2-async.json 1 KB
  • examples/image2-edit.json 1 KB
  • examples/image2-generate.json 1 KB
  • references/gpt-image-async.md 2 KB
  • references/gpt-image-standard.md 3 KB
  • scripts/catalog.mjs 11 KB
  • scripts/local-edit.mjs 2 KB
  • scripts/ttapi.mjs 27 KB

Versions

The database has no other skills named ttapi-openai-image.

Database snapshot: 13.11.2026 · package version 7a303f6436e5 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95ttapi-nano-banana
    Generate and edit images through TTAPI Nano Banana, Nano Banana 2 and Pro model families. Use for Nano Banana, Gemini image, 香蕉模型、参考图改图 and Nano Banana product images; this Skill does not generate Gemini videos.
  • 100gpt-image-skill
    Generate or edit images when the user names OpenAI, GPT Image, or a gpt-image model. Use the default image skill when no provider is named.
  • 100gpt-image-skill
    Generate or edit images using OpenAI GPT Image API (gpt-image-2, gpt-image-1, etc). Use ONLY when the user explicitly names OpenAI or GPT as the provider: "gpt image", "openai image", "generate image with openai", "用 openai 画图", "用 GPT 生成图片". For generic image requests without a…
  • 95ttapi-grok-image
    Generate and edit images through TTAPI Grok Imagine and Grok Image models; retrieve asynchronous image tasks and download outputs. Use for Grok图片、Grok生图、Grok改图、参考图编辑. For Grok video use the video product skill instead.
  • 100gpt-image-2-api
    Generate and edit images with gpt-image-2 through a third-party OpenAI-compatible API using .env-configured OPENAI_API_KEY and OPENAI_BASE_URL values. Use when the user asks to create images, edit reference images, create visual assets, illustrations, or image variations with a…
  • 100gpt-image-1-5
    Generate and edit images using OpenAI's GPT Image 1.5 model. Use when the user asks to generate, create, edit, modify, change, alter, or update images. Also use when user references an existing image file and asks to modify it in any way (e.g., "modify this image", "change the…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.