> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Change Gender > Users upload a face picture, based on the face editing and generation algorithm, output a face gender conversion picture. Male to female can achieve beauty, light makeup, add bangs and long hair effect; Female to male can achieve the effect of adding a beard and changing short hair. ## OpenAPI ````yaml /openapi/face-change.json post /face/change-gender openapi: 3.0.0 info: title: Face Transformation version: 1.0.0 description: API reference for Face Transformation on Ace Data Cloud. servers: - url: https://api.acedata.cloud description: Ace Data Cloud API security: - bearerAuth: [] paths: /face/change-gender: post: summary: Change Gender description: >- Users upload a face picture, based on the face editing and generation algorithm, output a face gender conversion picture. Male to female can achieve beauty, light makeup, add bangs and long hair effect; Female to male can achieve the effect of adding a beard and changing short hair. parameters: - in: header name: accept schema: enum: - application/json - application/x-ndjson type: string required: false description: Face Change Gender Param Accept requestBody: content: application/json: schema: type: object required: - image_url - gender_infos properties: image_url: type: string description: Face Change Gender Image Url gender_infos: type: array items: type: object properties: gender: type: number description: Face Change Gender Gender Infos Gender face_rect: type: object properties: x: type: number description: Face Change Gender Gender Infos Face Rect X 'y': type: number description: Face Change Gender Gender Infos Face Rect Y width: type: number description: Face Change Gender Gender Infos Face Rect Width height: type: number description: Face Change Gender Gender Infos Face Rect Height description: Face Change Gender Gender Infos Face Rect description: Face Change Gender Gender Infos example: image_url: https://cdn.acedata.cloud/4hfydw.jpg gender_infos: - gender: 1 face_rect: x: 784 'y': 503 width: 274 height: 228 required: true responses: '200': content: application/json: schema: type: object example: image_url: >- https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/ft/SwapGenderPic/1256437459/022636b0-e682-4be6-88c4-461bffa77aae properties: image_url: type: string description: Face Change Gender Response 200 Image Url description: Face Change Gender Response 200 '400': content: application/json: schema: oneOf: - type: object example: error: code: token_mismatched message: The specified token is not matched with API. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: token_mismatched description: Face Change Gender Response 400 Error Code message: type: string example: The specified token is not matched with API. description: Face Change Gender Response 400 Error Message trace_id: type: string description: Face Change Gender Response 400 Trace Id - type: object example: error: code: api_not_implemented message: The API is not implemented. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: api_not_implemented description: Face Change Gender Response 400 Error Code 2 message: type: string example: The API is not implemented. description: Face Change Gender Response 400 Error Message 2 trace_id: type: string description: Face Change Gender Response 400 Trace Id 2 description: Face Change Gender Response 400 '401': content: application/json: schema: oneOf: - type: object example: error: code: invalid_token message: The specified token is invalid or wrong. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: invalid_token description: Face Change Gender Response 401 Error Code message: type: string example: The specified token is invalid or wrong. description: Face Change Gender Response 401 Error Message trace_id: type: string description: Face Change Gender Response 401 Trace Id description: Face Change Gender Response 401 '429': content: application/json: schema: oneOf: - type: object example: error: code: too_many_requests message: You have exceeded the rate limit. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: too_many_requests description: Face Change Gender Response 429 Error Code message: type: string example: You have exceeded the rate limit. description: Face Change Gender Response 429 Error Message trace_id: type: string description: Face Change Gender Response 429 Trace Id description: Face Change Gender Response 429 '500': content: application/json: schema: oneOf: - type: object example: error: code: api_error message: Internal server error. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: api_error description: Face Change Gender Response 500 Error Code message: type: string example: Internal server error. description: Face Change Gender Response 500 Error Message trace_id: type: string description: Face Change Gender Response 500 Trace Id description: Face Change Gender Response 500 security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer description: API token from https://platform.acedata.cloud ````