thumbnailgpt 1.0.7 → 1.0.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -27
- package/dist/client.js +1 -1
- package/dist/index.js +6 -4
- package/dist/types.d.ts +1 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -15,14 +15,14 @@ Generate, iterate, download, and manage viral, high-CTR YouTube thumbnails direc
|
|
|
15
15
|
|
|
16
16
|
## Highlights
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
18
|
+
- **Zero-Install Execution**: Run any command immediately via `npx thumbnailgpt`.
|
|
19
|
+
- **Multi-Resolution Rendering**: Generate in standard **1K**, HD **2K**, or Ultra-HD **4K**.
|
|
20
|
+
- **Dual Aspect Ratios**: Native support for **16:9** (YouTube standard) and **9:16** (YouTube Shorts / TikTok / Reels).
|
|
21
|
+
- **Creator Persona Consistency**: Feature your trained creator persona across any generation using `--persona <id>`.
|
|
22
|
+
- **Conversational Iteration**: Thread your edits using `--chat <chatId>` to refine text, lighting, facial expression, or background details.
|
|
23
|
+
- **Interactive Terminal REPL**: Full interactive terminal chat session with live preview links (`thumbnailgpt chat`).
|
|
24
|
+
- **Scripting & Automation Ready**: Output raw image URLs with `--url-only` or machine-readable JSON with `--json` for shell pipes, webhooks, and GitHub Actions.
|
|
25
|
+
- **Account Deletion Guardrails**: Enforces production security; destructive deletions are restricted to the web dashboard to prevent accidental loss from automated scripts or autonomous AI agents.
|
|
26
26
|
|
|
27
27
|
---
|
|
28
28
|
|
|
@@ -62,20 +62,16 @@ npx thumbnailgpt login
|
|
|
62
62
|
npx thumbnailgpt login --key tgpt_live_YOUR_API_KEY
|
|
63
63
|
```
|
|
64
64
|
|
|
65
|
-
### 2. Verify Your Account
|
|
65
|
+
### 2. Verify Your Account Status
|
|
66
66
|
```bash
|
|
67
67
|
npx thumbnailgpt whoami
|
|
68
68
|
```
|
|
69
69
|
*Output:*
|
|
70
70
|
```text
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
Pricing Tiers:
|
|
76
|
-
1K (Standard): 10 credits
|
|
77
|
-
2K (HD): 20 credits
|
|
78
|
-
4K (Ultra HD): 30 credits
|
|
71
|
+
ThumbnailGPT Account
|
|
72
|
+
Account: user@example.com
|
|
73
|
+
Plan Status: ACTIVE
|
|
74
|
+
Credits: 583 available
|
|
79
75
|
```
|
|
80
76
|
|
|
81
77
|
### 3. Generate a Thumbnail
|
|
@@ -84,7 +80,7 @@ npx thumbnailgpt generate "Extreme 100 Days Hardcore Survival in Minecraft" --re
|
|
|
84
80
|
```
|
|
85
81
|
*Output:*
|
|
86
82
|
```text
|
|
87
|
-
|
|
83
|
+
Generation complete (14s)
|
|
88
84
|
|
|
89
85
|
Thumbnail URL: https://assets.thumbnailgpt.com/generations/.../thumbnail.png
|
|
90
86
|
Chat Thread: https://thumbnailgpt.com/studio/3c9d1e5f-...
|
|
@@ -109,7 +105,7 @@ npx thumbnailgpt generate [options] <prompt>
|
|
|
109
105
|
| Flag | Short | Default | Description |
|
|
110
106
|
| :--- | :---: | :---: | :--- |
|
|
111
107
|
| `--ratio <ratio>` | `-r` | `16:9` | Aspect ratio: `16:9` (YouTube standard) or `9:16` (Shorts / Reels) |
|
|
112
|
-
| `--res <resolution>` | `-q` | `1K` | Resolution quality: `1K
|
|
108
|
+
| `--res <resolution>` | `-q` | `1K` | Resolution quality: `1K`, `2K`, or `4K` |
|
|
113
109
|
| `--ref <urls...>` | | | Up to 5 public image URLs or base64 data URIs as visual references |
|
|
114
110
|
| `--yt <url>` | | | YouTube video URL to extract title, context, and current thumbnail |
|
|
115
111
|
| `--persona <personaId>` | `-p` | | Creator Persona UUID to feature in the generated thumbnail |
|
|
@@ -172,10 +168,9 @@ npx thumbnailgpt chat 3c9d1e5f-c648-4b3c-a6f0-811d073c22c2
|
|
|
172
168
|
```
|
|
173
169
|
|
|
174
170
|
Commands available inside interactive chat mode:
|
|
175
|
-
- Type your prompt
|
|
171
|
+
- Type your prompt to iterate.
|
|
176
172
|
- `/url` — Display the latest generated thumbnail URL.
|
|
177
173
|
- `/open` — Open the current thumbnail in your default web browser.
|
|
178
|
-
- `/cost` — View credit cost tiers.
|
|
179
174
|
- `/help` — Display interactive mode shortcuts.
|
|
180
175
|
- `/exit` or `exit` — Exit interactive session.
|
|
181
176
|
|
|
@@ -183,7 +178,7 @@ Commands available inside interactive chat mode:
|
|
|
183
178
|
|
|
184
179
|
### `thumbnailgpt whoami`
|
|
185
180
|
|
|
186
|
-
Display your authenticated email, subscription
|
|
181
|
+
Display your authenticated email, subscription status, and available balance.
|
|
187
182
|
|
|
188
183
|
```bash
|
|
189
184
|
npx thumbnailgpt whoami
|
|
@@ -304,17 +299,17 @@ Now you can instruct Claude or Cursor:
|
|
|
304
299
|
|
|
305
300
|
To prevent accidental data loss or unauthorized bulk deletions by third-party scripts and autonomous AI agents:
|
|
306
301
|
- Destructive deletions (`DELETE` operations) are disabled over Personal API Keys, the CLI, and the MCP server.
|
|
307
|
-
- Resource creation, iteration,
|
|
302
|
+
- Resource creation, iteration, account balance checks, persona styling, and asset retrievals are fully enabled.
|
|
308
303
|
- Deletions can be performed safely by the account owner inside the **[ThumbnailGPT Web Studio](https://thumbnailgpt.com/studio)**.
|
|
309
304
|
|
|
310
305
|
---
|
|
311
306
|
|
|
312
307
|
## Support & Resources
|
|
313
308
|
|
|
314
|
-
-
|
|
315
|
-
-
|
|
316
|
-
-
|
|
317
|
-
-
|
|
309
|
+
- Web Studio: [https://thumbnailgpt.com](https://thumbnailgpt.com)
|
|
310
|
+
- API & CLI Docs: [https://thumbnailgpt.com/docs](https://thumbnailgpt.com/docs)
|
|
311
|
+
- API Key Management: [https://thumbnailgpt.com/studio?settings=api-key](https://thumbnailgpt.com/studio?settings=api-key)
|
|
312
|
+
- Support Email: [support@thumbnailgpt.com](mailto:support@thumbnailgpt.com)
|
|
318
313
|
|
|
319
314
|
---
|
|
320
315
|
|
package/dist/client.js
CHANGED
|
@@ -17,7 +17,7 @@ export class ThumbnailGPTClient {
|
|
|
17
17
|
"Content-Type": "application/json",
|
|
18
18
|
Authorization: `Bearer ${this.apiKey}`,
|
|
19
19
|
Origin: this.apiUrl,
|
|
20
|
-
"User-Agent": "thumbnailgpt-cli/1.0.
|
|
20
|
+
"User-Agent": "thumbnailgpt-cli/1.0.8",
|
|
21
21
|
...options.headers,
|
|
22
22
|
};
|
|
23
23
|
const res = await fetch(url, { ...options, headers });
|
package/dist/index.js
CHANGED
|
@@ -55,7 +55,7 @@ const program = new Command();
|
|
|
55
55
|
program
|
|
56
56
|
.name("thumbnailgpt")
|
|
57
57
|
.description("Official CLI for ThumbnailGPT — Generate, iterate, and manage thumbnails from your terminal")
|
|
58
|
-
.version("1.0.
|
|
58
|
+
.version("1.0.8");
|
|
59
59
|
// 1. Auth Login
|
|
60
60
|
program
|
|
61
61
|
.command("login")
|
|
@@ -108,9 +108,11 @@ program
|
|
|
108
108
|
const credits = await client.getCredits();
|
|
109
109
|
spinner.stop();
|
|
110
110
|
console.log(pc.bold("\nThumbnailGPT Account"));
|
|
111
|
+
if (credits.email) {
|
|
112
|
+
console.log(`${pc.gray("Account:")} ${pc.white(pc.bold(credits.email))}`);
|
|
113
|
+
}
|
|
111
114
|
console.log(`${pc.gray("Plan Status:")} ${pc.cyan(credits.subscription_status.toUpperCase())}`);
|
|
112
|
-
console.log(`${pc.gray("Credits:")} ${pc.green(pc.bold(String(credits.credits)))} available`);
|
|
113
|
-
console.log(`${pc.gray("Cost Tiers:")} 1K = 10 cr | 2K = 20 cr | 4K = 30 cr\n`);
|
|
115
|
+
console.log(`${pc.gray("Credits:")} ${pc.green(pc.bold(String(credits.credits)))} available\n`);
|
|
114
116
|
}
|
|
115
117
|
catch (err) {
|
|
116
118
|
handleError(err, spinner);
|
|
@@ -143,7 +145,7 @@ program
|
|
|
143
145
|
}
|
|
144
146
|
const res = (options.res || "1K").toUpperCase().trim();
|
|
145
147
|
if (res !== "1K" && res !== "2K" && res !== "4K") {
|
|
146
|
-
console.error(pc.red(`\nError: Invalid resolution "${res}". Supported resolutions: 1K
|
|
148
|
+
console.error(pc.red(`\nError: Invalid resolution "${res}". Supported resolutions: 1K, 2K, 4K`));
|
|
147
149
|
process.exit(1);
|
|
148
150
|
}
|
|
149
151
|
const client = new ThumbnailGPTClient();
|
package/dist/types.d.ts
CHANGED
package/package.json
CHANGED