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

# Parse a document image

> Parses a document image into Markdown or ordered content blocks. The current Cohere Parse API accepts remote image URLs and base64 image data URIs; PDF and file URL inputs are not yet supported.



## OpenAPI

````yaml POST /parse
openapi: 3.0.3
info:
  title: Phaseo Gateway API
  description: >-
    A gateway API for accessing various AI models with OpenAI-compatible
    endpoints.
  version: 1.0.0
  contact:
    name: Phaseo
    url: https://phaseo.app
    email: danielbutler500@gmail.com
servers:
  - url: https://api.phaseo.app/v1
security:
  - BearerAuth: []
tags:
  - name: Gateway
    description: Core Phaseo Gateway operations.
paths:
  /parse:
    post:
      tags:
        - Gateway
      summary: Parse a document image
      description: >-
        Parses a document image into Markdown or ordered content blocks. The
        current Cohere Parse API accepts remote image URLs and base64 image data
        URIs; PDF and file URL inputs are not yet supported.
      operationId: createParse
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ParseRequest'
      responses:
        '200':
          description: Parsed document
          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: >-
                Remote http(s) image URL or base64 image data URI. Maximum 20 MB
                and 50 megapixels or 200 MB decoded.
        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: Gateway debug controls. These flags are never forwarded upstream.
      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: Provider routing preferences for gateway selection.
      properties:
        order:
          type: array
          items:
            type: string
        only:
          type: array
          items:
            type: string
        ignore:
          type: array
          items:
            type: string
        include_alpha:
          type: boolean
          description: Include alpha providers in routing (off by default).
        allow_fallbacks:
          type: boolean
          nullable: true
          description: Allow fallback to another eligible provider after failure.
        require_parameters:
          type: boolean
          nullable: true
          description: Require provider support for requested parameters before routing.
        required_execution_region:
          type: string
          nullable: true
          description: Restrict routing to providers with the requested execution region.
        required_data_region:
          type: string
          nullable: true
          description: Restrict routing to providers with the requested data region.
        require_zero_data_retention:
          type: boolean
          nullable: true
          description: Restrict routing to providers that support zero data retention.
        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: >-
            Rank providers for this request, for example by price, latency, or
            throughput.
        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: Bearer token authentication

````