---
title: "Read the authoritative caption_proposals quota and reset window"
method: GET
path: "/api/ai/captions/generate"
tags: ["ai-captions", "auth"]
---

# Read the authoritative caption_proposals quota and reset window

`GET /api/ai/captions/generate`

Authoritative quota status for Design UI caption proposals. The generic quota at /api/auth/refresh is not a caption_proposals quota and must not be used for this feature.

## Response `200`

Current actor caption_proposals quota snapshot

- object
  - `ok` true, required
  - `quota` union, required
    - object
      - `kind` 'caption_proposals', required
      - `available` true, required
      - `used` integer, required
      - `limit` 3, required
      - `remaining` integer, required
      - `resetAt` string, date-time, required
      - `reset` CaptionProposalsQuotaReset, required
        - `at` string, date-time, required
        - `window` 'utc_day', required
        - `timezone` 'UTC', required
      - `actor` 'guest' | 'user_unverified' | 'user_verified', required
      - `exhausted` boolean, required
    - object
      - `kind` 'caption_proposals', required
      - `available` false, required
      - `used` unknown, required
      - `limit` 3, required
      - `remaining` unknown, required
      - `resetAt` unknown, required
      - `reset` unknown, required
      - `actor` 'guest' | 'user_unverified' | 'user_verified' | 'null', nullable, required
      - `exhausted` unknown, required
      - `errorCode` 'caption_quota_unavailable' | 'caption_dependency_unavailable' | 'developer_api_keys_unavailable' | 'agent_api_keys_unavailable', required
  - `reset` CaptionProposalsQuotaReset, required
    - `at` string, date-time, required
    - `window` 'utc_day', required
    - `timezone` 'UTC', required

## Other responses

- `503` — Caption quota or authentication dependency unavailable

---

[API](https://skmtc.net/memesio/apis/memesio-api-contracts.md) · [All operations](https://skmtc.net/memesio/apis/memesio-api-contracts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memesio/memesio-api-contracts/revisions/826e6edbf294/schema)