> ## 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.

# Analyser une image de document

> Convertit une image de document en Markdown ou en blocs de contenu ordonnés. L’API Cohere Parse actuelle accepte les URL d’images distantes et les URI de données d’image en base64 ; les PDF et les URL de fichiers ne sont pas encore pris en charge.



## OpenAPI

````yaml fr/openapi/v1/openapi.localized.yaml POST /parse
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:
  /parse:
    post:
      tags:
        - Gateway
      summary: Analyser une image de document
      description: >-
        Convertit une image de document en Markdown ou en blocs de contenu
        ordonnés. L’API Cohere Parse actuelle accepte les URL d’images distantes
        et les URI de données d’image en base64 ; les PDF et les URL de fichiers
        ne sont pas encore pris en charge.
      operationId: createParse
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ParseRequest'
      responses:
        '200':
          description: Document analysé
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ParseResponse'
components:
  schemas:
    ParseRequest:
      type: object
      additionalProperties: false
      required:
        - model
        - document
      properties:
        model:
          type: string
          example: cohere/parse-v5.0
        document:
          type: object
          additionalProperties: false
          required:
            - type
            - image_url
          properties:
            type:
              type: string
              enum:
                - image_url
            image_url:
              type: string
              description: >-
                URL HTTP(S) distante d’image ou URI de données d’image en
                base64. Maximum : 20 Mo et 50 mégapixels, ou 200 Mo après
                décodage.
        output_format:
          type: string
          enum:
            - markdown
            - blocks
          default: markdown
        echo_upstream_request:
          type: boolean
        debug:
          $ref: '#/components/schemas/DebugOptions'
        provider:
          $ref: '#/components/schemas/ProviderRoutingOptions'
        routing:
          $ref: '#/components/schemas/ProviderRoutingOptions'
    ParseResponse:
      type: object
      required:
        - id
        - object
        - model
        - provider
        - pages
      properties:
        id:
          type: string
        object:
          type: string
          enum:
            - parse
        model:
          type: string
        provider:
          type: string
        pages:
          type: array
          items:
            $ref: '#/components/schemas/ParsePage'
        meta:
          type: object
          additionalProperties: true
        usage:
          type: object
          additionalProperties: true
    DebugOptions:
      type: object
      description: >-
        Options de débogage de la passerelle. Ces indicateurs ne sont jamais
        transmis au fournisseur.
      properties:
        enabled:
          type: boolean
        return_upstream_request:
          type: boolean
        return_upstream_response:
          type: boolean
        trace:
          type: boolean
        trace_level:
          type: string
          enum:
            - summary
            - full
    ProviderRoutingOptions:
      type: object
      description: >-
        Préférences de routage des fournisseurs pour la sélection par la
        passerelle.
      properties:
        order:
          type: array
          items:
            type: string
        only:
          type: array
          items:
            type: string
        ignore:
          type: array
          items:
            type: string
        include_alpha:
          type: boolean
          description: >-
            Inclure les fournisseurs alpha dans le routage (désactivé par
            défaut).
        allow_fallbacks:
          type: boolean
          nullable: true
          description: >-
            Autoriser le repli vers un autre fournisseur éligible après un
            échec.
        require_parameters:
          type: boolean
          nullable: true
          description: >-
            Exiger la prise en charge des paramètres demandés par le fournisseur
            avant le routage.
        required_execution_region:
          type: string
          nullable: true
          description: >-
            Limiter le routage aux fournisseurs disposant de la région
            d’exécution demandée.
        required_data_region:
          type: string
          nullable: true
          description: >-
            Limiter le routage aux fournisseurs disposant de la région de
            données demandée.
        require_zero_data_retention:
          type: boolean
          nullable: true
          description: >-
            Limiter le routage aux fournisseurs qui prennent en charge la
            conservation nulle des données.
        data_collection:
          type: string
          nullable: true
          enum:
            - allow
            - deny
        zdr:
          type: boolean
          nullable: true
        enforce_distillable_text:
          type: boolean
          nullable: true
        quantizations:
          type: array
          nullable: true
          items:
            type: string
        sort:
          oneOf:
            - type: string
            - type: object
              additionalProperties: true
          description: >-
            Classer les fournisseurs pour cette requête, par exemple selon le
            prix, la latence ou le débit.
        max_price:
          type: object
          properties:
            prompt:
              oneOf:
                - type: number
                - type: string
            completion:
              oneOf:
                - type: number
                - type: string
            image:
              oneOf:
                - type: number
                - type: string
            audio:
              oneOf:
                - type: number
                - type: string
            request:
              oneOf:
                - type: number
                - type: string
        preferred_min_throughput:
          oneOf:
            - type: number
            - type: object
              additionalProperties:
                type: number
        preferred_max_latency:
          oneOf:
            - type: number
            - type: object
              additionalProperties:
                type: number
    ParsePage:
      oneOf:
        - type: object
          required:
            - type
            - index
            - markdown
          properties:
            type:
              type: string
              enum:
                - markdown
            index:
              type: integer
              minimum: 0
            markdown:
              type: object
              required:
                - content
              properties:
                content:
                  type: string
                images:
                  type: array
                  items:
                    $ref: '#/components/schemas/ParseImage'
        - type: object
          required:
            - type
            - index
            - blocks
          properties:
            type:
              type: string
              enum:
                - blocks
            index:
              type: integer
              minimum: 0
            blocks:
              type: array
              items:
                $ref: '#/components/schemas/ParseBlock'
    ParseImage:
      type: object
      required:
        - id
        - description
        - category
        - bounding_box
        - bounding_box_normalized
      properties:
        id:
          type: string
        description:
          type: string
        category:
          type: string
          enum:
            - other
            - flowchart
            - logo
            - signature
        bounding_box:
          $ref: '#/components/schemas/ParseBoundingBox'
        bounding_box_normalized:
          $ref: '#/components/schemas/ParseBoundingBox'
    ParseBlock:
      oneOf:
        - type: object
          required:
            - type
            - text
          properties:
            type:
              type: string
              enum:
                - text
            text:
              type: object
              required:
                - content
              properties:
                content:
                  type: string
        - type: object
          required:
            - type
            - image
          properties:
            type:
              type: string
              enum:
                - image
            image:
              $ref: '#/components/schemas/ParseImage'
        - type: object
          required:
            - type
            - table
          properties:
            type:
              type: string
              enum:
                - table
            table:
              type: object
              required:
                - type
                - html
                - bounding_box
                - bounding_box_normalized
              properties:
                type:
                  type: string
                  enum:
                    - html
                html:
                  type: string
                title:
                  type: string
                description:
                  type: string
                bounding_box:
                  $ref: '#/components/schemas/ParseBoundingBox'
                bounding_box_normalized:
                  $ref: '#/components/schemas/ParseBoundingBox'
    ParseBoundingBox:
      type: object
      required:
        - top_left_x
        - top_left_y
        - bottom_right_x
        - bottom_right_y
      properties:
        top_left_x:
          type: number
        top_left_y:
          type: number
        bottom_right_x:
          type: number
        bottom_right_y:
          type: number
  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.