ttapi-image
TTAPI Image
Use the bundled Node.js 20+ client. Paths below are relative to this installed skill directory. Keep the complete directory, including scripts/ and references/.
Read TTAPI_API_KEY from the local environment; the client sends it in the TT-API-KEY header. Get an account/key from https://dashboard.ttapi.io. If missing, ask the user to configure the environment variable locally, without pasting the key into chat or a command argument.
Choose the correct route
| Operation | Use | Response | Read when selected |
|---|---|---|---|
image2-generate |
Standard GPT Image 2, 2.5 Flare/Sunburst text-to-image | Synchronous base64 images | GPT standard |
image2-edit |
Standard GPT Image 2 source-image/mask edits | Synchronous base64 images | GPT standard |
image2-async |
User chooses TTAPI's unofficial GPT Image 2/2 Plus/2.5 route | Job ID, then fetch | GPT asynchronous |
nano-generate |
Any documented Nano Banana model; prompt-only or reference edits | Synchronous image URL | Nano Banana |
Keep an explicitly chosen model and route. gpt-image-2.5 on the unofficial route and gpt-image-2.5-flare / gpt-image-2.5-sunburst on the standard route are different API values. Do not silently substitute them. If the user asks only for GPT Image 2 without a route preference, use image2-generate, or image2-edit when source images are supplied. models lists the bundled contract, not live account availability.