> ## Documentation Index > Fetch the complete documentation index at: https://docs.gostudio.ai/llms.txt > Use this file to discover all available pages before exploring further. # Recreate a photo using a reference image > Recreates a photo by combining an input image with a reference style or scene image. Optionally locks identity to one or more trained profiles. Both `input_image_url` and `reference_image_url` are required. The call blocks until generation completes. Credits are deducted before generation begins and refunded if the job fails. If `profile_ids` are provided and all are invalid, the request returns `trained_profile_not_found`. ## OpenAPI ````yaml /openapi.yaml post /api/v2/photo/recreate openapi: 3.0.3 info: title: GoStudio API version: 2.0.0 description: > The GoStudio v2 REST API. Every response uses a standard envelope: successes return `{ status, data }`; errors return `{ status, error: { type, code, message } }`. All endpoints require a **Bearer token** in the `Authorization` header. The one exception is the provider webhook callback, which is authenticated by signature. servers: - url: https://www.gostudio.ai description: Production security: - bearerAuth: [] tags: - name: Watermark Remover description: AI watermark removal — orchestration, model metadata, and job polling. - name: Photo description: >- AI photo generation — generate, recreate, and manage trained profile photos. - name: Image description: Image utilities — group photo composition and image-to-prompt analysis. - name: Media description: Media upload and CDN management. - name: Apps description: GoStudio application tools — age modifier and other transformations. - name: Job Status description: Generic job polling — works across all GoStudio tools. - name: Webhooks description: Endpoints called by external services, not by your application. paths: /api/v2/photo/recreate: post: tags: - Photo summary: Recreate a photo using a reference image description: > Recreates a photo by combining an input image with a reference style or scene image. Optionally locks identity to one or more trained profiles. Both `input_image_url` and `reference_image_url` are required. The call blocks until generation completes. Credits are deducted before generation begins and refunded if the job fails. If `profile_ids` are provided and all are invalid, the request returns `trained_profile_not_found`. operationId: recreatePhoto requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PhotoRecreateRequest' examples: basic: summary: Basic recreation value: input_image_url: https://example.com/photo.jpg reference_image_url: https://example.com/reference.jpg with_instructions: summary: With instructions and profile value: input_image_url: https://example.com/photo.jpg reference_image_url: https://example.com/reference.jpg instructions: Make it look more professional profile_ids: - 42 responses: '200': description: Recreation completed successfully. content: application/json: schema: type: object properties: status: type: integer example: 200 data: $ref: '#/components/schemas/GenerationResult' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '403': $ref: '#/components/responses/Forbidden' '404': description: One or more profile IDs are invalid or inaccessible. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: 404 error: type: trained_profile_not_found code: 40403 message: Trained profile not found. '409': description: One or more profiles exist but are not yet ready for generation. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: 409 error: type: trained_profile_not_ready code: 40901 message: Trained profile is not ready. '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/ServerError' components: schemas: PhotoRecreateRequest: type: object required: - input_image_url - reference_image_url properties: input_image_url: type: string format: uri description: HTTPS URL of the image to recreate. example: https://example.com/photo.jpg reference_image_url: type: string format: uri description: HTTPS URL of the reference style or scene image. example: https://example.com/reference.jpg instructions: type: string description: Additional instructions for the recreation. example: Make it look more professional profile_ids: type: array description: IDs of trained profiles for identity lock. items: type: integer default: [] num_output_images: type: integer description: Number of images to generate. default: 1 minimum: 1 maximum: 4 output_format: type: string description: Output image format. enum: - png - jpg default: png GenerationResult: type: object properties: kind: type: string description: Always "generation". example: generation job_id: type: string description: > Encoded job identifier. Use with `GET /api/v2/apps/job/{job_id}` to poll status or re-fetch results. example: enc_abc123 credits_deducted: type: integer description: Credits spent on this generation. example: 10 credit_balance: type: integer description: Remaining credit balance after this request. example: 490 created_at: type: string format: date-time description: ISO 8601 timestamp when the job was created. output_urls: type: array description: CDN URLs for the generated images. items: type: string format: uri ErrorResponse: type: object properties: status: type: integer example: 400 error: type: object properties: type: type: string example: validation_error code: type: string example: invalid_input dev: type: integer example: 40001 message: type: string example: Some information is invalid. responses: BadRequest: description: The request was malformed or failed validation. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: 400 error: type: validation_error code: invalid_input dev: 40001 message: Some information is invalid. Unauthorized: description: Missing or invalid Authorization Bearer token. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: 401 error: type: authentication_error code: unauthorized dev: 40100 message: Missing or invalid Authorization Bearer token. PaymentRequired: description: The account does not have enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: 402 error: type: billing_error code: insufficient_credits dev: 40200 message: You don't have enough credits. Forbidden: description: Caller type not allowed for this endpoint. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: 403 error: type: permission_error code: forbidden dev: 40300 message: You don't have permission for this action. RateLimited: description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: 429 error: type: rate_limit_error code: rate_limited dev: 42900 message: You're doing that too often. Please wait a moment. ServerError: description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: 500 error: type: system_error code: internal_error dev: 50000 message: Something went wrong on our end. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Supabase user JWT (or an internal service token). Send as `Authorization: Bearer `. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.