> ## Documentation Index > Fetch the complete documentation index at: https://docs.aihubmax.com/llms.txt > Use this file to discover all available pages before exploring further. # 万象2.7 图像生成 > - Wan 2.7 图像生成与编辑模型，支持文生图和图像编辑 - 支持预设尺寸和显式宽高尺寸对象 - 异步处理模式，使用返回的任务ID [进行查询](/pages/zh/api-manual/task-management/get-task-detail) - 生成的图像链接，有效期为24小时，请尽快保存 ## OpenAPI ````yaml openapi/zh/wan-2.7-image.json POST /v1/images/generations openapi: 3.1.0 info: title: Wan 2.7 Image version: '1.0' servers: - url: https://api.aihubmax.com security: - BearerAuth: [] paths: /v1/images/generations: post: tags: - Image > Wan2.7 summary: Wan 2.7 Image description: > - Wan 2.7 图像生成与编辑模型，支持文生图和图像编辑 - 支持预设尺寸和显式宽高尺寸对象 - 异步处理模式，使用返回的任务ID [进行查询](/pages/zh/api-manual/task-management/get-task-detail) - 生成的图像链接，有效期为24小时，请尽快保存 operationId: wan-2.7-image requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WanV27ImageRequest' examples: wan_2_7_standard_text_to_image: summary: Wan 2.7 standard — text to image value: model: wan-2.7-image prompt: A cinematic portrait of a traveler in neon rain num_outputs: 1 image_size: portrait_4_3 wan_2_7_standard_multi_image_edit: summary: Wan 2.7 standard — multi-image edit value: model: wan-2.7-image prompt: >- Use image 1 as the subject and image 2 as the background, keeping realistic lighting image_urls: - https://example.com/subject.jpg - https://example.com/background.jpg num_outputs: 2 image_size: landscape_16_9 enable_prompt_expansion: true wan_2_7_pro_explicit_dimensions: summary: Wan 2.7 Pro — explicit dimensions value: model: wan-2.7-image-pro prompt: >- High-end product photography of a smartwatch on black acrylic num_outputs: 1 image_size: width: 1024 height: 1024 negative_prompt: blurry, low quality seed: 42 responses: '200': $ref: '#/components/responses/TaskCreated' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '422': $ref: '#/components/responses/UnprocessableEntity' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' '503': $ref: '#/components/responses/ServiceUnavailable' components: schemas: WanV27ImageRequest: type: object required: - model - prompt properties: model: description: |- `wan-2.7-image`：标准版，支持文生图和图像编辑 `wan-2.7-image-pro`：Pro 版，支持文生图和图像编辑 examples: - wan-2.7-image - wan-2.7-image-pro type: string default: wan-2.7-image prompt: description: | 图像生成或编辑提示词 **说明：** - 文生图模式：描述想要生成的图像内容 - 图像编辑模式：描述对参考图的编辑指令 - 支持中英文 - 最多 `2000` 个字符 maxLength: 2000 type: string example: A cinematic portrait of a traveler in neon rain image_urls: anyOf: - items: type: string type: array - type: 'null' default: null description: | 参考图片 URL 列表 **说明：** - 传入后自动切换到图像编辑模式 - 支持 1-4 张公开可访问的图片 URL - 多图编辑时，提示词中可按 image 1 / image 2 的顺序引用 example: - https://example.com/photo.jpg num_outputs: default: 1 description: | 输出图片数量 **说明：** - 文生图模式：支持 `1-5` - 图像编辑模式：支持 `1-4` maximum: 5 minimum: 1 type: integer example: 1 image_size: anyOf: - enum: - square_hd - square - portrait_4_3 - portrait_16_9 - landscape_4_3 - landscape_16_9 type: string - description: Explicit image dimensions for Wan image generation. properties: width: default: 512 description: 输出图像宽度（像素） exclusiveMinimum: 0 maximum: 14142 type: integer example: 1024 height: default: 512 description: 输出图像高度（像素） exclusiveMinimum: 0 maximum: 14142 type: integer example: 1536 type: object default: square_hd description: > 输出图像尺寸 **可选值：** - 预设：`square_hd`、`square`、`portrait_4_3`、`portrait_16_9`、`landscape_4_3`、`landscape_16_9` - 显式尺寸对象：`{width, height}` example: square_hd negative_prompt: default: '' description: 负向提示词，用于描述希望避免出现的内容 maxLength: 500 type: string example: blurry, low quality seed: anyOf: - maximum: 2147483647 minimum: 0 type: integer - type: 'null' default: null description: 随机种子，用于提升结果复现性 example: 42 enable_safety_checker: anyOf: - type: boolean - type: 'null' default: null description: |- 是否启用安全检查 **说明：** - 控制输入和输出的内容安全审核 - 不传则使用模型默认行为 > 非必须不要传这个参数。 x-advanced: true example: true enable_prompt_expansion: anyOf: - type: boolean - type: 'null' default: null description: |- 是否启用提示词扩展 **说明：** - 仅图像编辑模式可用 - 不传则使用模型默认行为 > 非必须不要传这个参数。 x-advanced: true example: true TaskResponse: type: object properties: created: type: integer description: 任务创建时间戳 example: 1757165031 id: type: string description: 任务ID example: task-unified-1757165031-uyujaw3d model: type: string description: 实际使用的模型名称 object: type: string description: 任务的具体类型 enum: - image.generation.task progress: type: integer description: 任务进度百分比 (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: 任务状态 enum: - pending - processing - completed - failed example: pending task_info: type: object description: 异步任务信息 properties: can_cancel: type: boolean description: 任务是否可以取消 example: true estimated_time: type: integer description: 预计完成时间（秒） example: 45 type: type: string description: 任务的输出类型 enum: - image example: image ErrorResponse400: type: object properties: error: type: object properties: message: type: string example: 请求格式错误 type: type: string example: invalid_request_error ErrorResponse401: type: object properties: error: type: object properties: message: type: string example: API密钥无效 type: type: string example: authentication_error ErrorResponse402: type: object properties: error: type: object properties: message: type: string example: 账户余额不足 type: type: string example: insufficient_quota ErrorResponse422: type: object properties: error: type: object properties: message: type: string example: 参数校验失败 type: type: string example: validation_error ErrorResponse429: type: object properties: error: type: object properties: message: type: string example: 请求频率超限 type: type: string example: rate_limit_error ErrorResponse500: type: object properties: error: type: object properties: message: type: string example: 服务器内部错误 type: type: string example: server_error ErrorResponse503: type: object properties: error: type: object properties: message: type: string example: 服务暂不可用，请稍后重试 type: type: string example: service_unavailable responses: TaskCreated: description: 任务创建成功 content: application/json: schema: $ref: '#/components/schemas/TaskResponse' BadRequest: description: 请求格式错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse400' Unauthorized: description: 未授权 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse401' PaymentRequired: description: 余额不足 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse402' UnprocessableEntity: description: 参数校验失败 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse422' TooManyRequests: description: 请求频率超限 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse429' InternalServerError: description: 服务器内部错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse500' ServiceUnavailable: description: 服务暂不可用 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse503' securitySchemes: BearerAuth: type: http scheme: bearer description: | ## 所有接口均需要使用Bearer Token进行认证 ## 使用时在请求头中添加： `Authorization: Bearer YOUR_API_KEY` ````