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

# Lister les capacités des points de terminaison du modèle

> Examiner les routes de fournisseurs, modalités, paramètres, disponibilités et tarifs proposés pour un modèle.

Utilisez ce point de terminaison avant d’envoyer une requête si votre application doit vérifier la disponibilité d’une combinaison de modèle, fournisseur, point de terminaison et paramètres.

Pour `openai/gpt-5.4-mini`, utilisez :

```bash theme={null}
curl "https://api.phaseo.app/v1/models/openai/gpt-5.4-mini/endpoints" \
  -H "Authorization: Bearer $PHASEO_API_KEY"
```

Chaque ligne représente une capacité pour un fournisseur et un point de terminaison. Elle comprend :

* l’identifiant de capacité canonique et le chemin API public
* l’identifiant et le nom du fournisseur, ainsi que le slug de son modèle
* les modalités d’entrée et de sortie
* les noms des paramètres pris en charge et leurs détails structurés
* les états du fournisseur, du modèle, de la capacité, du routage et de la disponibilité
* les dates d’effet lorsque la route est planifiée ou limitée dans le temps
* un récapitulatif des tarifs du point de terminaison

## Inclure les routes planifiées et inactives

La valeur par défaut `availability=active` ne renvoie que les lignes dont les routes sont accessibles au public. Utilisez `availability=all` pour examiner les routes à venir et inactives :

```bash theme={null}
curl "https://api.phaseo.app/v1/models/openai/gpt-5.4-mini/endpoints?availability=all" \
  -H "Authorization: Bearer $PHASEO_API_KEY"
```

N’envoyez pas de trafic de production vers une ligne si `availability_status` n’est pas `active` et `is_active_gateway` n’est pas `true`.

## Filtrer les routes

Utilisez des filtres répétables ou séparés par des virgules pour :

* `provider`
* `provider_status`
* `provider_routing_status`
* `model_routing_status`
* `capability_status`
* `provider_availability_status`
* `provider_availability_reason`
* `status`
* `supported_parameters`

Par exemple, cette requête renvoie les routes OpenAI qui prennent en charge `temperature` :

```bash theme={null}
curl "https://api.phaseo.app/v1/models/openai/gpt-5.4-mini/endpoints?provider=openai&supported_parameters=temperature" \
  -H "Authorization: Bearer $PHASEO_API_KEY"
```

## Points de terminaison associés

* [Lister les modèles](./models.mdx)
* [Lister les points de terminaison](./endpoints.mdx)


## OpenAPI

````yaml fr/openapi/v1/openapi.localized.yaml GET /models/{author}/{slug}/endpoints
openapi: 3.0.3
info:
  title: Phaseo Gateway API
  description: >-
    Une API de passerelle pour accéder à divers modèles d’IA via des points de
    terminaison compatibles avec OpenAI.
  version: 1.0.0
  contact:
    name: Phaseo
    url: https://phaseo.app
    email: danielbutler500@gmail.com
servers:
  - url: https://api.phaseo.app/v1
    description: Routage mondial
security:
  - BearerAuth: []
tags:
  - name: Gateway
    description: Core Phaseo Gateway operations.
paths:
  /models/{author}/{slug}/endpoints:
    get:
      tags:
        - Gateway
      summary: Lister les capacités des points de terminaison du modèle
      description: >-
        Renvoie les lignes de points de terminaison propres au fournisseur pour
        un modèle, avec les chemins publics, les modalités, les paramètres pris
        en charge, la disponibilité, l’état de routage, les slugs des modèles
        fournisseur et les récapitulatifs tarifaires des points de terminaison.
      operationId: listModelEndpoints
      parameters:
        - name: author
          in: path
          required: true
          description: Segment correspondant à l’auteur ou à l’organisation du modèle.
          schema:
            type: string
        - name: slug
          in: path
          required: true
          description: Segment slug du modèle.
          schema:
            type: string
        - name: provider
          in: query
          description: Filtrer par ID du fournisseur.
          schema:
            type: array
            items:
              type: string
        - name: provider_status
          in: query
          description: Filtrer par état de déploiement du fournisseur.
          schema:
            type: array
            items:
              type: string
        - name: provider_routing_status
          in: query
          description: Filtrer par état de routage du fournisseur.
          schema:
            type: array
            items:
              type: string
        - name: model_routing_status
          in: query
          description: Filtrer par état de routage du modèle.
          schema:
            type: array
            items:
              type: string
        - name: capability_status
          in: query
          description: Filtrer par état des capacités du fournisseur.
          schema:
            type: array
            items:
              type: string
        - name: provider_availability_status
          in: query
          description: Filtrer par état de disponibilité du fournisseur.
          schema:
            type: array
            items:
              type: string
        - name: provider_availability_reason
          in: query
          description: Filtrer par motif de disponibilité du fournisseur.
          schema:
            type: array
            items:
              type: string
        - name: status
          in: query
          description: Filtrer par état canonique du cycle de vie du modèle.
          schema:
            type: array
            items:
              type: string
        - name: supported_parameters
          in: query
          description: >-
            Filtrer les lignes de points de terminaison par nom de paramètre
            pris en charge ou par alias.
          schema:
            type: array
            items:
              type: string
        - name: availability
          in: query
          description: >-
            `active` renvoie les lignes de points de terminaison routables
            publiquement ; `all` inclut aussi celles à venir et inactives.
          schema:
            type: string
            enum:
              - active
              - all
            default: active
      responses:
        '200':
          description: Lignes de capacités des points de terminaison du modèle
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelEndpointsResponse'
        '400':
          description: Paramètres de requête invalides
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidRequestResponse'
        '401':
          description: Non autorisé
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: >-
            Aucun modèle ne correspond aux filtres de disponibilité et de
            fournisseur demandés
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Erreur
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ModelEndpointsResponse:
      type: object
      required:
        - ok
        - id
        - name
        - description
        - organization
        - modalities
        - availability_mode
        - endpoints
      properties:
        ok:
          type: boolean
          enum:
            - true
        id:
          type: string
        name:
          type: string
        description:
          type: string
        organization:
          $ref: '#/components/schemas/GatewayModelOrganization'
        modalities:
          $ref: '#/components/schemas/GatewayModalities'
        availability_mode:
          type: string
          enum:
            - active
            - all
        endpoints:
          type: array
          items:
            $ref: '#/components/schemas/ModelEndpointCapability'
      additionalProperties: false
    InvalidRequestResponse:
      type: object
      required:
        - ok
        - error
        - message
      properties:
        ok:
          type: boolean
          enum:
            - false
          example: false
        error:
          type: string
          example: invalid_request
        message:
          type: string
          example: Invalid request parameters.
        max_offset:
          type: integer
          minimum: 0
      additionalProperties: true
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        ok:
          type: boolean
          example: false
        error:
          oneOf:
            - type: string
            - type: object
              additionalProperties: true
          example: error_type
        message:
          type: string
          example: Human-readable error message
        description:
          type: string
          example: Additional error details.
        generation_id:
          type: string
          example: G-abc123
        status_code:
          type: integer
          example: 502
        error_type:
          type: string
          enum:
            - user
            - system
          example: system
        error_origin:
          type: string
          enum:
            - user
            - gateway
            - upstream
          example: upstream
        reason:
          type: string
          example: all_candidates_failed
        attempt_count:
          type: integer
          example: 2
        failed_providers:
          type: array
          items:
            type: string
          example:
            - google-ai-studio
            - openai
        failed_statuses:
          type: array
          items:
            type: integer
          example:
            - 403
            - 429
        upstream_error:
          $ref: '#/components/schemas/ErrorUpstreamError'
        failure_sample:
          type: array
          items:
            $ref: '#/components/schemas/ErrorFailureSampleItem'
        provider_failure_diagnostics:
          $ref: '#/components/schemas/ErrorProviderFailureDiagnostics'
        routing_diagnostics:
          $ref: '#/components/schemas/ErrorRoutingDiagnostics'
        provider_candidate_diagnostics:
          $ref: '#/components/schemas/ErrorProviderCandidateDiagnostics'
        provider_enablement:
          $ref: '#/components/schemas/ErrorProviderEnablementDiagnostics'
        missing_pricing_providers:
          type: array
          items:
            type: string
        provider_payment_required_provider:
          type: string
          example: openai
        provider_payment_required_support_notice:
          type: string
          example: >-
            Our upstream provider billing appears to be unavailable. If this
            persists, contact support.
        details:
          type: array
          items:
            type: object
            additionalProperties: true
      additionalProperties: true
    GatewayModelOrganization:
      type: object
      nullable: true
      required:
        - id
        - name
        - color
      properties:
        id:
          type: string
        name:
          type: string
          nullable: true
        color:
          type: string
          nullable: true
    GatewayModalities:
      type: object
      required:
        - input
        - output
      properties:
        input:
          type: array
          items:
            type: string
        output:
          type: array
          items:
            type: string
    ModelEndpointCapability:
      type: object
      required:
        - id
        - endpoint
        - capability_id
        - public_path
        - collection
        - provider
        - model
        - routable
        - status
        - status_reason
        - modalities
        - capabilities
        - routing
        - effective
        - pricing
      properties:
        id:
          type: string
          example: openai:responses
        endpoint:
          type: string
          example: responses
        capability_id:
          type: string
          example: responses
        public_path:
          type: string
          example: /v1/responses
        collection:
          type: string
          enum:
            - text
            - images
            - video
            - audio
            - embeddings
            - rerank
            - moderation
            - ocr
            - music
            - batch
            - files
        provider:
          type: object
          required:
            - id
            - name
          properties:
            id:
              type: string
              example: openai
            name:
              type: string
              nullable: true
              example: OpenAI
        model:
          type: string
          nullable: true
          example: gpt-5.4-mini
        routable:
          type: boolean
        status:
          type: string
          enum:
            - active
            - coming_soon
            - inactive
        status_reason:
          $ref: '#/components/schemas/GatewayProviderAvailabilityReason'
        modalities:
          $ref: '#/components/schemas/GatewayModalities'
        capabilities:
          $ref: '#/components/schemas/GatewayCapabilities'
        routing:
          type: object
          required:
            - provider
            - model
            - capability
          properties:
            provider:
              $ref: '#/components/schemas/GatewayRoutingStatus'
            model:
              $ref: '#/components/schemas/GatewayRoutingStatus'
            capability:
              $ref: '#/components/schemas/GatewayCapabilityStatus'
        effective:
          type: object
          required:
            - from
            - to
          properties:
            from:
              type: string
              nullable: true
            to:
              type: string
              nullable: true
        pricing:
          $ref: '#/components/schemas/GatewayPricing'
    ErrorUpstreamError:
      type: object
      properties:
        code:
          type: string
          nullable: true
          example: PERMISSION_DENIED
        message:
          type: string
          nullable: true
          example: The caller does not have permission.
        description:
          type: string
          nullable: true
        param:
          type: string
          nullable: true
    ErrorFailureSampleItem:
      type: object
      properties:
        provider:
          type: string
          nullable: true
        type:
          type: string
          nullable: true
        status:
          type: integer
          nullable: true
        upstream_error_code:
          type: string
          nullable: true
        upstream_error_message:
          type: string
          nullable: true
        upstream_error_description:
          type: string
          nullable: true
        upstream_error_param:
          type: string
          nullable: true
        upstream_payload_preview:
          type: string
          nullable: true
        retryable:
          type: boolean
          nullable: true
      additionalProperties: true
    ErrorProviderFailureDiagnostics:
      type: object
      properties:
        category:
          type: string
          enum:
            - credentials_not_configured
            - credentials_invalid_or_forbidden
            - provider_access_missing
            - region_or_project_restriction
            - model_unavailable_for_endpoint
            - rate_limited
            - server_error
        hint:
          type: string
        provider:
          type: string
          nullable: true
    ErrorRoutingDiagnostics:
      type: object
      properties:
        filterStages:
          type: array
          items:
            type: object
            properties:
              stage:
                type: string
              beforeCount:
                type: integer
              afterCount:
                type: integer
              droppedProviders:
                type: array
                items:
                  type: object
                  properties:
                    providerId:
                      type: string
                      nullable: true
                    reason:
                      type: string
                      nullable: true
                  additionalProperties: true
            additionalProperties: true
      additionalProperties: true
    ErrorProviderCandidateDiagnostics:
      type: object
      properties:
        totalProviders:
          type: integer
        supportsEndpointCount:
          type: integer
        candidateCount:
          type: integer
        droppedUnsupportedEndpoint:
          type: array
          items:
            type: string
        droppedMissingAdapter:
          type: array
          items:
            type: object
            properties:
              providerId:
                type: string
                nullable: true
              endpoint:
                type: string
                nullable: true
            additionalProperties: true
      additionalProperties: true
    ErrorProviderEnablementDiagnostics:
      type: object
      properties:
        capability:
          type: string
        providersBefore:
          type: array
          items:
            type: string
        providersAfter:
          type: array
          items:
            type: string
        dropped:
          type: array
          items:
            type: object
            properties:
              providerId:
                type: string
                nullable: true
              reason:
                type: string
                nullable: true
            additionalProperties: true
      additionalProperties: true
    GatewayProviderAvailabilityReason:
      type: string
      enum:
        - active
        - preview_only
        - gated
        - access_limited
        - region_limited
        - project_limited
        - paused
        - soft_blocked
        - deranked_lvl1
        - deranked_lvl2
        - deranked_lvl3
        - internal_testing
        - scheduled
        - coming_soon
        - provider_disabled
        - model_disabled
        - capability_disabled
        - provider_not_ready
        - provider_inactive
        - inactive
        - retired
    GatewayCapabilities:
      type: object
      required:
        - parameters
        - parameter_details
      properties:
        endpoints:
          type: array
          items:
            type: string
        parameters:
          type: array
          items:
            type: string
        parameter_details:
          $ref: '#/components/schemas/SupportedParameterDetails'
    GatewayRoutingStatus:
      type: string
      enum:
        - active
        - deranked_lvl1
        - deranked_lvl2
        - deranked_lvl3
        - disabled
    GatewayCapabilityStatus:
      type: string
      enum:
        - active
        - coming_soon
        - deranked_lvl1
        - deranked_lvl2
        - deranked_lvl3
        - disabled
        - internal_testing
    GatewayPricing:
      type: object
      required:
        - pricing_plan
        - meters
      properties:
        pricing_plan:
          type: string
          enum:
            - standard
        meters:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/GatewayPricingMeter'
    SupportedParameterDetails:
      type: object
      description: >-
        Contraintes structurées et prise en charge des paramètres de requête par
        le fournisseur, indexées par nom de paramètre.
      additionalProperties:
        type: object
        additionalProperties: true
    GatewayPricingMeter:
      type: object
      nullable: true
      required:
        - provider_id
        - unit
        - unit_size
        - price_per_unit
        - currency
      properties:
        provider_id:
          type: string
        unit:
          type: string
        unit_size:
          type: number
          minimum: 0
          exclusiveMinimum: true
        price_per_unit:
          type: string
        currency:
          type: string
          enum:
            - USD
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Authentification par jeton Bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.