jxx0410 / qingzhoushan-php

2.0.0 2026-09-16 02:18 UTC

Requires

• php: >=7.4
• ext-fileinfo: *
• ext-json: *
• guzzlehttp/guzzle: ^6.2 || ^7.0
• monolog/monolog: ^1.22 || ^2.0 || ^3.0
• pimple/pimple: ^3.0
• psr/simple-cache: ^1.0 || ^2.0 || ^3.0
• symfony/cache: ^3.3 || ^4.3 || ^5.0 || ^6.0
• symfony/event-dispatcher: ^4.3 || ^5.0 || ^6.0
• symfony/http-foundation: ^2.7 || ^3.0 || ^4.0 || ^5.0 || ^6.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.5.0
• mockery/mockery: ^1.2.3
• phpunit/phpunit: ^9.3

MIT

• jxx0410

• api
• sdk
• ai
• content-generation
• qingzhoushan

Published on Packagist.org on 2026-09-16 02:31 UTC

README

青州山 AI 内容生成平台的 PHP SDK，支持数字人、声音克隆、图片/视频/音乐生成、文案、内容分析、社交媒体管理等 API。

环境要求

• PHP >= 7.4
• ext-json, ext-fileinfo

安装

composer require jxx0410/qingzhoushan-php

快速开始

<?php

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

use Jxx0410\Qingzhoushan\Application;

$app = new Application([
    'app_id'     => 'your_app_id',
    'app_secret' => 'your_app_secret',
    'base_uri'   => 'https://api.aichs365.com',
]);

// 账户信息
$account = $app->user->account();

// 图片生成
$result = $app->image->create([
    'model' => 'seedream-5.0-pro',
    'prompt' => '一只可爱的猫咪',
    'size' => '2k',
    'ratio' => '1:1',
]);

// 只获取 data 字段
$data = $app->image->onlyData()->queryTask(['task_id' => 'your_task_id']);

// LLM 与传统 API 共用 base_uri
$chat = $app->llm->chatCompletions([
    'model'    => 'your_model',
    'messages' => [['role' => 'user', 'content' => '你好！']],
]);

响应数据

传统 API 默认返回接口完整响应：

$response = $app->image->queryTask(['task_id' => 'your_task_id']);
// ['success' => true, 'code' => 0, 'message' => 'ok', 'data' => [...], ...]

如果只需要业务数据，可使用 onlyData()。该开关只影响下一次请求，请求结束后会自动恢复默认行为：

$data = $app->image->onlyData()->queryTask(['task_id' => 'your_task_id']);

接口返回 success=false 或 HTTP 错误时会抛出异常，异常中保留完整响应。

服务列表

访问	说明
$app->user	账户信息
$app->tool	抖音/知乎热搜
$app->digitalHuman	数字人训练/合成
$app->digitalVoice	声音克隆/合成
$app->image	图片生成
$app->video	视频生成
$app->music	音乐生成(Suno)
$app->copywriting	智能文案
$app->mediaProcess	音视频处理
$app->analysis	内容分析
$app->text	文本管理
$app->socialAccount	社媒账号
$app->socialPost	社媒帖子
$app->socialComment	社媒评论
$app->socialMisc	TikTok热门音乐
$app->socialCommerceVideoData	TikTok/抖音带货视频数据
$app->llm	LLM 大模型
$app->getServer()	Webhook 验签与接收

认证方式

• 传统 API (/api/v1/*)：自动使用 sign_ver 和毫秒时间戳进行 MD5 签名，Token 自动缓存/刷新
• LLM API (/v1/*)：使用 app_secret 作为 Bearer Token，并与传统 API 共用 base_uri

Hyperf 集成

php bin/hyperf.php vendor:publish jxx0410/qingzhoushan-php

use Jxx0410\Qingzhoushan\Application;
use Hyperf\Di\Annotation\Inject;

class MyController
{
    #[Inject]
    protected Application $app;
}

文档

• 中文 API 文档
• 中文快速开始
• Hyperf 集成

运行测试

composer test

License

MIT