"""Generate API V1 routes """ from typing import List, Optional from fastapi import APIRouter, Depends, Header, Query, UploadFile from fastapi.params import File from modules.util import HWC3 from fooocusapi.models.common.base import DescribeImageType from fooocusapi.utils.api_utils import api_key_auth from fooocusapi.models.common.requests import CommonRequest as Text2ImgRequest from fooocusapi.models.requests_v1 import ( ImageEnhanceRequest, ImgUpscaleOrVaryRequest, ImgPromptRequest, ImgInpaintOrOutpaintRequest ) from fooocusapi.models.common.response import ( AsyncJobResponse, GeneratedImageResult, DescribeImageResponse, StopResponse ) from fooocusapi.utils.call_worker import call_worker from fooocusapi.utils.img_utils import read_input_image from fooocusapi.configs.default import img_generate_responses from fooocusapi.worker import process_stop secure_router = APIRouter( dependencies=[Depends(api_key_auth)] ) def stop_worker(): """Interrupt worker process""" process_stop() @secure_router.post( path="/v1/generation/text-to-image", response_model=List[GeneratedImageResult] | AsyncJobResponse, responses=img_generate_responses, tags=["GenerateV1"]) def text2img_generation( req: Text2ImgRequest, accept: str = Header(None), accept_query: str | None = Query( None, alias='accept', description="Parameter to override 'Accept' header, 'image/png' for output bytes")): """\nText to Image Generation\n A text to image generation endpoint Arguments: req {Text2ImgRequest} -- Text to image generation request accept {str} -- Accept header accept_query {str} -- Parameter to override 'Accept' header, 'image/png' for output bytes returns: Response -- img_generate_responses """ if accept_query is not None and len(accept_query) > 0: accept = accept_query return call_worker(req, accept) @secure_router.post( path="/v1/generation/image-upscale-vary", response_model=List[GeneratedImageResult] | AsyncJobResponse, responses=img_generate_responses, tags=["GenerateV1"]) def img_upscale_or_vary( input_image: UploadFile, req: ImgUpscaleOrVaryRequest = Depends(ImgUpscaleOrVaryRequest.as_form), accept: str = Header(None), accept_query: str | None = Query( None, alias='accept', description="Parameter to override 'Accept' header, 'image/png' for output bytes")): """\nImage upscale or vary\n Image upscale or vary Arguments: input_image {UploadFile} -- Input image file req {ImgUpscaleOrVaryRequest} -- Request body accept {str} -- Accept header accept_query {str} -- Parameter to override 'Accept' header, 'image/png' for output bytes Returns: Response -- img_generate_responses """ if accept_query is not None and len(accept_query) > 0: accept = accept_query return call_worker(req, accept) @secure_router.post( path="/v1/generation/image-inpaint-outpaint", response_model=List[GeneratedImageResult] | AsyncJobResponse, responses=img_generate_responses, tags=["GenerateV1"]) def img_inpaint_or_outpaint( input_image: UploadFile, req: ImgInpaintOrOutpaintRequest = Depends(ImgInpaintOrOutpaintRequest.as_form), accept: str = Header(None), accept_query: str | None = Query( None, alias='accept', description="Parameter to override 'Accept' header, 'image/png' for output bytes")): """\nInpaint or outpaint\n Inpaint or outpaint Arguments: input_image {UploadFile} -- Input image file req {ImgInpaintOrOutpaintRequest} -- Request body accept {str} -- Accept header accept_query {str} -- Parameter to override 'Accept' header, 'image/png' for output bytes """ if accept_query is not None and len(accept_query) > 0: accept = accept_query return call_worker(req, accept) @secure_router.post( path="/v1/generation/image-prompt", response_model=List[GeneratedImageResult] | AsyncJobResponse, responses=img_generate_responses, tags=["GenerateV1"]) def img_prompt( cn_img1: UploadFile, # Required field cn_img2: Optional[UploadFile] = File(None), cn_img3: Optional[UploadFile] = File(None), cn_img4: Optional[UploadFile] = File(None), req: ImgPromptRequest = Depends(ImgPromptRequest.as_form), accept: str = Header(None), accept_query: str | None = Query( None, alias='accept', description="Parameter to override 'Accept' header, 'image/png' for output bytes")): """\nImage Prompt\n Image Prompt A prompt-based image generation with up to four control images. Arguments: cn_img1 {UploadFile} -- First control image (required) cn_img2 {UploadFile} -- Second control image (optional) cn_img3 {UploadFile} -- Third control image (optional) cn_img4 {UploadFile} -- Fourth control image (optional) req {ImgPromptRequest} -- Request body containing prompt and control parameters accept {str} -- Accept header accept_query {str} -- Parameter to override 'Accept' header, 'image/png' for output bytes Returns: Response -- img_generate_responses """ if accept_query is not None and len(accept_query) > 0: accept = accept_query return call_worker(req, accept) @secure_router.post( path="/v1/generation/image-enhance", response_model=List[GeneratedImageResult] | AsyncJobResponse, responses=img_generate_responses, tags=["GenerateV1"]) def img_enhance( # Renamed to avoid function name collision enhance_input_image: Optional[UploadFile] = File(None), req: ImageEnhanceRequest = Depends(ImageEnhanceRequest.as_form), accept: str = Header(None), accept_query: str | None = Query( None, alias='accept', description="Parameter to override 'Accept' header, 'image/png' for output bytes")): """\nImage Enhance\n Enhance an image with optional input. Arguments: enhance_input_image {UploadFile} -- Input image file (optional) req {ImageEnhanceRequest} -- Request body accept {str} -- Accept header accept_query {str} -- Parameter to override 'Accept' header, 'image/png' for output bytes Returns: Response -- img_generate_responses """ if accept_query is not None and len(accept_query) > 0: accept = accept_query return call_worker(req, accept) @secure_router.post( path="/v1/tools/describe-image", response_model=DescribeImageResponse, tags=["GenerateV1"]) def describe_image( image: UploadFile, image_type: DescribeImageType = Query( DescribeImageType.photo, description="Image type, 'Photo' or 'Anime'")): """\nDescribe image\n Describe image, Get tags from an image Arguments: image {UploadFile} -- Image to get tags image_type {DescribeImageType} -- Image type, 'Photo' or 'Anime' Returns: DescribeImageResponse -- Describe image response, a string """ if image_type == DescribeImageType.photo: from extras.interrogate import default_interrogator as default_interrogator_photo interrogator = default_interrogator_photo else: from extras.wd14tagger import default_interrogator as default_interrogator_anime interrogator = default_interrogator_anime img = HWC3(read_input_image(image)) result = interrogator(img) return DescribeImageResponse(describe=result) @secure_router.post( path="/v1/generation/stop", response_model=StopResponse, description="Job stopping", tags=["Default"]) def stop(): """Interrupt worker""" stop_worker() return StopResponse(msg="success")