Auto Reader Export API

openapi: 3.2.0
info:
  title: Auto-Reader OCR + Translate Export API
  description: Multilingual OCR (Arabic-first, manga-aware), translation, and vision escalation.
  version: 1.0.0
servers:
- url: https://api.auto-reader.com
security:
- bearerAuth: []
tags:
- name: Export
paths:
  /v1/export:
    post:
      summary: Export Document
      description: 'Text in, document file out — docx, epub, md, html or txt.


        The counterpart to every endpoint that returns TEXT. OCR a page, run a

        pipeline, translate a chapter, and until now the only way out was the

        clipboard: the docx/epub builders existed but were reachable only from a

        /v1/book job, which needs a source file and bills per page.


        It reuses those builders exactly (`app.ocr.docout`), so an exported docx is

        the same docx a book job produces. Page structure survives the round trip:

        text is split on the `----`/`---` rules build_txt and build_md themselves

        emit, and `#`/`##`/`###` become real headings rather than paragraphs that

        happen to start with a hash.


        No GPU, no LLM -- this is CPU only, which is why it is one credit.'
      operationId: export_document_v1_export_post
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Export
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ExportBody:
      properties:
        text:
          type: string
          title: Text
        format:
          type: string
          title: Format
          default: docx
        title:
          type: string
          title: Title
          default: Document
        lang:
          anyOf:
          - type: string
          - type: 'null'
          title: Lang
      type: object
      required:
      - text
      title: ExportBody
      description: 'Turn text the caller already has into a document file.


        The counterpart to every endpoint that RETURNS text: OCR a page, run a

        pipeline, translate a chapter -- and then have nothing to hand someone but

        a clipboard. Uses the same builders /v1/book ships its books with, so an

        exported docx is the same docx a book job would have produced.'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key from POST /signup (nsk_live_...)