first commit

docs/openapi/paths/integrations/anthropic/batch.yaml

@@ -0,0 +1,230 @@
+# Anthropic Integration - Batch API Endpoints
+
+batches:
+  post:
+    operationId: anthropicCreateBatch
+    summary: Create batch job (Anthropic format)
+    description: |
+      Creates a batch processing job using Anthropic format.
+      Use x-model-provider header to specify the provider.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: x-model-provider
+      in: header
+      schema:
+        type: string
+      description: Provider to use (defaults to anthropic)
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../../../schemas/integrations/anthropic/batch.yaml#/AnthropicBatchCreateRequest'
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/batch.yaml#/AnthropicBatchCreateResponse'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []
+  get:
+    operationId: anthropicListBatches
+    summary: List batch jobs (Anthropic format)
+    description: |
+      Lists batch processing jobs.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: x-model-provider
+      in: header
+      schema:
+        type: string
+      description: Provider to use (defaults to anthropic)
+    - name: page_size
+      in: query
+      schema:
+        type: integer
+        default: 20
+      description: Maximum number of batches to return
+    - name: page_token
+      in: query
+      schema:
+        type: string
+      description: Cursor for pagination
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/batch.yaml#/AnthropicBatchListResponse'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []
+batches-by-id:
+  get:
+    operationId: anthropicRetrieveBatch
+    summary: Retrieve batch job (Anthropic format)
+    description: |
+      Retrieves details of a batch processing job.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: batch_id
+      in: path
+      required: true
+      schema:
+        type: string
+      description: Batch job ID
+    - name: x-model-provider
+      in: header
+      schema:
+        type: string
+      description: Provider for the batch
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/batch.yaml#/AnthropicBatchRetrieveResponse'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []
+batches-cancel:
+  post:
+    operationId: anthropicCancelBatch
+    summary: Cancel batch job (Anthropic format)
+    description: |
+      Cancels a batch processing job.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: batch_id
+      in: path
+      required: true
+      schema:
+        type: string
+      description: Batch job ID to cancel
+    - name: x-model-provider
+      in: header
+      schema:
+        type: string
+      description: Provider for the batch
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/batch.yaml#/AnthropicBatchCancelResponse'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []
+batches-results:
+  get:
+    operationId: anthropicGetBatchResults
+    summary: Get batch results (Anthropic format)
+    description: |
+      Retrieves results of a completed batch job.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: batch_id
+      in: path
+      required: true
+      schema:
+        type: string
+      description: Batch job ID
+    - name: x-model-provider
+      in: header
+      schema:
+        type: string
+      description: Provider for the batch
+    responses:
+      '200':
+        description: Successful response (JSONL stream)
+        content:
+          application/x-ndjson:
+            schema:
+              type: string
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []

docs/openapi/paths/integrations/anthropic/count-tokens.yaml

@@ -0,0 +1,40 @@
+# Anthropic Integration - Count Tokens Endpoints
+
+count-tokens:
+  post:
+    operationId: anthropicCountTokens
+    summary: Count tokens (Anthropic format)
+    description: |
+      Counts the number of tokens in a message request.
+    tags:
+    - Anthropic Integration
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../../../schemas/integrations/anthropic/count-tokens.yaml#/AnthropicCountTokensRequest'
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/count-tokens.yaml#/AnthropicCountTokensResponse'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []

docs/openapi/paths/integrations/anthropic/files.yaml

@@ -0,0 +1,209 @@
+# Anthropic Integration - Files API Endpoints
+
+files:
+  post:
+    operationId: anthropicUploadFile
+    summary: Upload file (Anthropic format)
+    description: |
+      Uploads a file. Use x-model-provider header to specify the provider.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: x-model-provider
+      in: header
+      schema:
+        type: string
+      description: Provider to use (defaults to anthropic)
+    requestBody:
+      required: true
+      content:
+        multipart/form-data:
+          schema:
+            $ref: '../../../schemas/integrations/anthropic/files.yaml#/AnthropicFileUploadRequest'
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/files.yaml#/AnthropicFileUploadResponse'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []
+  get:
+    operationId: anthropicListFiles
+    summary: List files (Anthropic format)
+    description: |
+      Lists uploaded files.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: x-model-provider
+      in: header
+      schema:
+        type: string
+      description: Provider to use (defaults to anthropic)
+    - name: limit
+      in: query
+      schema:
+        type: integer
+        default: 30
+      description: Maximum files to return
+    - name: after_id
+      in: query
+      schema:
+        type: string
+      description: Cursor for pagination
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/files.yaml#/AnthropicFileListResponse'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []
+files-content:
+  get:
+    operationId: anthropicGetFileContent
+    summary: Get file content (Anthropic format)
+    description: |
+      Retrieves file content. Returns raw binary file data when Accept header is set to application/octet-stream,
+      or file metadata as JSON when Accept header is set to application/json.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: file_id
+      in: path
+      required: true
+      schema:
+        type: string
+      description: File ID
+    - name: x-model-provider
+      in: header
+      schema:
+        type: string
+      description: Provider for the file
+    - name: Accept
+      in: header
+      schema:
+        type: string
+        enum: [application/json, application/octet-stream]
+        default: application/json
+      description: Response content type - use application/octet-stream for binary download
+    responses:
+      '200':
+        description: |
+          Successful response. Returns file metadata as JSON or raw binary file content.
+          When returning binary content, the Content-Type header indicates the file's MIME type
+          and Content-Disposition header may include the filename.
+        headers:
+          Content-Type:
+            schema:
+              type: string
+            description: MIME type of the file (e.g., application/pdf, image/png, text/plain)
+          Content-Disposition:
+            schema:
+              type: string
+            description: Attachment filename directive (e.g., attachment; filename="document.pdf")
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/files.yaml#/AnthropicFileRetrieveResponse'
+          application/octet-stream:
+            schema:
+              type: string
+              format: binary
+              description: Raw binary file content
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []
+files-by-id:
+  delete:
+    operationId: anthropicDeleteFile
+    summary: Delete file (Anthropic format)
+    description: |
+      Deletes an uploaded file.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: file_id
+      in: path
+      required: true
+      schema:
+        type: string
+      description: File ID to delete
+    - name: x-model-provider
+      in: header
+      schema:
+        type: string
+      description: Provider for the file
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/files.yaml#/AnthropicFileDeleteResponse'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []

docs/openapi/paths/integrations/anthropic/messages.yaml

@@ -0,0 +1,119 @@
+# Anthropic Integration - Messages API Endpoints
+
+messages:
+  post:
+    operationId: anthropicCreateMessage
+    summary: Create message (Anthropic format)
+    description: |
+      Creates a message using Anthropic Messages API format.
+      Supports streaming via SSE.
+
+      **Async inference:** Send `x-bf-async: true` to submit the request as a background job and receive a job ID immediately. Poll with `x-bf-async-id: <job-id>` to retrieve the result. When the job is still processing, the response will have an empty `content` array. When completed, `content` will contain the full result. See [Async Inference](/features/async-inference) for details.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: x-bf-async
+      in: header
+      required: false
+      schema:
+        type: string
+        enum: ["true"]
+      description: Set to `true` to submit this request as an async job. Returns immediately with a job ID. Not 
+        compatible with streaming.
+    - name: x-bf-async-id
+      in: header
+      required: false
+      schema:
+        type: string
+      description: Poll for results of a previously submitted async job by providing the job ID returned from the 
+        initial async request.
+    - name: x-bf-async-job-result-ttl
+      in: header
+      required: false
+      schema:
+        type: integer
+        default: 3600
+      description: Override the default result TTL in seconds. Results expire after this duration from completion time.
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../../../schemas/integrations/anthropic/messages.yaml#/AnthropicMessageRequest'
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/messages.yaml#/AnthropicMessageResponse'
+          text/event-stream:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/messages.yaml#/AnthropicStreamEvent'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+
+# Wildcard path for extended messages endpoints (e.g., /v1/messages/batches)
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []
+messages-wildcard:
+  post:
+    operationId: anthropicCreateMessageWildcard
+    summary: Create message (Anthropic format) - wildcard
+    description: |
+      Handles extended messages API paths.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: path
+      in: path
+      required: true
+      schema:
+        type: string
+      description: Extended path
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../../../schemas/integrations/anthropic/messages.yaml#/AnthropicMessageRequest'
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/messages.yaml#/AnthropicMessageResponse'
+          text/event-stream:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/messages.yaml#/AnthropicStreamEvent'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []

docs/openapi/paths/integrations/anthropic/models.yaml

@@ -0,0 +1,50 @@
+# Anthropic Integration - Models Endpoints
+
+models:
+  get:
+    operationId: anthropicListModels
+    summary: List models (Anthropic format)
+    description: |
+      Lists available models in Anthropic format.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: limit
+      in: query
+      schema:
+        type: integer
+      description: Maximum number of models to return
+    - name: before_id
+      in: query
+      schema:
+        type: string
+      description: Return models before this ID
+    - name: after_id
+      in: query
+      schema:
+        type: string
+      description: Return models after this ID
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicListModelsResponse'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []

docs/openapi/paths/integrations/anthropic/text.yaml

@@ -0,0 +1,44 @@
+# Anthropic Integration - Legacy Complete API Endpoints
+
+complete:
+  post:
+    operationId: anthropicCreateComplete
+    summary: Create completion (Anthropic legacy format)
+    description: |
+      Creates a text completion using Anthropic's legacy Complete API.
+      Supports streaming via SSE.
+    tags:
+    - Anthropic Integration
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../../../schemas/integrations/anthropic/text.yaml#/AnthropicTextRequest'
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/text.yaml#/AnthropicTextResponse'
+          text/event-stream:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/text.yaml#/AnthropicTextResponse'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []