Gamma レート制限

概要

Gamma API のレート制限を理解し、大量の使用に対応する効果的な戦略を実装します。

前提条件

• アクティブな Gamma API インテグレーション
• HTTP ヘッダーの理解
• キューイングの基本概念の知識

レート制限のティア

プラン	リクエスト/分	プレゼンテーション/日	エクスポート/時間
Free	10	5	10
Pro	60	50	100
Team	200	200	500
Enterprise	カスタム	カスタム	カスタム

手順

ステップ 1: レート制限ヘッダーを確認する

const response = await gamma.presentations.list();

// Rate limit headers
const headers = response.headers;
console.log('Limit:', headers['x-ratelimit-limit']);
console.log('Remaining:', headers['x-ratelimit-remaining']);
console.log('Reset:', new Date(headers['x-ratelimit-reset'] * 1000));

ステップ 2: 指数バックオフを実装する

async function withBackoff<T>(
  fn: () => Promise<T>,
  options = { maxRetries: 5, baseDelay: 1000 }
): Promise<T> {
  for (let attempt = 0; attempt < options.maxRetries; attempt++) {
    try {
      return await fn();
    } catch (err) {
      if (err.status !== 429 || attempt === options.maxRetries - 1) {
        throw err;
      }

      const delay = err.retryAfter
        ? err.retryAfter * 1000
        : options.baseDelay * Math.pow(2, attempt);

      console.log(`Rate limited. Retrying in ${delay}ms...`);
      await new Promise(r => setTimeout(r, delay));
    }
  }
  throw new Error('Max retries exceeded');
}

// Usage
const result = await withBackoff(() =>
  gamma.presentations.create({ title: 'My Deck', prompt: 'AI overview' })
);

ステップ 3: リクエストキュー

class RateLimitedQueue {
  private queue: Array<() => Promise<any>> = [];
  private processing = false;
  private requestsPerMinute: number;
  private interval: number;

  constructor(requestsPerMinute = 60) {
    this.requestsPerMinute = requestsPerMinute;
    this.interval = 60000 / requestsPerMinute;
  }

  async add<T>(fn: () => Promise<T>): Promise<T> {
    return new Promise((resolve, reject) => {
      this.queue.push(async () => {
        try {
          resolve(await fn());
        } catch (err) {
          reject(err);
        }
      });
      this.process();
    });
  }

  private async process() {
    if (this.processing) return;
    this.processing = true;

    while (this.queue.length > 0) {
      const fn = this.queue.shift()!;
      await fn();
      await new Promise(r => setTimeout(r, this.interval));
    }

    this.processing = false;
  }
}

// Usage
const queue = new RateLimitedQueue(30); // 30 req/min

const results = await Promise.all([
  queue.add(() => gamma.presentations.create({ ... })),
  queue.add(() => gamma.presentations.create({ ... })),
  queue.add(() => gamma.presentations.create({ ... })),
]);

ステップ 4: 使用状況を監視する

async function getRateLimitStatus() {
  const status = await gamma.rateLimit.status();

  return {
    limit: status.limit,
    remaining: status.remaining,
    percentUsed: ((status.limit - status.remaining) / status.limit * 100).toFixed(1),
    resetAt: new Date(status.reset * 1000),
    resetIn: Math.ceil((status.reset * 1000 - Date.now()) / 1000),
  };
}

// Usage
const status = await getRateLimitStatus();
console.log(`Used ${status.percentUsed}% of rate limit`);
console.log(`Resets in ${status.resetIn} seconds`);

出力

• レート制限に対応した API コール
• バックオフを使用した自動リトライ
• リクエストキューイングシステム
• 使用状況監視ダッシュボード

エラー処理

シナリオ	戦略	実装
時折の 429 エラー	指数バックオフ	withBackoff() ラッパー
常時の 429 エラー	リクエストキュー	RateLimitedQueue クラス
制限に接近	先制的スロットリング	呼び出し前に残数を確認
バースト トラフィック	トークンバケット	トークンバケットアルゴリズムを実装

リソース

• Gamma Rate Limits
• Rate Limit Best Practices

次のステップ

セキュリティのベストプラクティスについて、gamma-security-basics に進みます。