PHP SDK 集成教程

# 使用 Composer 安装
composer require n1n/llm-api-php

# 或者在 composer.json 中添加
{
    "require": {
        "n1n/llm-api-php": "^1.0"
    }
}

# 如果使用 Guzzle HTTP 客户端
composer require guzzlehttp/guzzle

<?php
require_once 'vendor/autoload.php';

use N1N\LLMClient;
use N1N\Models\ChatMessage;

// 初始化客户端
$client = new LLMClient([
    'api_key' => 'your-api-key',
    'base_url' => 'https://api.n1n.ai/v1'
]);

try {
    // 基础对话
    $response = $client->chat()->create([
        'model' => 'gpt-3.5-turbo',
        'messages' => [
            ['role' => 'system', 'content' => '你是一个有帮助的助手'],
            ['role' => 'user', 'content' => '介绍一下PHP语言']
        ],
        'temperature' => 0.7,
        'max_tokens' => 500
    ]);
    
    echo $response->choices[0]->message->content;
    
    // 使用消息对象
    $messages = [
        new ChatMessage('system', '你是一个PHP专家'),
        new ChatMessage('user', '如何使用PHP连接数据库？')
    ];
    
    $response = $client->chat()->create([
        'model' => 'gpt-4o-mini',
        'messages' => $messages
    ]);
    
    // 获取使用统计
    echo "使用Token数: " . $response->usage->total_tokens . "\n";
    echo "成本: $" . $response->usage->cost . "\n";
    
} catch (Exception $e) {
    echo "错误: " . $e->getMessage();
}

<?php
use N1N\LLMClient;

$client = new LLMClient(['api_key' => 'your-api-key']);

// 流式响应
$stream = $client->chat()->createStream([
    'model' => 'gpt-3.5-turbo',
    'messages' => [
        ['role' => 'user', 'content' => '写一个长篇故事']
    ],
    'stream' => true
]);

// 处理流式数据
foreach ($stream as $chunk) {
    if (isset($chunk->choices[0]->delta->content)) {
        echo $chunk->choices[0]->delta->content;
        ob_flush(); // 立即输出到浏览器
        flush();
    }
}

// 使用回调处理流
$client->chat()->streamWithCallback(
    [
        'model' => 'gpt-3.5-turbo',
        'messages' => [['role' => 'user', 'content' => '你好']]
    ],
    function($chunk) {
        // 处理每个数据块
        if ($content = $chunk->choices[0]->delta->content ?? null) {
            echo $content;
        }
    },
    function($error) {
        // 错误处理
        echo "流错误: " . $error->getMessage();
    }
);