API・自動化連携

Zapier・n8n・Make などの「HTTPリクエスト」機能から、サムネイルの生成・修正・採点を自動化できます。 記事や動画の公開をきっかけにサムネを作る、といった運用に使えます。

1. APIキーを発行する

ダッシュボードの「API・自動化連携」で発行します。キーは発行時に一度だけ表示されるので、安全な場所に保管してください。 漏れた場合はすぐに削除し、新しいキーを発行してください。

2. リクエストを送る

すべてのリクエストに次のヘッダーを付けます。

Authorization: Bearer tai_xxxxxxxx
Content-Type: application/json

例（curl）:

curl -X POST https://thumbnailais.com/api/generate/custom \
  -H "Authorization: Bearer $THUMBNAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"初心者向けの新NISA解説","text":"新NISA完全攻略"}'

レスポンス:

{
  "images": [
    { "id": "...", "path": "<user_id>/<uuid>.jpg", "url": "/api/image-proxy?path=...",
      "downloadUrl": "https://thumbnailais.com/api/image-proxy?path=...&download=1" }
  ],
  "creditsUsed": 1
}

downloadUrl の取得にも同じ Authorization ヘッダーが必要です。生成には数十秒かかるため、連携ツール側のタイムアウトは60秒以上にしてください。

3. エンドポイント

POST /api/generate/custom

サムネイル生成（1枚 1クレジット）

{
  "prompt": "驚いた表情の男性、札束",   // 必須
  "text": "年収1億の秘密",              // 任意: サムネに入れる文字
  "aspectRatio": "16:9",               // 16:9 / 1:1 / 9:16 / 4:3
  "count": 1,                          // 1〜4 案
  "useBrand": true,                    // ブランド設定を反映
  "personaId": "...",                  // 任意: 登録した人物
  "textStyle": "yellow",               // 任意: 文字デザイン
  "textPosition": "left"               // 任意: 文字の位置
}

POST /api/generate/edit

指示で部分修正・別サイズ化（1クレジット）

{ "path": "<生成結果の path>", "instruction": "文字を赤に", "aspectRatio": "16:9" }

POST /api/ideas

台本・動画URL → サムネ案3つ（無料）

{ "script": "台本や概要", "youtubeUrl": "https://youtu.be/..." }

POST /api/score

採点・診断（無料）

{ "path": "<生成結果の path>" }  または  { "image": "data:image/png;base64,..." }

GET /api/image-proxy?path=...&download=1

生成画像のダウンロード（レスポンスの downloadUrl）

4. ツール別の設定

  • n8n: 「HTTP Request」ノード → Method: POST、Authentication: Generic Credential Type → Header Auth（Name: Authorization、Value: Bearer キー）、Body: JSON
  • Zapier: 「Webhooks by Zapier」→ Custom Request → Method: POST、Headers に Authorization と Content-Type、Data に JSON
  • Make: 「HTTP」→ Make a request → Method: POST、Headers に Authorization、Body type: Raw / JSON

エラー

401: APIキーが無効 / 402: クレジット不足 / 400: 入力不正 / 502: 生成失敗（消費したクレジットは自動で返却されます）。 エラー時の本文は {"error":"メッセージ"} です。