> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ロケール一覧

> Returns the official catalog of supported BCP-47 locales and the accents available under each locale. Use this to build language and accent pickers. Accent `id` values match `Voice.accent` and the accents accepted when creating or updating voices.



## OpenAPI

````yaml latest.yml GET /locales
openapi: 3.0.1
info:
  title: Cartesia API
  version: 0.0.1
servers:
  - url: https://api.cartesia.ai
    description: Production
security: []
paths:
  /locales:
    get:
      tags:
        - Voices
      summary: List Locales
      description: >-
        Returns the official catalog of supported BCP-47 locales and the accents
        available under each locale. Use this to build language and accent
        pickers. Accent `id` values match `Voice.accent` and the accents
        accepted when creating or updating voices.
      operationId: locales_list
      parameters:
        - $ref: '#/components/parameters/CartesiaVersionHeader'
      responses:
        '200':
          description: Official locales and accents.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListLocalesResponse'
              example:
                locales:
                  - locale: en-US
                    language: en
                    display_name: English (United States)
                    accents:
                      - id: General American English
                        label: American
                        is_default: true
                      - id: Southern American English
                        label: Southern US
                        is_default: false
                  - locale: en-GB
                    language: en
                    display_name: English (United Kingdom)
                    accents:
                      - id: British English
                        label: British
                        is_default: true
      security:
        - APIKeyAuth: []
components:
  parameters:
    CartesiaVersionHeader:
      name: Cartesia-Version
      in: header
      description: API version header.
      required: true
      schema:
        type: string
        format: date
        example: '2026-03-01'
        default: '2026-03-01'
        enum:
          - '2026-03-01'
  schemas:
    ListLocalesResponse:
      title: ListLocalesResponse
      type: object
      properties:
        locales:
          type: array
          description: Official locales, sorted by locale code.
          items:
            $ref: '#/components/schemas/OfficialLocale'
      required:
        - locales
    OfficialLocale:
      title: OfficialLocale
      type: object
      description: A supported BCP-47 locale and its accents.
      properties:
        locale:
          type: string
          pattern: ^[a-z]{2}-[A-Z]{2}$
          description: BCP-47 language-region tag (for example `en-US`).
          example: en-US
        language:
          type: string
          description: ISO 639-1 language subtag (for example `en`).
          example: en
        display_name:
          type: string
          description: Human-readable locale label (for example `English (United States)`).
          example: English (United States)
        accents:
          type: array
          description: >-
            Accents available under this locale. The default accent is listed
            first.
          items:
            $ref: '#/components/schemas/LocaleAccent'
      required:
        - locale
        - language
        - display_name
        - accents
    LocaleAccent:
      title: LocaleAccent
      type: object
      description: An accent available under an official locale.
      properties:
        id:
          type: string
          description: >-
            Canonical accent name. Same vocabulary as `Voice.accent` (for
            example `General American English`).
          example: General American English
        label:
          type: string
          nullable: true
          description: >-
            Short UI qualifier shown with the language (for example `American`).
            Null when the accent is the unqualified form of its language.
          example: American
        is_default:
          type: boolean
          description: Whether this is the default accent for the locale.
      required:
        - id
        - label
        - is_default
  securitySchemes:
    APIKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Cartesia API key (`sk_car_...`). Get one at
        [play.cartesia.ai/keys](https://play.cartesia.ai/keys).
      x-default: $CARTESIA_API_KEY

````