> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aitoearn.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 编辑图像

> 接口说明：同步编辑图像，基于参考图与指令进行编辑。



## OpenAPI

````yaml /openapi/zh/aitoearn.openapi.json post /api/ai/image/edit
openapi: 3.0.1
info:
  title: AiToEarn 开放平台 API
  description: AiToEarn 开放平台 API，支持在中国站与国际站之间切换调试。业务是否成功以响应体 code === 0 为准。
  version: 1.0.0
  contact: {}
servers:
  - url: https://aitoearn.cn
    description: 中国站
  - url: https://aitoearn.ai
    description: 国际站
security: []
tags:
  - name: AI 服务
  - name: AI 服务/视频生成
  - name: AI 服务/图像生成
  - name: AI 服务/模型中转
  - name: 渠道管理
  - name: 渠道管理/账号
  - name: 渠道管理/内容发布
  - name: 渠道管理/平台
  - name: 渠道管理/互动
  - name: 渠道管理/作品
  - name: 渠道管理/账号分组
  - name: 渠道管理/授权
  - name: 资源管理
paths:
  /api/ai/image/edit:
    post:
      tags:
        - AI 服务/图像生成
      summary: 编辑图像
      description: 接口说明：同步编辑图像，基于参考图与指令进行编辑。
      operationId: ImageController_editImage
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  description: 图片编辑模型
                image:
                  anyOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  description: 原始图片
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 4000
                  description: 编辑描述
                mask:
                  type: string
                  description: 遮罩图片
                'n':
                  description: 生成图片数量
                  type: integer
                  minimum: 1
                  maximum: 1
                size:
                  type: string
                  description: 图片尺寸
                response_format:
                  type: string
                  enum:
                    - url
                    - b64_json
                  description: 返回格式
                user:
                  type: string
                  description: 用户标识符
                source:
                  description: 消费来源
                  type: string
                  enum:
                    - ai_image
                    - ai_draft_generation
                    - plugin
              required:
                - model
                - image
                - prompt
            examples: {}
        required: true
      responses:
        '200':
          description: 请求已被服务处理。业务是否成功以响应体 code === 0 为准。
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/ImageResponseVo'
                  code:
                    type: integer
                    description: 业务状态码。0 表示成功，非 0 表示业务错误。
                  message:
                    type: string
                    description: 响应消息。
                  requestId:
                    type: string
                    description: 请求 ID。
                  timestamp:
                    type: integer
                    description: 错误响应时间戳，Unix 毫秒。
                required:
                  - code
                  - message
              examples:
                success:
                  summary: 成功
                  value:
                    code: 0
                    message: 请求成功
                    data:
                      created: 1
                      list:
                        - url: string
                          b64_json: string
                          revised_prompt: string
                      usage:
                        input_tokens: 1
                        output_tokens: 1
                        total_tokens: 1
                      background: string
                      output_format: string
                      quality: string
                      size: string
                validationFailed10002:
                  summary: ValidationFailed (10002)
                  value:
                    code: 10002
                    message: 参数验证失败
                    data: {}
                    timestamp: 1772099056662
                unauthorized401:
                  summary: 未认证或 API Key 无效
                  value:
                    code: 401
                    message: Unauthorized
                    data: {}
                    timestamp: 1772099056662
                invalidModel12300:
                  summary: InvalidModel (12300)
                  value:
                    code: 12300
                    message: 无效的 AI 模型
                    data: {}
                    timestamp: 1772099056662
      deprecated: false
      security:
        - apikey-header-X-Api-Key: []
components:
  schemas:
    ImageResponseVo:
      type: object
      properties:
        created:
          type: number
          description: 创建时间戳
        list:
          type: array
          items:
            type: object
            properties:
              url:
                description: 图片URL
                type: string
              b64_json:
                description: base64编码的图片
                type: string
              revised_prompt:
                description: 修订后的提示词
                type: string
            additionalProperties: false
          description: 生成的图片列表
        usage:
          description: token使用情况
          type: object
          properties:
            input_tokens:
              description: 输入token数
              type: number
            output_tokens:
              description: 输出token数
              type: number
            total_tokens:
              description: 总token数
              type: number
          additionalProperties: false
        background:
          type: string
          description: 背景
        output_format:
          type: string
          description: 输出格式
        quality:
          type: string
          description: 质量档位
        size:
          type: string
          description: 图片尺寸
      required:
        - created
        - list
      additionalProperties: false
  securitySchemes:
    apikey-header-X-Api-Key:
      type: apiKey
      in: header
      name: X-Api-Key
      description: AiToEarn Open Platform API Key。

````