authentication failed 401

[isminllah]

i'm trying to use docling via api from a webapp.

public function actionConvert()
{
$requestId = null;
$result = null;
$helper = new DoclingHelper();

    if (Yii::$app->request->isPost) {
        $filePath = Yii::getAlias('@app/h_upload/ai_export_100.xlsx');

        $history = [];
        $stack = \GuzzleHttp\HandlerStack::create();
        $stack->push(\GuzzleHttp\Middleware::history($history));

        $client = new Client([
            'base_uri' => 'http://docling_service:5001/v1/',
            'timeout'  => 300,
            'handler' => $stack,
        ]);

        $multipart = [
            ['name' => 'auth', 'contents' => 'Hello!'],
            ['name' => 'ocr_engine', 'contents' => 'easyocr'],
            ['name' => 'pdf_backend', 'contents' => 'dlparse_v2'],
            ['name' => 'from_formats', 'contents' => 'pdf'],
            ['name' => 'force_ocr', 'contents' => 'false'],
            ['name' => 'image_export_mode', 'contents' => 'embedded'],
            ['name' => 'ocr_lang', 'contents' => 'en'],
            ['name' => 'ocr_lang', 'contents' => 'pl'],
            ['name' => 'table_mode', 'contents' => 'fast'],
            [
                'name' => 'files',
                'contents' => fopen($filePath, 'r'),
                'filename' => basename($filePath),
                'headers' => ['Content-Type' => 'application/' . $helper->extractFileType($filePath)],
            ],
            ['name' => 'abort_on_error', 'contents' => 'false'],
            ['name' => 'to_formats', 'contents' => 'md'],
            ['name' => 'to_formats', 'contents' => 'text'],
            ['name' => 'do_ocr', 'contents' => 'true'],
        ];

        try {
            $response = $client->request('POST', 'convert/file', [
                'headers' => ['accept' => 'application/json'],
                'multipart' => $multipart,
            ]);

            $body = json_decode($response->getBody()->getContents(), true);
            $requestId = $body['request_id'] ?? null;

        } catch (RequestException $e) {
            $result = [
                'error' => $e->getMessage(),
                'response' => $e->hasResponse() ? (string)$e->getResponse()->getBody() : null,
            ];
        }

        if (!empty($history)) {
            $last = end($history);
            echo "<pre>";
            echo "REQUEST METHOD: " . $last['request']->getMethod() . "\n";
            echo "REQUEST URI: " . $last['request']->getUri() . "\n";
            echo "REQUEST HEADERS: " . print_r($last['request']->getHeaders(), true) . "\n";
            echo "REQUEST BODY: " . (string)$last['request']->getBody() . "\n";
            echo "RESPONSE STATUS: " . $last['response']->getStatusCode() . "\n";
            echo "RESPONSE BODY: " . (string)$last['response']->getBody() . "\n";
            echo "</pre>";
            die();
        }
    }

    return $this->render('index', [
        'requestId' => $requestId,
        'result' => $result,
    ]);
} 

but the authentication fails every time. 
REQUEST METHOD: POST

REQUEST URI: http://docling_service:5001/v1/convert/file
REQUEST HEADERS: Array
(
[Content-Length] => Array
(
[0] => 8190
)

[User-Agent] => Array
    (
        [0] => GuzzleHttp/7
    )

[Content-Type] => Array
    (
        [0] => multipart/form-data; boundary=d7f3749ed18baa34d3bd67bbb1d646463ce7e5d8
    )

[Host] => Array
    (
        [0] => docling_service:5001
    )

[accept] => Array
    (
        [0] => application/json
    )

)

REQUEST BODY: --d7f3749ed18baa34d3bd67bbb1d646463ce7e5d8
Content-Disposition: form-data; name="auth"
Content-Length: 6

Hello!
--d7f3749ed18baa34d3bd67bbb1d646463ce7e5d8
Content-Disposition: form-data; name="ocr_engine"
Content-Length: 7

easyocr
--d7f3749ed18baa34d3bd67bbb1d646463ce7e5d8
Content-Disposition: form-data; name="pdf_backend"
Content-Length: 10

dlparse_v2
--d7f3749ed18baa34d3bd67bbb1d646463ce7e5d8
Content-Disposition: form-data; name="from_formats"
Content-Length: 3

pdf
--d7f3749ed18baa34d3bd67bbb1d646463ce7e5d8
Content-Disposition: form-data; name="force_ocr"
Content-Length: 5

false
--d7f3749ed18baa34d3bd67bbb1d646463ce7e5d8
Content-Disposition: form-data; name="image_export_mode"
Content-Length: 8

embedded
--d7f3749ed18baa34d3bd67bbb1d646463ce7e5d8
Content-Disposition: form-data; name="ocr_lang"
Content-Length: 2

en
--d7f3749ed18baa34d3bd67bbb1d646463ce7e5d8
Content-Disposition: form-data; name="ocr_lang"
Content-Length: 2

pl
--d7f3749ed18baa34d3bd67bbb1d646463ce7e5d8
Content-Disposition: form-data; name="table_mode"
Content-Length: 4

fast
--d7f3749ed18baa34d3bd67bbb1d646463ce7e5d8
Content-Type: application/xlsx
Content-Disposition: form-data; name="files"; filename="ai_export_100.xlsx"
Content-Length: 6369 it gets the file but RESPONSE STATUS: 401
RESPONSE BODY: {"detail":"Unauthorized"}.
I tried converting from the shell using curl and it works, the only problem is here, i think the problem is that docling needs an api key but i couldn't find anything about.

[dosubot[bot]]

Hi @isminllah! I'm Dosu and I’m helping the docling team.

The Docling API expects authentication via an API key provided in the request header, specifically as X-API-Key. Including a form field named auth will not work. To fix the 401 error, add your API key to the headers in your Guzzle request like this:

$response = $client->request('POST', 'convert/file', [
    'headers' => [
        'accept' => 'application/json',
        'X-API-Key' => 'YOUR_API_KEY_HERE', // replace with your actual key
    ],
    'multipart' => $multipart,
]);

Make sure your API key matches what is configured on the Docling server. This header is required for authentication and is enforced by the API logic source.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[isminllah]

RESOLVED: i added the row for the api key on the docker-compose configuration:
docling_service: image: quay.io/docling-project/docling-serve container_name: docling_service restart: unless-stopped networks: - docker-network ports: - "50378:5001" environment: - DOCLING_SERVE_API_KEY=${DOCLING_SERVE_API_KEY}