众扬汇 AI 开放平台 API 文档

指定ID获取任务(免费

接口:GET /mj/task/{id}/fetch 归属:绘图模型/Mid journey/任务查询(免费 调用地址:Base URL https://api.allyang.cn(OpenAI 兼容前缀 https://api.allyang.cn/v1)+ 上述路径 鉴权:请求头 Authorization: Bearer <你的令牌>;令牌在控制台「令牌管理」创建 说明:下方为本接口契约。路径、字段名与枚举取值与线上接口一致;叙述文字已按本平台口径重写。价格、并发与限流等数值以控制台及实际返回为准,未确认处标注「待补」。

OpenAPI Specification

yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /mj/task/{id}/fetch:
    get:
      summary: 指定ID获取任务(免费
      description: ''
      tags:
        - 绘图模型/Mid journey/任务查询(免费
        - 任务查询
      parameters:
        - name: id
          in: path
          description: "任务 ID。"
          required: true
          example: ''
          schema:
            type: string
        - name: Authorization
          in: header
          description: ''
          required: false
          example: Bearer {{YOUR_API_KEY}}
          schema:
            type: string
            default: Bearer {{YOUR_API_KEY}}
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  action:
                    type: string
                    description: "任务类型。"
                    enum:
                      - IMAGINE
                      - UPSCALE
                      - VARIATION
                      - REROLL
                      - DESCRIBE
                      - BLEND
                  description:
                    type: string
                    description: "任务描述。"
                  failReason:
                    type: string
                    description: "失败原因。"
                  finishTime:
                    type: integer
                    format: int64
                    description: "结束时间。"
                  id:
                    type: string
                    description: "ID。"
                  imageUrl:
                    type: string
                    description: "图片 url。"
                  progress:
                    type: string
                    description: "任务进度。"
                  prompt:
                    type: string
                    description: "提示词。"
                  promptEn:
                    type: string
                    description: "英文提示词。"
                  properties:
                    type: object
                    properties: {}
                  startTime:
                    type: integer
                    format: int64
                    description: "开始执行时刻。"
                  state:
                    type: string
                    description: "自定义参数。"
                  status:
                    type: string
                    description: "任务状态。"
                    enum:
                      - NOT_START
                      - SUBMITTED
                      - IN_PROGRESS
                      - FAILURE
                      - SUCCESS
                  submitTime:
                    type: integer
                    format: int64
                    description: "提交时间。"
                  buttons:
                    type: array
                    items:
                      type: object
                      properties:
                        customId:
                          type: string
                          description: "action,提交时必填。"
                        label:
                          type: string
                          description: "在 MJ 侧显示的图标。"
                        type:
                          type: string
                        style:
                          type: string
                        emoji:
                          type: string
                      required:
                        - customId
                        - label
                        - type
                        - style
                        - emoji
          headers: {}
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
        '403':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
        '404':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
      security: []
components:
  schemas:
    任务:
      type: object
      properties:
        action:
          type: string
          description: "任务类型。"
          enum:
            - IMAGINE
            - UPSCALE
            - VARIATION
            - REROLL
            - DESCRIBE
            - BLEND
        description:
          type: string
          description: "任务描述。"
        failReason:
          type: string
          description: "失败原因。"
        finishTime:
          type: integer
          format: int64
          description: "结束时间。"
        id:
          type: string
          description: "ID。"
        imageUrl:
          type: string
          description: "图片 url。"
        progress:
          type: string
          description: "任务进度。"
        prompt:
          type: string
          description: "提示词。"
        promptEn:
          type: string
          description: "英文提示词。"
        properties:
          type: object
          properties: {}
        startTime:
          type: integer
          format: int64
          description: "开始执行时刻。"
        state:
          type: string
          description: "自定义参数。"
        status:
          type: string
          description: "任务状态。"
          enum:
            - NOT_START
            - SUBMITTED
            - IN_PROGRESS
            - FAILURE
            - SUCCESS
        submitTime:
          type: integer
          format: int64
          description: "提交时间。"
      title: 任务
  securitySchemes: {}
servers: []
security: []