/php-sdk-youdaoai

A third-party php sdk for youdao-ai. You can refer official site for more info.

Primary LanguagePHPApache License 2.0Apache-2.0

php-sdk-youdaoai

有道AI第三方PHP-SDK,目前维护者只有一人,出于项目需要与兴趣维护她。如果你有bug反馈欢迎提供issues,如果你对项目维护迭代有想法,也欢迎@leander

安装

  • composer安装
composer require leander/youdao-ai
  • 手动安装

你需要从release中选择稳定版本下载,并将sdk主文件require进项目源文件。

require "/youdao-ai/src/sdk.class.php";

// just call whatever you want easely
$sdk = new YoudaoAi();
$sdk->api_method();

如果你使用CodeIgniter,你可以将sdk文件夹释放到application/libraries/目录,创建SDK入口文件YoudaoAi.php:

require ‘YoudaoAi/sdk.class.php’;

之后,你可以在CodeIgniter的模型控制器中,通过如下方式调用接口api:

<?php
# ...controller or model method start...
$this->load->library(‘YoudaoAi’);
$this->youdaoai->api_method; //调用具体 API 函数
# ...controller or model method end...

配置

你应该创建/youdao-ai/src/conf.inc.php.example副本/youdao-ai/src/conf.inc.php:

cd youdao-ai
cp /src/conf.inc.php.example /src/conf.inc.php

配置项参照表如下:

名称 别名 默认值 版本支持 备注
应用参数
API_SERV api服务器 http://openapi.youdao.com/ ~1.0
APP_KEY 应用编号 ~1.0
SEC_KEY 应用密钥 ~1.0
HTTP参数
HTTP_TIMEOUT 超时时间 10 ~1.0 超过设定值(秒),超时失败
API_PATH 接口映射表 ~1.0 配置组,通常不需要修改

文档

请自行查阅官方文档,了解各接口作用:https://ai.youdao.com/docs/doc-trans-api.s#p01
我们对接口名进行了抽象映射,接口目录如下:

映射名 官方路径 别名 参数 描述 备注
trans api 自然语言翻译 ... ...
sti speechtransapi 语音翻译 ... ...
oti ocrtransapi ocr文档翻译 ... ...

其他说明