APIs.io Engineering Platform Workers AI Text Generation API

openapi: 3.2.0
info:
  description: 'To get started using Cloudflare''s products and services via the API, refer to [how to interact with Cloudflare](https://developers.cloudflare.com/fundamentals/basic-tasks/interact-with-cloudflare/), which covers using tools like [Terraform](https://developers.cloudflare.com/terraform/#cloudflare-terraform) and the [official SDKs](https://developers.cloudflare.com/fundamentals/api/reference/sdks/) to maintain your Cloudflare resources.


    Using the Cloudflare API requires authentication so that Cloudflare knows who is making requests and what permissions you have. Create an API token to grant access to the API to perform actions.


    To create an API token, from the Cloudflare dashboard, go to My Profile > API Tokens and select Create Token. For more information on how to create and troubleshoot API tokens, refer to

    our [API fundamentals](https://developers.cloudflare.com/fundamentals/api/).


    Totally new to Cloudflare? [Start here](https://developers.cloudflare.com/fundamentals/get-started/).'
  license:
    name: BSD-3-Clause
    url: https://opensource.org/licenses/BSD-3-Clause
  title: APIs.io Engineering Platform Cloudflare Workers AI Text Generation API
  version: 4.0.0
tags:
- name: Workers AI Text Generation
paths:
  /accounts/{account_id}/ai/run/@cf/deepseek-ai/deepseek-math-7b-instruct:
    post:
      operationId: workers-ai-post-run-cf-deepseek-ai-deepseek-math-7b-instruct
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          example: 023e105f4ecef8ad9ca31a8372d0c353
          type: string
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - properties:
                  frequency_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  lora:
                    type: string
                  max_tokens:
                    default: 256
                    type: integer
                  presence_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  prompt:
                    maxLength: 131072
                    minLength: 1
                    type: string
                  raw:
                    default: false
                    type: boolean
                  repetition_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  seed:
                    maximum: 9999999999.0
                    minimum: 1
                    type: integer
                  stream:
                    default: false
                    type: boolean
                  temperature:
                    default: 0.6
                    maximum: 5
                    minimum: 0
                    type: number
                  top_k:
                    maximum: 50
                    minimum: 1
                    type: integer
                  top_p:
                    maximum: 2
                    minimum: 0
                    type: number
                required:
                - prompt
              - properties:
                  frequency_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  functions:
                    items:
                      properties:
                        code:
                          type: string
                        name:
                          type: string
                      required:
                      - name
                      - code
                      type: object
                    type: array
                  max_tokens:
                    default: 256
                    type: integer
                  messages:
                    items:
                      properties:
                        content:
                          maxLength: 131072
                          type: string
                        role:
                          type: string
                      required:
                      - role
                      - content
                      type: object
                    type: array
                  presence_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  repetition_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  seed:
                    maximum: 9999999999.0
                    minimum: 1
                    type: integer
                  stream:
                    default: false
                    type: boolean
                  temperature:
                    default: 0.6
                    maximum: 5
                    minimum: 0
                    type: number
                  tools:
                    items:
                      oneOf:
                      - properties:
                          description:
                            type: string
                          name:
                            type: string
                          parameters:
                            properties:
                              properties:
                                additionalProperties:
                                  properties:
                                    description:
                                      type: string
                                    type:
                                      type: string
                                  required:
                                  - type
                                  - description
                                  type: object
                                type: object
                              required:
                                items:
                                  type: string
                                type: array
                              type:
                                type: string
                            required:
                            - type
                            - properties
                            type: object
                        required:
                        - name
                        - description
                        - parameters
                      - properties:
                          function:
                            properties:
                              description:
                                type: string
                              name:
                                type: string
                              parameters:
                                properties:
                                  properties:
                                    additionalProperties:
                                      properties:
                                        description:
                                          type: string
                                        type:
                                          type: string
                                      required:
                                      - type
                                      - description
                                      type: object
                                    type: object
                                  required:
                                    items:
                                      type: string
                                    type: array
                                  type:
                                    type: string
                                required:
                                - type
                                - properties
                                type: object
                            required:
                            - name
                            - description
                            - parameters
                            type: object
                          type:
                            type: string
                        required:
                        - type
                        - function
                      type: object
                    type: array
                  top_k:
                    maximum: 50
                    minimum: 1
                    type: integer
                  top_p:
                    maximum: 2
                    minimum: 0
                    type: number
                required:
                - messages
              type: object
      responses:
        '200':
          content:
            image/png:
              schema:
                properties:
                  result:
                    format: binary
                    type: string
                  success:
                    default: 'true'
                    type: boolean
                type: object
          description: Successful response
        '400':
          content:
            application/json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        code:
                          type: string
                        message:
                          type: string
                      required:
                      - code
                      - message
                      type: object
                    type: array
                  result:
                    type: object
                  success:
                    type: boolean
                required:
                - errors
                - success
                - result
                type: object
          description: Bad request
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Execute @cf/deepseek-ai/deepseek-math-7b-instruct model.
      tags:
      - Workers AI Text Generation
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.api.account.ai
      x-cfPlanAvailability:
        business: true
        enterprise: true
        free: true
        pro: true
  /accounts/{account_id}/ai/run/@cf/defog/sqlcoder-7b-2:
    post:
      operationId: workers-ai-post-run-cf-defog-sqlcoder-7b-2
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          example: 023e105f4ecef8ad9ca31a8372d0c353
          type: string
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - properties:
                  frequency_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  lora:
                    type: string
                  max_tokens:
                    default: 256
                    type: integer
                  presence_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  prompt:
                    maxLength: 131072
                    minLength: 1
                    type: string
                  raw:
                    default: false
                    type: boolean
                  repetition_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  seed:
                    maximum: 9999999999.0
                    minimum: 1
                    type: integer
                  stream:
                    default: false
                    type: boolean
                  temperature:
                    default: 0.6
                    maximum: 5
                    minimum: 0
                    type: number
                  top_k:
                    maximum: 50
                    minimum: 1
                    type: integer
                  top_p:
                    maximum: 2
                    minimum: 0
                    type: number
                required:
                - prompt
              - properties:
                  frequency_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  functions:
                    items:
                      properties:
                        code:
                          type: string
                        name:
                          type: string
                      required:
                      - name
                      - code
                      type: object
                    type: array
                  max_tokens:
                    default: 256
                    type: integer
                  messages:
                    items:
                      properties:
                        content:
                          maxLength: 131072
                          type: string
                        role:
                          type: string
                      required:
                      - role
                      - content
                      type: object
                    type: array
                  presence_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  repetition_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  seed:
                    maximum: 9999999999.0
                    minimum: 1
                    type: integer
                  stream:
                    default: false
                    type: boolean
                  temperature:
                    default: 0.6
                    maximum: 5
                    minimum: 0
                    type: number
                  tools:
                    items:
                      oneOf:
                      - properties:
                          description:
                            type: string
                          name:
                            type: string
                          parameters:
                            properties:
                              properties:
                                additionalProperties:
                                  properties:
                                    description:
                                      type: string
                                    type:
                                      type: string
                                  required:
                                  - type
                                  - description
                                  type: object
                                type: object
                              required:
                                items:
                                  type: string
                                type: array
                              type:
                                type: string
                            required:
                            - type
                            - properties
                            type: object
                        required:
                        - name
                        - description
                        - parameters
                      - properties:
                          function:
                            properties:
                              description:
                                type: string
                              name:
                                type: string
                              parameters:
                                properties:
                                  properties:
                                    additionalProperties:
                                      properties:
                                        description:
                                          type: string
                                        type:
                                          type: string
                                      required:
                                      - type
                                      - description
                                      type: object
                                    type: object
                                  required:
                                    items:
                                      type: string
                                    type: array
                                  type:
                                    type: string
                                required:
                                - type
                                - properties
                                type: object
                            required:
                            - name
                            - description
                            - parameters
                            type: object
                          type:
                            type: string
                        required:
                        - type
                        - function
                      type: object
                    type: array
                  top_k:
                    maximum: 50
                    minimum: 1
                    type: integer
                  top_p:
                    maximum: 2
                    minimum: 0
                    type: number
                required:
                - messages
              type: object
      responses:
        '200':
          content:
            image/png:
              schema:
                properties:
                  result:
                    format: binary
                    type: string
                  success:
                    default: 'true'
                    type: boolean
                type: object
          description: Successful response
        '400':
          content:
            application/json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        code:
                          type: string
                        message:
                          type: string
                      required:
                      - code
                      - message
                      type: object
                    type: array
                  result:
                    type: object
                  success:
                    type: boolean
                required:
                - errors
                - success
                - result
                type: object
          description: Bad request
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Execute @cf/defog/sqlcoder-7b-2 model.
      tags:
      - Workers AI Text Generation
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.api.account.ai
      x-cfPlanAvailability:
        business: true
        enterprise: true
        free: true
        pro: true
  /accounts/{account_id}/ai/run/@cf/fblgit/una-cybertron-7b-v2-bf16:
    post:
      operationId: workers-ai-post-run-cf-fblgit-una-cybertron-7b-v2-bf16
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          example: 023e105f4ecef8ad9ca31a8372d0c353
          type: string
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - properties:
                  frequency_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  lora:
                    type: string
                  max_tokens:
                    default: 256
                    type: integer
                  presence_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  prompt:
                    maxLength: 131072
                    minLength: 1
                    type: string
                  raw:
                    default: false
                    type: boolean
                  repetition_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  seed:
                    maximum: 9999999999.0
                    minimum: 1
                    type: integer
                  stream:
                    default: false
                    type: boolean
                  temperature:
                    default: 0.6
                    maximum: 5
                    minimum: 0
                    type: number
                  top_k:
                    maximum: 50
                    minimum: 1
                    type: integer
                  top_p:
                    maximum: 2
                    minimum: 0
                    type: number
                required:
                - prompt
              - properties:
                  frequency_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  functions:
                    items:
                      properties:
                        code:
                          type: string
                        name:
                          type: string
                      required:
                      - name
                      - code
                      type: object
                    type: array
                  max_tokens:
                    default: 256
                    type: integer
                  messages:
                    items:
                      properties:
                        content:
                          maxLength: 131072
                          type: string
                        role:
                          type: string
                      required:
                      - role
                      - content
                      type: object
                    type: array
                  presence_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  repetition_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  seed:
                    maximum: 9999999999.0
                    minimum: 1
                    type: integer
                  stream:
                    default: false
                    type: boolean
                  temperature:
                    default: 0.6
                    maximum: 5
                    minimum: 0
                    type: number
                  tools:
                    items:
                      oneOf:
                      - properties:
                          description:
                            type: string
                          name:
                            type: string
                          parameters:
                            properties:
                              properties:
                                additionalProperties:
                                  properties:
                                    description:
                                      type: string
                                    type:
                                      type: string
                                  required:
                                  - type
                                  - description
                                  type: object
                                type: object
                              required:
                                items:
                                  type: string
                                type: array
                              type:
                                type: string
                            required:
                            - type
                            - properties
                            type: object
                        required:
                        - name
                        - description
                        - parameters
                      - properties:
                          function:
                            properties:
                              description:
                                type: string
                              name:
                                type: string
                              parameters:
                                properties:
                                  properties:
                                    additionalProperties:
                                      properties:
                                        description:
                                          type: string
                                        type:
                                          type: string
                                      required:
                                      - type
                                      - description
                                      type: object
                                    type: object
                                  required:
                                    items:
                                      type: string
                                    type: array
                                  type:
                                    type: string
                                required:
                                - type
                                - properties
                                type: object
                            required:
                            - name
                            - description
                            - parameters
                            type: object
                          type:
                            type: string
                        required:
                        - type
                        - function
                      type: object
                    type: array
                  top_k:
                    maximum: 50
                    minimum: 1
                    type: integer
                  top_p:
                    maximum: 2
                    minimum: 0
                    type: number
                required:
                - messages
              type: object
      responses:
        '200':
          content:
            image/png:
              schema:
                properties:
                  result:
                    format: binary
                    type: string
                  success:
                    default: 'true'
                    type: boolean
                type: object
          description: Successful response
        '400':
          content:
            application/json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        code:
                          type: string
                        message:
                          type: string
                      required:
                      - code
                      - message
                      type: object
                    type: array
                  result:
                    type: object
                  success:
                    type: boolean
                required:
                - errors
                - success
                - result
                type: object
          description: Bad request
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Execute @cf/fblgit/una-cybertron-7b-v2-bf16 model.
      tags:
      - Workers AI Text Generation
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.api.account.ai
      x-cfPlanAvailability:
        business: true
        enterprise: true
        free: true
        pro: true
  /accounts/{account_id}/ai/run/@cf/google/gemma-2b-it-lora:
    post:
      operationId: workers-ai-post-run-cf-google-gemma-2b-it-lora
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          example: 023e105f4ecef8ad9ca31a8372d0c353
          type: string
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - properties:
                  frequency_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  lora:
                    type: string
                  max_tokens:
                    default: 256
                    type: integer
                  presence_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  prompt:
                    maxLength: 131072
                    minLength: 1
                    type: string
                  raw:
                    default: false
                    type: boolean
                  repetition_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  seed:
                    maximum: 9999999999.0
                    minimum: 1
                    type: integer
                  stream:
                    default: false
                    type: boolean
                  temperature:
                    default: 0.6
                    maximum: 5
                    minimum: 0
                    type: number
                  top_k:
                    maximum: 50
                    minimum: 1
                    type: integer
                  top_p:
                    maximum: 2
                    minimum: 0
                    type: number
                required:
                - prompt
              - properties:
                  frequency_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  functions:
                    items:
                      properties:
                        code:
                          type: string
                        name:
                          type: string
                      required:
                      - name
                      - code
                      type: object
                    type: array
                  max_tokens:
                    default: 256
                    type: integer
                  messages:
                    items:
                      properties:
                        content:
                          maxLength: 131072
                          type: string
                        role:
                          type: string
                      required:
                      - role
                      - content
                      type: object
                    type: array
                  presence_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  repetition_penalty:
                    maximum: 2
                    minimum: 0
                    type: number
                  seed:
                    maximum: 9999999999.0
                    minimum: 1
                    type: integer
                  stream:
                    default: false
                    type: boolean
                  temperature:
                    default: 0.6
                    maximum: 5
                    minimum: 0
                    type: number
                  tools:
                    items:
                      oneOf:
                      - properties:
                          description:
                            type: string
                          name:
                            type: string
                          parameters:
                            properties:
                              properties:
                                additionalProperties:
                                  properties:
                                    description:
                                      type: string
                                    type:
                                      type: string
                                  required:
                                  - type
                                  - description
                                  type: object
                                type: object
                              required:
                                items:
                                  type: string
                                type: array
                              type:
                                type: string
                            required:
                            - type
                            - properties
        

# --- truncated at 32 KB (295 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/engineering-platform/refs/heads/main/openapi/engineering-platform-workers-ai-text-generation-api-openapi.yml