Merge pull request #3 from miroslaws8/develop

Add image creation

Author: miroslaws8

README.md

@@ -43,11 +43,11 @@ OPENAI_API_KEY=sk-*
 * Models
   * [List models](https://platform.openai.com/docs/api-reference/models/list)
   * [Retrieve model](https://platform.openai.com/docs/api-reference/models/retrieve)
-
+* Images
+  * [Create image](https://platform.openai.com/docs/api-reference/images/create)
 
 #### Coming soon:
 * Images
-  * Create image
   * Create image edit
 * Audio
   * Create transcription
@@ -79,6 +79,21 @@ $result->getChoices(); // Choices from OpenAI.
 
 ```
 
+#### Create image:
+
+```php
+$openAI = $this->container->make(\Itsimiro\OpenAI\Services\OpenAI::class);
+
+
+$result = $openAI->getDalle()->createImage(new CreateImageParameters(
+  'dog with a bone',
+  2,
+  responseFormat: ImageResponseFormatEnum::URL
+ ));
+
+$result->getImages(); // Generated images
+```
+
 #### See the [documentation](https://platform.openai.com/docs/api-reference) for more details on using OpenAI.
 
 ## Testing

composer.json

@@ -46,6 +46,13 @@
             "phpstan/extension-installer": true
         }
     },
-    "minimum-stability": "dev",
+    "extra": {
+        "laravel": {
+            "providers": [
+                "Itsimiro\\OpenAI\\Providers\\OpenaiServiceProvider"
+            ]
+        }
+    },
+    "minimum-stability": "stable",
     "prefer-stable": true
 }

src/Enum/ImageResponseFormatEnum.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Itsimiro\OpenAI\Enum;
+
+enum ImageResponseFormatEnum: string
+{
+    case URL = 'url';
+    case BASE64 = 'b64_json';
+}

src/Enum/ImageSizeEnum.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Itsimiro\OpenAI\Enum;
+
+enum ImageSizeEnum: string
+{
+    case SMALL = '256x256';
+    case MEDIUM = '512x512';
+    case LARGE = '1024x1024';
+}

src/Services/AIModels/Dalle.php

@@ -2,7 +2,21 @@
 
 namespace Itsimiro\OpenAI\Services\AIModels;
 
+use Itsimiro\OpenAI\Services\API\ApiService;
+use Itsimiro\OpenAI\Services\API\Results\CreateImageResult;
+use Itsimiro\OpenAI\Services\API\UrlService;
+use Itsimiro\OpenAI\Services\DataTransferObjects\CreateImageParameters;
+
 class Dalle
 {
+    public function __construct(private readonly ApiService $apiService, private readonly UrlService $urlService)
+    {}
 
+    public function createImage(CreateImageParameters $parameters): CreateImageResult
+    {
+        return $this->apiService->getResult(
+            $this->apiService->sendRequest('POST', $this->urlService->createImage(), $parameters->toArray()),
+            CreateImageResult::class
+        );
+    }
 }

src/Services/API/Results/BodyParameters.php renamed to src/Services/API/Constants/BodyParameters.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Itsimiro\OpenAI\Services\API\Results;
+namespace Itsimiro\OpenAI\Services\API\Constants;
 
 class BodyParameters
 {

src/Services/API/Constants/ImageBodyParameters.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Itsimiro\OpenAI\Services\API\Constants;
+
+class ImageBodyParameters
+{
+    public const CREATED = 'created';
+    public const DATA = 'data';
+    public const URL = 'url';
+    public const BASE64 = 'b64_json';
+}

src/Services/API/Results/ChatResult.php

@@ -2,8 +2,6 @@
 
 namespace Itsimiro\OpenAI\Services\API\Results;
 
-use Spatie\LaravelData\Data;
-
 class ChatResult extends CompletionResult implements ResultInterface
 {
 

src/Services/API/Results/CompletionResult.php

@@ -2,11 +2,23 @@
 
 namespace Itsimiro\OpenAI\Services\API\Results;
 
+use Itsimiro\OpenAI\Services\API\Constants\BodyParameters;
 use Spatie\LaravelData\Data;
+use Spatie\LaravelData\Attributes\Validation\ArrayType;
 
 class CompletionResult extends Data implements ResultInterface
 {
-    public function __construct(public array $result)
+    public function __construct(
+        #[ArrayType([
+            BodyParameters::ID,
+            BodyParameters::OBJECT,
+            BodyParameters::CREATED_AT,
+            BodyParameters::MODEL,
+            BodyParameters::CHOICES,
+            BodyParameters::USAGE
+        ])]
+        public array $result
+    )
     {}
 
     public function getId(): string

src/Services/API/Results/CreateImageResult.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Itsimiro\OpenAI\Services\API\Results;
+
+use Illuminate\Support\Arr;
+use Itsimiro\OpenAI\Services\API\Constants\ImageBodyParameters;
+use Itsimiro\OpenAI\Services\DataTransferObjects\Image;
+use Spatie\LaravelData\Attributes\Validation\ArrayType;
+use Spatie\LaravelData\Data;
+
+class CreateImageResult extends Data implements ResultInterface
+{
+    public function __construct(
+        #[ArrayType([
+            ImageBodyParameters::CREATED,
+            ImageBodyParameters::DATA,
+        ])]
+        public array $result
+    )
+    {}
+
+    public function getImages(): array
+    {
+        return array_map(
+            fn (array $image) => new Image($image),
+            Arr::get($this->result, ImageBodyParameters::DATA, [])
+        );
+    }
+
+    public function getCreatedDate()
+    {
+        return Arr::get($this->result, ImageBodyParameters::CREATED);
+    }
+}