APIPASS API Marketplace Jobs API

The Jobs API from APIPASS API Marketplace — 2 operation(s) for jobs.

Operations 2

POST /api/v1/jobs/createTask Create Task #
GET /api/v1/jobs/recordInfo Get Task Record #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/apipass:apipass-jobs-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

apipass-jobs-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: ApiPass Platform Jobs API
  version: 1.0.0
tags:
- name: Jobs
paths:
  /api/v1/jobs/createTask:
    post:
      tags:
      - Jobs
      summary: Create Task
      description: '创建任务


        此 API 会先检查用户 credit 余额,如果余额不足会立即返回错误。

        如果余额充足,会预扣相应的 credit,然后创建任务。

        任务成功完成后 credit 不退回;任务失败后会自动退回 credit。'
      operationId: create_task_api_v1_jobs_createTask_post
      parameters:
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          description: Bearer YOUR_API_KEY
          title: Authorization
        description: Bearer YOUR_API_KEY
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateTaskRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateTaskResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/jobs/recordInfo:
    get:
      tags:
      - Jobs
      summary: Get Task Record
      description: 查询任务记录(自动轮询更新进行中的任务状态)
      operationId: get_task_record_api_v1_jobs_recordInfo_get
      parameters:
      - name: taskId
        in: query
        required: true
        schema:
          type: string
          description: 任务ID
          title: Taskid
        description: 任务ID
      - name: authorization
        in: header
        required: true
        schema:
          type: string
          description: Bearer YOUR_API_KEY
          title: Authorization
        description: Bearer YOUR_API_KEY
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskRecordResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    TaskRecordData:
      properties:
        taskId:
          type: string
          title: Taskid
        model:
          type: string
          title: Model
        state:
          type: string
          title: State
        param:
          type: string
          title: Param
        resultJson:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Resultjson
        failCode:
          anyOf:
          - type: string
          - type: 'null'
          title: Failcode
        failMsg:
          anyOf:
          - type: string
          - type: 'null'
          title: Failmsg
        costTime:
          type: integer
          title: Costtime
          default: 0
        completeTime:
          anyOf:
          - type: integer
          - type: 'null'
          title: Completetime
        createTime:
          type: integer
          title: Createtime
        modelRequested:
          anyOf:
          - type: string
          - type: 'null'
          title: Modelrequested
        modelUsed:
          anyOf:
          - type: string
          - type: 'null'
          title: Modelused
        fallbackTriggered:
          type: boolean
          title: Fallbacktriggered
          default: false
        billingChannelType:
          anyOf:
          - type: string
          - type: 'null'
          title: Billingchanneltype
      type: object
      required:
      - taskId
      - model
      - state
      - param
      - createTime
      title: TaskRecordData
      description: 任务记录数据
    FallbackModelEntry:
      properties:
        model:
          type: string
          title: Model
          description: 备选模型名称
        channel:
          type: string
          title: Channel
          description: 该备选模型走哪个渠道:starter / enterprise / regular / official / auto,默认 auto
          default: auto
        input:
          additionalProperties: true
          type: object
          title: Input
          description: 该备选模型自己的输入参数,不会和主模型 input 自动合并
      type: object
      required:
      - model
      - input
      title: FallbackModelEntry
      description: fallback_models 的单条目结构(新格式)
    CreateTaskRequest:
      properties:
        model:
          type: string
          title: Model
          description: 模型类型
        callBackUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Callbackurl
          description: 回调URL
        input:
          additionalProperties: true
          type: object
          title: Input
          description: 输入参数
        channel:
          type: string
          title: Channel
          description: 主模型渠道选择:starter / enterprise / regular / official / auto,默认 auto
          default: auto
        fallback_models:
          anyOf:
          - items:
              $ref: '#/components/schemas/FallbackModelEntry'
            type: array
          - type: 'null'
          title: Fallback Models
          description: 备选模型列表,按优先级排序。格式为 [{model, channel, input}, ...],input 必填
      type: object
      required:
      - model
      - input
      title: CreateTaskRequest
      description: 创建任务请求
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    CreateTaskResponse:
      properties:
        code:
          type: integer
          title: Code
          description: 状态码
          default: 200
        message:
          type: string
          title: Message
          description: 响应消息
          default: success
        data:
          additionalProperties:
            type: string
          type: object
          title: Data
          description: 包含taskId的数据
      type: object
      required:
      - data
      title: CreateTaskResponse
      description: 创建任务响应
    TaskRecordResponse:
      properties:
        code:
          type: integer
          title: Code
          description: 状态码
          default: 200
        message:
          type: string
          title: Message
          description: 响应消息
          default: success
        data:
          $ref: '#/components/schemas/TaskRecordData'
      type: object
      required:
      - data
      title: TaskRecordResponse
      description: 任务记录响应
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer