众扬汇 AI 开放平台 API 文档

所有画图(异步)

接口:POST /v1/images/generations 归属:绘图模型/OpenAI Dall-e 格式 调用地址: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:
  /v1/images/generations:
    post:
      summary: '所有画图(异步) '
      description: "画图类模型均可用异步方式调用:在原有请求上追加 query 参数 async=true,请求体保持不变。提交:向 POST /v1/images/generations 传入 size、prompt、model 等参数,响应中返回 task_id 供后续查询。查询:用 GET /v1/images/tasks/{task_id} 获取任务状态,任务完成后响应会带上生成图片的 URL。"
      tags:
        - 绘图模型/OpenAI Dall-e 格式
      parameters:
        - name: async
          in: query
          description: "启用异步模式。"
          required: true
          example: 'true'
          schema:
            type: string
        - name: webhook
          in: query
          description: ''
          required: false
          example: https://api.allyang.cn/<外部地址已按合规要求移除>
          schema:
            type: string
        - name: Content-Type
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
        - name: Authorization
          in: header
          description: ''
          required: false
          example: Bearer {{YOUR_API_KEY}}
          schema:
            type: string
            default: Bearer {{YOUR_API_KEY}}
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                model:
                  type: string
              required:
                - prompt
                - model
            example:
              size: 1024x1024
              prompt: cat
              model: sora_image
              'n': 1
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  data:
                    type: string
                    description: "任务 id。"
                required:
                  - code
                  - message
                  - data
          headers: {}
      security: []
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []