edgaras/cloudflare-ai

This package is abandoned and no longer maintained. No replacement package was suggested.

Library for integrating and interacting with Cloudflare hosted AI models, providing tools for sending requests, managing model configurations, and processing responses.

1.0.0 2025-01-28 23:00 UTC

Requires

• php: >=8.1.0
• guzzlehttp/guzzle: ^7.9

Requires (Dev)

• phpunit/phpunit: ^11.5

MIT

• cloudflare
• artificial intelligence
• ai
• llama
• deepseek

README

Features

This library supports the following model categories:

• Text Generation.
• Text to Image.
• Text Embeddings.
• Translation.
• Summarization.

Requirements

PHP 8.1+

Installation

1. Use the library via Composer:

composer require edgaras/cloudflare-ai

1. Include the Composer autoloader:

require __DIR__ . '/vendor/autoload.php';

Usage

Text Generation

use Edgaras\CloudFlareAI\AI;
use Edgaras\CloudFlareAI\TextGeneration;

$accountId = "<YOUR-ACCOUNT-ID>";
$apiToken = "<YOUR-API-TOKEN>";
$modelName = "@cf/deepseek-ai/deepseek-math-7b-instruct"; // Define the model name

$config = new AI($accountId, $apiToken);
 
$textGeneration = new TextGeneration($config, $modelName);

$messages = [
    ["role" => "system", "content" => "You are a helpful assistant"],
    ["role" => "user", "content" => "2+2=?"], 
];
 
// Options
$options = [
    'temperature' => 0.7,
    'max_tokens' => 300,
    'top_p' => 0.8,
    'frequency_penalty' => 0.2,
    'presence_penalty' => 0.3,
];

// Run Model
$response = $textGeneration->run($messages, $options, 60);

Text to Image

use Edgaras\CloudFlareAI\AI;
use Edgaras\CloudFlareAI\TextToImage;

$accountId = "<YOUR-ACCOUNT-ID>";
$apiToken = "<YOUR-API-TOKEN>";
$modelName = "@cf/black-forest-labs/flux-1-schnell"; // Define the model name

$config = new AI($accountId, $apiToken);

$textToImage = new TextToImage($config, $modelName);

$prompt = "A futuristic cityscape at night with neon lights";
$options = [
    'negativePrompt' => "blurry, low resolution",
    'height' => 768,
    'width' => 1024,
    'numSteps' => 20,
    'guidance' => 7.5,
    'seed' => 12345678,
    'timeout' => 20.0,
    'maxAttempts' => 3,
];

// Generate the image
try {
    $result = $textToImage->generate($prompt, $options);

    if (isset($result['error'])) {
        echo "Error: " . $result['error'] . PHP_EOL;
        if (isset($result['response'])) {
            print_r($result['response']);
        }
    } else { 
        echo "<img src=\"data:image/jpeg;base64,{$result['result']['image']}\">";
    }
} catch (Exception $e) {
    echo "Exception: " . $e->getMessage() . PHP_EOL;
}

Text Embeddings

use Edgaras\CloudFlareAI\AI;
use Edgaras\CloudFlareAI\TextEmbeddings;

$accountId = "<YOUR-ACCOUNT-ID>";
$apiToken = "<YOUR-API-TOKEN>";
$modelName = "@cf/baai/bge-large-en-v1.5"; // Define the model name

$config = new AI($accountId, $apiToken);

$embeddings = new TextEmbeddings($config, $modelName);

// Provide the text to vectorize and the maximum timeout
$embed = $embeddings->embed("Text to vectorize", 60);  

Translation

use Edgaras\CloudFlareAI\AI;
use Edgaras\CloudFlareAI\Translation;

$accountId = "<YOUR-ACCOUNT-ID>";
$apiToken = "<YOUR-API-TOKEN>";
$modelName = "@cf/meta/m2m100-1.2b"; // Define the model name

$config = new AI($accountId, $apiToken);
 
$translation = new Translation($config, $modelName);
 
$text = "Hello, how are you?";
$sourceLang = "en";
$targetLang = "lt";

$response = $translation->translate($text, $targetLang, $sourceLang); // Optional parameters: $timeout, $maxAttempts
// echo $response['result']['translated_text'];
// Sveiki, kaip jūs jaučiatės?

Summarization

use Edgaras\CloudFlareAI\AI;
use Edgaras\CloudFlareAI\Summarization;

$accountId = "<YOUR-ACCOUNT-ID>";
$apiToken = "<YOUR-API-TOKEN>";
$modelName = "@cf/facebook/bart-large-cnn"; // Define the model name

$config = new AI($accountId, $apiToken);

$summarization = new Summarization($config, $modelName);

$inputText = "
Contrary to popular belief, Lorem Ipsum is not simply random text. It has roots in a piece of classical Latin literature from 45 BC, making it over 2000 years old. Richard McClintock, a Latin professor at Hampden-Sydney College in Virginia, looked up one of the more obscure Latin words, consectetur, from a Lorem Ipsum passage, and going through the cites of the word in classical literature, discovered the undoubtable source.
";
$maxLength = 100;  

$response = $summarization->summarize($inputText, $maxLength);
// echo $response['result']['summary'];
// Lorem Ipsum is a piece of classical Latin literature from 45 BC. The word consectetur is one of the more obscure Latin words.

Useful links

• Models.
• Find zone and account IDs.
• Create API token.