Skip to content

vllm.entrypoints.openai.completion.api_router

ENDPOINT_LOAD_METRICS_FORMAT_HEADER_LABEL module-attribute 

ENDPOINT_LOAD_METRICS_FORMAT_HEADER_LABEL = (
    "endpoint-load-metrics-format"
)

logger module-attribute 

logger = init_logger(__name__)

router module-attribute 

router = APIRouter()

attach_router 

attach_router(app: FastAPI)
Source code in vllm/entrypoints/openai/completion/api_router.py 
105
106
def attach_router(app: FastAPI):
    app.include_router(router)

completion 

completion(
    request: Request,
) -> OpenAIServingCompletion | None
Source code in vllm/entrypoints/openai/completion/api_router.py 
30
31
def completion(request: Request) -> OpenAIServingCompletion | None:
    return request.app.state.openai_serving_completion

create_completion async 

create_completion(
    request: CompletionRequest, raw_request: Request
)
Source code in vllm/entrypoints/openai/completion/api_router.py 
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
@router.post(
    "/v1/completions",
    dependencies=[Depends(validate_json_request)],
    responses={
        HTTPStatus.OK.value: {"content": {"text/event-stream": {}}},
        HTTPStatus.BAD_REQUEST.value: {"model": ErrorResponse},
        HTTPStatus.NOT_FOUND.value: {"model": ErrorResponse},
        HTTPStatus.INTERNAL_SERVER_ERROR.value: {"model": ErrorResponse},
    },
)
@with_cancellation
@load_aware_call
async def create_completion(request: CompletionRequest, raw_request: Request):
    metrics_header_format = raw_request.headers.get(
        ENDPOINT_LOAD_METRICS_FORMAT_HEADER_LABEL, ""
    )
    handler = completion(raw_request)
    if handler is None:
        base_server = raw_request.app.state.openai_serving_tokenization
        return base_server.create_error_response(
            message="The model does not support Completions API"
        )

    try:
        generator = await handler.create_completion(request, raw_request)
    except Exception as e:
        return handler.create_error_response(e)

    if isinstance(generator, ErrorResponse):
        return JSONResponse(
            content=generator.model_dump(), status_code=generator.error.code
        )
    elif isinstance(generator, CompletionResponse):
        return JSONResponse(
            content=generator.model_dump(),
            headers=metrics_header(metrics_header_format),
        )

    return StreamingResponse(content=generator, media_type="text/event-stream")

render_completion async 

render_completion(
    request: CompletionRequest, raw_request: Request
)

render completion request and return engine prompts without generating.

Source code in vllm/entrypoints/openai/completion/api_router.py 
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
@router.post(
    "/v1/completions/render",
    dependencies=[Depends(validate_json_request)],
    response_model=list,
    responses={
        HTTPStatus.BAD_REQUEST.value: {"model": ErrorResponse},
        HTTPStatus.NOT_FOUND.value: {"model": ErrorResponse},
        HTTPStatus.INTERNAL_SERVER_ERROR.value: {"model": ErrorResponse},
    },
)
async def render_completion(request: CompletionRequest, raw_request: Request):
    """render completion request and return engine prompts without generating."""
    handler = completion(raw_request)
    if handler is None:
        base_server = raw_request.app.state.openai_serving_tokenization
        return base_server.create_error_response(
            message="The model does not support Completions API"
        )

    try:
        result = await handler.render_completion_request(request)
    except Exception as e:
        return handler.create_error_response(e)

    if isinstance(result, ErrorResponse):
        return JSONResponse(content=result.model_dump(), status_code=result.error.code)

    return JSONResponse(content=result)