php-llm · chr-hertel · Jul 6, 2025 · Jul 4, 2025
diff --git a/README.md b/README.md
@@ -680,7 +680,7 @@ use PhpLlm\LlmChain\Platform\Bridge\OpenAI\Embeddings;
 
 $embeddings = new Embeddings($platform, Embeddings::TEXT_3_SMALL);
 
-$vectors = $platform->request($embeddings, $textInput)->getContent();
+$vectors = $platform->request($embeddings, $textInput)->asVectors();
 
 dump($vectors[0]->getData()); // Array of float values
 ```
@@ -703,7 +703,7 @@ foreach ($inputs as $input) {
 }
 
 foreach ($responses as $response) {
-    echo $response->getContent().PHP_EOL;
+    echo $response->asText().PHP_EOL;
 }
 ```
 
@@ -822,7 +822,7 @@ $response = $platform->request($model, $image, [
     'task' => Task::OBJECT_DETECTION, // defining a task is mandatory for internal request & response handling
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
 ```
 
 #### Code Examples
@@ -867,7 +867,7 @@ $response = $platform->request($model, 'How many continents are there in the wor
     'task' => Task::Text2TextGeneration,
 ]);
 
-echo $response->getContent().PHP_EOL;
+echo $response->asText().PHP_EOL;
 ```
 
 #### Code Examples

diff --git a/examples/azure/audio-transcript.php b/examples/azure/audio-transcript.php
@@ -25,4 +25,4 @@
 
 $response = $platform->request($model, $file);
 
-echo $response->getContent().\PHP_EOL;
+echo $response->asText().\PHP_EOL;
diff --git a/examples/azure/embeddings.php b/examples/azure/embeddings.php
@@ -2,7 +2,6 @@
 
 use PhpLlm\LlmChain\Platform\Bridge\Azure\OpenAI\PlatformFactory;
 use PhpLlm\LlmChain\Platform\Bridge\OpenAI\Embeddings;
-use PhpLlm\LlmChain\Platform\Response\VectorResponse;
 use Symfony\Component\Dotenv\Dotenv;
 
 require_once dirname(__DIR__, 2).'/vendor/autoload.php';
@@ -28,6 +27,4 @@
     country was very peaceful and prosperous. The people lived happily ever after.
     TEXT);
 
-assert($response instanceof VectorResponse);
-
-echo 'Dimensions: '.$response->getContent()[0]->getDimensions().\PHP_EOL;
+echo 'Dimensions: '.$response->asVectors()[0]->getDimensions().\PHP_EOL;
diff --git a/examples/huggingface/audio-classification.php b/examples/huggingface/audio-classification.php
@@ -22,4 +22,4 @@
     'task' => Task::AUDIO_CLASSIFICATION,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
diff --git a/examples/huggingface/automatic-speech-recognition.php b/examples/huggingface/automatic-speech-recognition.php
@@ -22,4 +22,4 @@
     'task' => Task::AUTOMATIC_SPEECH_RECOGNITION,
 ]);
 
-echo $response->getContent().\PHP_EOL;
+echo $response->asText().\PHP_EOL;
diff --git a/examples/huggingface/chat-completion.php b/examples/huggingface/chat-completion.php
@@ -23,4 +23,4 @@
     'task' => Task::CHAT_COMPLETION,
 ]);
 
-echo $response->getContent().\PHP_EOL;
+echo $response->asText().\PHP_EOL;
diff --git a/examples/huggingface/feature-extraction.php b/examples/huggingface/feature-extraction.php
@@ -3,7 +3,6 @@
 use PhpLlm\LlmChain\Platform\Bridge\HuggingFace\PlatformFactory;
 use PhpLlm\LlmChain\Platform\Bridge\HuggingFace\Task;
 use PhpLlm\LlmChain\Platform\Model;
-use PhpLlm\LlmChain\Platform\Response\VectorResponse;
 use Symfony\Component\Dotenv\Dotenv;
 
 require_once dirname(__DIR__, 2).'/vendor/autoload.php';
@@ -21,6 +20,4 @@
     'task' => Task::FEATURE_EXTRACTION,
 ]);
 
-assert($response instanceof VectorResponse);
-
-echo 'Dimensions: '.$response->getContent()[0]->getDimensions().\PHP_EOL;
+echo 'Dimensions: '.$response->asVectors()[0]->getDimensions().\PHP_EOL;
diff --git a/examples/huggingface/fill-mask.php b/examples/huggingface/fill-mask.php
@@ -20,4 +20,4 @@
     'task' => Task::FILL_MASK,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
diff --git a/examples/huggingface/image-classification.php b/examples/huggingface/image-classification.php
@@ -22,4 +22,4 @@
     'task' => Task::IMAGE_CLASSIFICATION,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
diff --git a/examples/huggingface/image-segmentation.php b/examples/huggingface/image-segmentation.php
@@ -22,4 +22,4 @@
     'task' => Task::IMAGE_SEGMENTATION,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
diff --git a/examples/huggingface/image-to-text.php b/examples/huggingface/image-to-text.php
@@ -22,4 +22,4 @@
     'task' => Task::IMAGE_TO_TEXT,
 ]);
 
-echo $response->getContent().\PHP_EOL;
+echo $response->asText().\PHP_EOL;
diff --git a/examples/huggingface/object-detection.php b/examples/huggingface/object-detection.php
@@ -22,4 +22,4 @@
     'task' => Task::OBJECT_DETECTION,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
diff --git a/examples/huggingface/question-answering.php b/examples/huggingface/question-answering.php
@@ -25,4 +25,4 @@
     'task' => Task::QUESTION_ANSWERING,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
diff --git a/examples/huggingface/sentence-similarity.php b/examples/huggingface/sentence-similarity.php
@@ -29,4 +29,4 @@
     'task' => Task::SENTENCE_SIMILARITY,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
diff --git a/examples/huggingface/summarization.php b/examples/huggingface/summarization.php
@@ -30,4 +30,4 @@
     'task' => Task::SUMMARIZATION,
 ]);
 
-echo $response->getContent().\PHP_EOL;
+echo $response->asText().\PHP_EOL;
diff --git a/examples/huggingface/table-question-answering.php b/examples/huggingface/table-question-answering.php
@@ -28,4 +28,4 @@
     'task' => Task::TABLE_QUESTION_ANSWERING,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
diff --git a/examples/huggingface/text-classification.php b/examples/huggingface/text-classification.php
@@ -20,4 +20,4 @@
     'task' => Task::TEXT_CLASSIFICATION,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
diff --git a/examples/huggingface/text-generation.php b/examples/huggingface/text-generation.php
@@ -20,4 +20,4 @@
     'task' => Task::TEXT_GENERATION,
 ]);
 
-echo $response->getContent().\PHP_EOL;
+echo $response->asText().\PHP_EOL;
diff --git a/examples/huggingface/text-to-image.php b/examples/huggingface/text-to-image.php
@@ -3,7 +3,6 @@
 use PhpLlm\LlmChain\Platform\Bridge\HuggingFace\PlatformFactory;
 use PhpLlm\LlmChain\Platform\Bridge\HuggingFace\Task;
 use PhpLlm\LlmChain\Platform\Model;
-use PhpLlm\LlmChain\Platform\Response\BinaryResponse;
 use Symfony\Component\Dotenv\Dotenv;
 
 require_once dirname(__DIR__, 2).'/vendor/autoload.php';
@@ -21,6 +20,4 @@
     'task' => Task::TEXT_TO_IMAGE,
 ]);
 
-assert($response instanceof BinaryResponse);
-
-echo $response->toBase64().\PHP_EOL;
+echo $response->asBase64().\PHP_EOL;
diff --git a/examples/huggingface/token-classification.php b/examples/huggingface/token-classification.php
@@ -20,4 +20,4 @@
     'task' => Task::TOKEN_CLASSIFICATION,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
diff --git a/examples/huggingface/translation.php b/examples/huggingface/translation.php
@@ -22,4 +22,4 @@
     'tgt_lang' => 'en',
 ]);
 
-echo $response->getContent().\PHP_EOL;
+echo $response->asText().\PHP_EOL;
diff --git a/examples/huggingface/zero-shot-classification.php b/examples/huggingface/zero-shot-classification.php
@@ -22,4 +22,4 @@
     'candidate_labels' => ['refund', 'legal', 'faq'],
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
diff --git a/examples/mistral/embeddings.php b/examples/mistral/embeddings.php
@@ -2,7 +2,6 @@
 
 use PhpLlm\LlmChain\Platform\Bridge\Mistral\Embeddings;
 use PhpLlm\LlmChain\Platform\Bridge\Mistral\PlatformFactory;
-use PhpLlm\LlmChain\Platform\Response\VectorResponse;
 use Symfony\Component\Dotenv\Dotenv;
 
 require_once dirname(__DIR__, 2).'/vendor/autoload.php';
@@ -23,6 +22,4 @@
     salt. The goal was to prevent deficiencies and promote better health in the population.
     TEXT);
 
-assert($response instanceof VectorResponse);
-
-echo 'Dimensions: '.$response->getContent()[0]->getDimensions().\PHP_EOL;
+echo 'Dimensions: '.$response->asVectors()[0]->getDimensions().\PHP_EOL;
diff --git a/examples/openai/audio-transcript.php b/examples/openai/audio-transcript.php
@@ -19,4 +19,4 @@
 
 $response = $platform->request($model, $file);
 
-echo $response->getContent().\PHP_EOL;
+echo $response->asText().\PHP_EOL;
diff --git a/examples/openai/embeddings.php b/examples/openai/embeddings.php
@@ -2,7 +2,6 @@
 
 use PhpLlm\LlmChain\Platform\Bridge\OpenAI\Embeddings;
 use PhpLlm\LlmChain\Platform\Bridge\OpenAI\PlatformFactory;
-use PhpLlm\LlmChain\Platform\Response\VectorResponse;
 use Symfony\Component\Dotenv\Dotenv;
 
 require_once dirname(__DIR__, 2).'/vendor/autoload.php';
@@ -22,6 +21,4 @@
     country was very peaceful and prosperous. The people lived happily ever after.
     TEXT);
 
-assert($response instanceof VectorResponse);
-
-echo 'Dimensions: '.$response->getContent()[0]->getDimensions().\PHP_EOL;
+echo 'Dimensions: '.$response->asVectors()[0]->getDimensions().\PHP_EOL;
diff --git a/examples/openai/image-output-dall-e-2.php b/examples/openai/image-output-dall-e-2.php
@@ -23,6 +23,6 @@
     ],
 );
 
-foreach ($response->getContent() as $index => $image) {
+foreach ($response->getResponse()->getContent() as $index => $image) {
     echo 'Image '.$index.': '.$image->url.\PHP_EOL;
 }
diff --git a/examples/openai/image-output-dall-e-3.php b/examples/openai/image-output-dall-e-3.php
@@ -21,7 +21,7 @@
     options: [
         'response_format' => 'url', // Generate response as URL
     ],
-);
+)->getResponse();
 
 assert($response instanceof ImageResponse);
 

diff --git a/examples/parallel-chat-gpt.php b/examples/parallel-chat-gpt.php
@@ -34,5 +34,5 @@
 
 echo 'Waiting for the responses ...'.\PHP_EOL;
 foreach ($responses as $response) {
-    echo 'Next Letter: '.$response->getContent().\PHP_EOL;
+    echo 'Next Letter: '.$response->asText().\PHP_EOL;
 }
diff --git a/examples/parallel-embeddings.php b/examples/parallel-embeddings.php
@@ -4,7 +4,6 @@
 
 use PhpLlm\LlmChain\Platform\Bridge\OpenAI\Embeddings;
 use PhpLlm\LlmChain\Platform\Bridge\OpenAI\PlatformFactory;
-use PhpLlm\LlmChain\Platform\Response\VectorResponse;
 use Symfony\Component\Dotenv\Dotenv;
 
 require_once dirname(__DIR__).'/vendor/autoload.php';
@@ -29,6 +28,5 @@
 
 echo 'Waiting for the responses ...'.\PHP_EOL;
 foreach ($responses as $response) {
-    assert($response instanceof VectorResponse);
-    echo 'Dimensions: '.$response->getContent()[0]->getDimensions().\PHP_EOL;
+    echo 'Dimensions: '.$response->asVectors()[0]->getDimensions().\PHP_EOL;
 }
diff --git a/examples/transformers/text-generation.php b/examples/transformers/text-generation.php
@@ -23,4 +23,4 @@
     'task' => Task::Text2TextGeneration,
 ]);
 
-echo $response->getContent().\PHP_EOL;
+echo $response->asText().\PHP_EOL;
diff --git a/examples/voyage/embeddings.php b/examples/voyage/embeddings.php
@@ -2,7 +2,6 @@
 
 use PhpLlm\LlmChain\Platform\Bridge\Voyage\PlatformFactory;
 use PhpLlm\LlmChain\Platform\Bridge\Voyage\Voyage;
-use PhpLlm\LlmChain\Platform\Response\VectorResponse;
 use Symfony\Component\Dotenv\Dotenv;
 
 require_once dirname(__DIR__, 2).'/vendor/autoload.php';
@@ -22,6 +21,4 @@
     country was very peaceful and prosperous. The people lived happily ever after.
     TEXT);
 
-assert($response instanceof VectorResponse);
-
-echo 'Dimensions: '.$response->getContent()[0]->getDimensions().\PHP_EOL;
+echo 'Dimensions: '.$response->asVectors()[0]->getDimensions().\PHP_EOL;
diff --git a/src/Chain/Chain.php b/src/Chain/Chain.php
@@ -11,7 +11,6 @@
 use PhpLlm\LlmChain\Platform\Message\MessageBagInterface;
 use PhpLlm\LlmChain\Platform\Model;
 use PhpLlm\LlmChain\Platform\PlatformInterface;
-use PhpLlm\LlmChain\Platform\Response\AsyncResponse;
 use PhpLlm\LlmChain\Platform\Response\ResponseInterface;
 use Psr\Log\LoggerInterface;
 use Psr\Log\NullLogger;
@@ -69,11 +68,7 @@ public function call(MessageBagInterface $messages, array $options = []): Respon
         }
 
         try {
-            $response = $this->platform->request($model, $messages, $options);
-
-            if ($response instanceof AsyncResponse) {
-                $response = $response->unwrap();
-            }
+            $response = $this->platform->request($model, $messages, $options)->getResponse();
         } catch (ClientExceptionInterface $e) {
             $message = $e->getMessage();
             $content = $e->getResponse()->toArray(false);

diff --git a/src/Chain/Toolbox/Tool/SimilaritySearch.php b/src/Chain/Toolbox/Tool/SimilaritySearch.php
@@ -7,7 +7,6 @@
 use PhpLlm\LlmChain\Chain\Toolbox\Attribute\AsTool;
 use PhpLlm\LlmChain\Platform\Model;
 use PhpLlm\LlmChain\Platform\PlatformInterface;
-use PhpLlm\LlmChain\Platform\Vector\Vector;
 use PhpLlm\LlmChain\Store\Document\VectorDocument;
 use PhpLlm\LlmChain\Store\VectorStoreInterface;
 
@@ -34,8 +33,7 @@ public function __construct(
      */
     public function __invoke(string $searchTerm): string
     {
-        /** @var Vector[] $vectors */
-        $vectors = $this->platform->request($this->model, $searchTerm)->getContent();
+        $vectors = $this->platform->request($this->model, $searchTerm)->asVectors();
         $this->usedDocuments = $this->vectorStore->query($vectors[0]);
 
         if (0 === \count($this->usedDocuments)) {

diff --git a/src/Platform/Bridge/Bedrock/Anthropic/ClaudeHandler.php b/src/Platform/Bridge/Bedrock/Anthropic/ClaudeHandler.php
@@ -11,7 +11,6 @@
 use PhpLlm\LlmChain\Platform\Bridge\Bedrock\BedrockModelClient;
 use PhpLlm\LlmChain\Platform\Exception\RuntimeException;
 use PhpLlm\LlmChain\Platform\Model;
-use PhpLlm\LlmChain\Platform\Response\ResponseInterface as LlmResponse;
 use PhpLlm\LlmChain\Platform\Response\TextResponse;
 use PhpLlm\LlmChain\Platform\Response\ToolCall;
 use PhpLlm\LlmChain\Platform\Response\ToolCallResponse;
@@ -32,7 +31,7 @@ public function supports(Model $model): bool
         return $model instanceof Claude;
     }
 
-    public function request(Model $model, array|string $payload, array $options = []): LlmResponse
+    public function request(Model $model, array|string $payload, array $options = []): InvokeModelResponse
     {
         unset($payload['model']);
 
@@ -50,12 +49,10 @@ public function request(Model $model, array|string $payload, array $options = []
             'body' => json_encode(array_merge($options, $payload), \JSON_THROW_ON_ERROR),
         ];
 
-        $invokeModelResponse = $this->bedrockRuntimeClient->invokeModel(new InvokeModelRequest($request));
-
-        return $this->convert($invokeModelResponse);
+        return $this->bedrockRuntimeClient->invokeModel(new InvokeModelRequest($request));
     }
 
-    public function convert(InvokeModelResponse $bedrockResponse): LlmResponse
+    public function convert(InvokeModelResponse $bedrockResponse): ToolCallResponse|TextResponse
     {
         $data = json_decode($bedrockResponse->getBody(), true, 512, \JSON_THROW_ON_ERROR);
 

diff --git a/src/Platform/Bridge/Bedrock/BedrockModelClient.php b/src/Platform/Bridge/Bedrock/BedrockModelClient.php
@@ -4,8 +4,9 @@
 
 namespace PhpLlm\LlmChain\Platform\Bridge\Bedrock;
 
+use AsyncAws\BedrockRuntime\Result\InvokeModelResponse;
 use PhpLlm\LlmChain\Platform\Model;
-use PhpLlm\LlmChain\Platform\Response\ResponseInterface as LlmResponse;
+use PhpLlm\LlmChain\Platform\Response\ResponseInterface;
 
 /**
  * @author Björn Altmann
@@ -18,5 +19,7 @@ public function supports(Model $model): bool;
      * @param array<mixed>|string  $payload
      * @param array<string, mixed> $options
      */
-    public function request(Model $model, array|string $payload, array $options = []): LlmResponse;
+    public function request(Model $model, array|string $payload, array $options = []): InvokeModelResponse;
+
+    public function convert(InvokeModelResponse $bedrockResponse): ResponseInterface;
 }
Original file line number	Diff line number	Diff line change
Expand Up		@@ -25,4 +25,4 @@

		$response = $platform->request($model, $file);

		echo $response->getContent().\PHP_EOL;
		echo $response->asText().\PHP_EOL;
Original file line number	Diff line number	Diff line change
Expand Up		@@ -19,4 +19,4 @@

		$response = $platform->request($model, $file);

		echo $response->getContent().\PHP_EOL;
		echo $response->asText().\PHP_EOL;