扩图

接口：POST /kling/v1/images/editing/expand 归属：快手可灵(官方格式) 调用地址：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:
  /kling/v1/images/editing/expand:
    post:
      summary: 扩图
      description: "上游文档链接已按合规要求移除；接口契约以本平台线上实测为准。"
      tags:
        - 快手可灵(官方格式)
      parameters:
        - 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:
                image:
                  type: string
                up_expansion_ratio:
                  type: number
                down_expansion_ratio:
                  type: number
                left_expansion_ratio:
                  type: number
                right_expansion_ratio:
                  type: number
                prompt:
                  type: string
                'n':
                  type: integer
              required:
                - image
                - up_expansion_ratio
                - down_expansion_ratio
                - left_expansion_ratio
                - right_expansion_ratio
            example:
              image: >-
                iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==
              up_expansion_ratio: 0.1
              down_expansion_ratio: 0.2
              left_expansion_ratio: 0.3
              right_expansion_ratio: 0.4
              prompt: 扩展背景并保持风格一致
              'n': 2
              callback_url: https://api.allyang.cn/<外部地址已按合规要求移除>
              external_task_id: task_20250818_001
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    description: "错误码，含义见错误码对照表。"
                  message:
                    type: string
                    description: "错误信息。"
                  request_id:
                    type: string
                    description: "系统为每次调用分配的请求编号，便于追踪链路与定位故障。"
                  data:
                    type: object
                    properties:
                      task_id:
                        type: string
                        description: "任务 ID，由系统分配。"
                      task_status:
                        type: string
                        description: "任务所处阶段；取值 submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）。（原文存在字段串行残留，已按枚举语义整理。）"
                        enum:
                          - submitted（已提交）
                          - processing（处理中）
                          - succeed（成功）
                          - failed（失败）
                      created_at:
                        type: integer
                        description: "任务落库时刻，Unix 时间戳，单位毫秒。"
                      updated_at:
                        type: integer
                        description: "任务最近更新时刻，Unix 时间戳，单位毫秒。"
                    required:
                      - task_id
                      - task_status
                      - created_at
                      - updated_at
                required:
                  - code
                  - message
                  - request_id
                  - data
              example:
                code: 0
                message: string
                request_id: string
                data:
                  task_id: string
                  task_status: string
                  created_at: 0
                  updated_at: 0
          headers: {}
      security: []
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []