API 文档中心

Content-Type: application/json

复制

curl -X POST http://localhost:5000/api/request.php \
  -H 'Content-Type: application/json' \
  -d '{
    "website_id": "你的website_id",
    "provider": "deepseek",
    "model": "deepseek-chat",
    "messages": [
      {"role": "system", "content": "你是一个专业的AI助手"},
      {"role": "user", "content": "你好，请介绍一下你自己"}
    ],
    "temperature": 0.7,
    "max_tokens": 2000
  }'

POST https://agentapi.baidu.com/assistant/getAnswer?appId={appId}&secretKey={secretKey}
Content-Type: application/json

{
  "message": {
    "content": {
      "type": "text",
      "value": { "showText": "用户消息内容" }
    }
  },
  "source": "openapi",
  "from": "openapi",
  "openId": "openapi"
}

curl http://localhost:5000/api/keys.php

curl -X POST http://localhost:5000/api/keys.php \ -H 'Content-Type: application/json' \ -d '{ "key_name": "生产环境Key", "provider": "deepseek", "api_key": "sk-xxxxxxxxxxxx", "daily_limit": 100, "remark": "用于生产环境的DeepSeek API Key" }'

curl -X POST http://localhost:5000/api/keys.php \ -H 'Content-Type: application/json' \ -d '{ "key_name": "客服智能体", "provider": "baidu", "app_id": "your-app-id", "secret_key": "your-secret-key", "open_id": "user_001", "source": "my_website", "daily_limit": 50, "remark": "百度文心客服智能体" }'

curl -X PUT http://localhost:5000/api/keys.php/69f0a2562ff92 \ -H 'Content-Type: application/json' \ -d '{ "key_name": "更新后的名称", "status": "inactive", "daily_limit": 200 }'

curl -X DELETE http://localhost:5000/api/keys.php/69f0a2562ff92

curl -X POST http://localhost:5000/api/websites.php \ -H 'Content-Type: application/json' \ -d '{ "website_name": "我的博客", "website_url": "https://myblog.com", "api_key_id": "69f0a2562ff92", "remark": "个人博客网站" }'

curl http://localhost:5000/api/statistics.php?range=today

curl "http://localhost:5000/api/statistics.php?website_id=69f0a25a8b73d&range=today"

复制 const API_BASE = 'http://localhost:5000'; class DeepSeekClient { constructor(websiteId) { this.websiteId = websiteId; } async chat(messages, options = {}) { const response = await fetch(`${API_BASE}/api/request.php`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ website_id: this.websiteId, model: options.model || 'deepseek-chat', messages: messages, temperature: options.temperature || 0.7, max_tokens: options.max_tokens || 2000 }) }); if (!response.ok) { throw new Error(`API请求失败: ${response.status}`); } const data = await response.json(); return data.choices[0].message.content; } async streamChat(messages, onChunk, options = {}) { // 流式响应示例 const response = await fetch(`${API_BASE}/api/request.php`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ website_id: this.websiteId, model: options.model || 'deepseek-chat', messages: messages, stream: true }) }); const reader = response.body.getReader(); const decoder = new TextDecoder(); while (true) { const { done, value } = await reader.read(); if (done) break; const chunk = decoder.decode(value); onChunk(chunk); } } } // 使用示例 const client = new DeepSeekClient('69f0a25a8b73d'); async function main() { try { const response = await client.chat([ { role: 'system', content: '你是一个专业的AI助手' }, { role: 'user', content: '请帮我写一首关于春天的诗' } ]); console.log('AI回复:', response); } catch (error) { console.error('错误:', error); } } main();

复制 import requests import json from typing import List, Dict, Optional class DeepSeekClient: def __init__(self, base_url: str, website_id: str): self.base_url = base_url self.website_id = website_id def chat( self, messages: List[Dict], model: str = "deepseek-chat", temperature: float = 0.7, max_tokens: int = 2000 ) -> str: """发送聊天请求""" url = f"{self.base_url}/api/request.php" headers = {'Content-Type': 'application/json'} payload = { 'website_id': self.website_id, 'model': model, 'messages': messages, 'temperature': temperature, 'max_tokens': max_tokens } response = requests.post(url, headers=headers, json=payload) if response.status_code != 200: raise Exception(f"API请求失败: {response.status_code}") data = response.json() return data['choices'][0]['message']['content'] def stream_chat(self, messages: List[Dict], model: str = "deepseek-chat"): """流式聊天（示例）""" url = f"{self.base_url}/api/request.php" headers = {'Content-Type': 'application/json'} payload = { 'website_id': self.website_id, 'model': model, 'messages': messages, 'stream': True } response = requests.post(url, headers=headers, json=payload, stream=True) for line in response.iter_lines(): if line: yield line.decode('utf-8') # 使用示例 def main(): client = DeepSeekClient( base_url='http://localhost:5000', website_id='69f0a25a8b73d' ) try: messages = [ { 'role': 'system', 'content': '你是一个专业的AI助手' }, { 'role': 'user', 'content': '请帮我写一首关于春天的诗' } ] response = client.chat(messages) print(f"AI回复: {response}") # 流式响应示例 # for chunk in client.stream_chat(messages): # print(chunk, end='') except Exception as e: print(f"错误: {e}") if __name__ == "__main__": main()

复制 import { useState, useCallback } from 'react'; const API_BASE = 'http://localhost:5000'; export function useDeepSeek(websiteId) { const [loading, setLoading] = useState(false); const [error, setError] = useState(null); const chat = useCallback(async (messages, options = {}) => { setLoading(true); setError(null); try { const response = await fetch(`${API_BASE}/api/request.php`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ website_id: websiteId, model: options.model || 'deepseek-chat', messages: messages, temperature: options.temperature || 0.7, max_tokens: options.max_tokens || 2000 }) }); const data = await response.json(); if (!response.ok) { throw new Error(data.message || '请求失败'); } return data.choices[0].message.content; } catch (err) { setError(err.message); throw err; } finally { setLoading(false); } }, [websiteId]); return { chat, loading, error }; } // 组件使用示例 function ChatComponent() { const [messages, setMessages] = useState([]); const [input, setInput] = useState(''); const { chat, loading, error } = useDeepSeek('69f0a25a8b73d'); const handleSend = async () => { if (!input.trim()) return; const newMessages = [ ...messages, { role: 'user', content: input } ]; setMessages(newMessages); setInput(''); try { const response = await chat(newMessages); setMessages([ ...newMessages, { role: 'assistant', content: response } ]); } catch (err) { console.error('发送失败:', err); } }; return ( ); }

复制 <?php /** * DeepSeek 中台 PHP 客户端 * 支持普通请求、流式请求、多轮对话、错误重试 */ class DeepSeekClient { private string $baseUrl; private string $websiteId; private int $timeout; private int $maxRetries; public function __construct( string $baseUrl = 'http://localhost:5000', string $websiteId = '', int $timeout = 30, int $maxRetries = 2 ) { $this->baseUrl = rtrim($baseUrl, '/'); $this->websiteId = $websiteId; $this->timeout = $timeout; $this->maxRetries = $maxRetries; } /** * 发送聊天请求 * * @param array $messages 对话消息数组 * @param array $options 可选参数 (model, temperature, max_tokens) * @return array DeepSeek API 原始响应 * @throws Exception */ public function chat(array $messages, array $options = []): array { $payload = [ 'website_id' => $this->websiteId, 'model' => $options['model'] ?? 'deepseek-chat', 'messages' => $messages, 'temperature' => $options['temperature'] ?? 0.7, 'max_tokens' => $options['max_tokens'] ?? 2000, ]; return $this->request('/api/request.php', $payload); } /** * 快速单轮对话 * * @param string $question 用户提问内容 * @param string $system 系统提示词（可选） * @param array $options 可选参数 * @return string AI 回复文本 */ public function ask(string $question, string $system = '', array $options = []): string { $messages = []; if ($system !== '') { $messages[] = ['role' => 'system', 'content' => $system]; } $messages[] = ['role' => 'user', 'content' => $question]; $result = $this->chat($messages, $options); return $result['choices'][0]['message']['content'] ?? ''; } /** * 流式聊天（SSE） * 逐块返回数据，适合打字机效果 * * @param array $messages 对话消息数组 * @param callable $onChunk 每收到一块数据时的回调函数 * @param array $options 可选参数 * @return void */ public function streamChat(array $messages, callable $onChunk, array $options = []): void { $payload = [ 'website_id' => $this->websiteId, 'model' => $options['model'] ?? 'deepseek-chat', 'messages' => $messages, 'temperature' => $options['temperature'] ?? 0.7, 'max_tokens' => $options['max_tokens'] ?? 2000, 'stream' => true, ]; $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => $this->baseUrl . '/api/request.php', CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode($payload), CURLOPT_HTTPHEADER => ['Content-Type: application/json'], CURLOPT_TIMEOUT => $this->timeout, CURLOPT_WRITEFUNCTION => function ($ch, $data) use ($onChunk) { $onChunk($data); return strlen($data); }, ]); curl_exec($ch); curl_close($ch); } /** * 多轮对话上下文管理器 * * @return Conversation */ public function conversation(): Conversation { return new Conversation($this); } /** * 获取网站统计数据 * * @param string $range 时间范围: today/yesterday/this_week/this_month * @return array */ public function getStatistics(string $range = 'today'): array { $url = "/api/statistics.php?website_id={$this->websiteId}&range={$range}"; return $this->getRequest($url); } /* ─── 内部方法 ────────────────────────────── */ private function request(string $endpoint, array $payload): array { $attempt = 0; $lastError = null; while ($attempt <= $this->maxRetries) { try { $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => $this->baseUrl . $endpoint, CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode($payload), CURLOPT_HTTPHEADER => ['Content-Type: application/json'], CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => $this->timeout, ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); $curlErr = curl_error($ch); curl_close($ch); if ($curlErr) { throw new Exception("cURL 错误: {$curlErr}"); } $data = json_decode($response, true); if (json_last_error() !== JSON_ERROR_NONE) { throw new Exception('响应 JSON 解析失败'); } if ($httpCode >= 400) { $msg = $data['message'] ?? "HTTP {$httpCode}"; throw new Exception($msg); } return $data; } catch (Exception $e) { $lastError = $e; $attempt++; if ($attempt <= $this->maxRetries) { usleep(500000); // 等待 0.5 秒后重试 } } } throw $lastError; } private function getRequest(string $url): array { $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => $this->baseUrl . $url, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => $this->timeout, ]); $response = curl_exec($ch); curl_close($ch); return json_decode($response, true) ?? []; } } /** * 多轮对话上下文管理 */ class Conversation { private DeepSeekClient $client; private array $messages = []; public function __construct(DeepSeekClient $client) { $this->client = $client; } /** * 设置系统提示词 */ public function system(string $content): self { $this->messages[] = ['role' => 'system', 'content' => $content]; return $this; } /** * 用户发言 */ public function user(string $content): self { $this->messages[] = ['role' => 'user', 'content' => $content]; return $this; } /** * 发送并获取AI回复（自动追加到上下文） */ public function send(array $options = []): string { $result = $this->client->chat($this->messages, $options); $reply = $result['choices'][0]['message']['content'] ?? ''; // 将 AI 回复追加到上下文中 $this->messages[] = ['role' => 'assistant', 'content' => $reply]; return $reply; } /** * 获取完整对话历史 */ public function getHistory(): array { return $this->messages; } /** * 清空对话历史 */ public function clear(): self { $this->messages = []; return $this; } } // ═══════════════════════════════════════ // 使用示例 // ═══════════════════════════════════════ $client = new DeepSeekClient( baseUrl: 'http://localhost:5000', websiteId: '69f0a25a8b73d', timeout: 30, maxRetries: 2 ); // ── 示例 1：快速单轮对话 ── echo "=== 示例 1：快速单轮对话 ===\n"; $answer = $client->ask('PHP 8.3 有什么新特性？', '你是一个PHP专家'); echo "AI: {$answer}\n\n"; // ── 示例 2：多轮对话 ── echo "=== 示例 2：多轮对话 ===\n"; $conv = $client->conversation(); $conv->system('你是一个专业的技术顾问，回答简洁明了'); $reply1 = $conv->user('什么是REST API？')->send(); echo "AI: {$reply1}\n"; $reply2 = $conv->user('如何在PHP中实现？')->send(); echo "AI: {$reply2}\n"; $reply3 = $conv->user('能给一个完整的代码示例吗？')->send(); echo "AI: {$reply3}\n\n"; // ── 示例 3：流式响应（打字机效果） ── echo "=== 示例 3：流式响应 ===\n"; $client->streamChat( [['role' => 'user', 'content' => '写一首短诗']], function (string $chunk) { echo $chunk; // 实时输出每一块数据 ob_flush(); flush(); } ); echo "\n\n"; // ── 示例 4：自定义参数 ── echo "=== 示例 4：自定义参数 ===\n"; $result = $client->chat( [['role' => 'user', 'content' => '解释量子计算']], [ 'model' => 'deepseek-reasoner', // 使用推理模型 'temperature' => 0.3, // 更确定性的输出 'max_tokens' => 4000, // 更长的回复 ] ); echo "模型: " . ($result['model'] ?? '') . "\n"; echo "Token用量: " . json_encode($result['usage'] ?? []) . "\n"; echo "回复: " . ($result['choices'][0]['message']['content'] ?? '') . "\n\n"; // ── 示例 5：查看统计数据 ── echo "=== 示例 5：查看统计数据 ===\n"; $stats = $client->getStatistics('today'); echo "今日统计: " . json_encode($stats, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT) . "\n"; ?>

复制 <?php // ── app/Services/DeepSeekService.php ── namespace App\Services; use Illuminate\Support\Facades\Http; use Illuminate\Support\Facades\Log; class DeepSeekService { private string $baseUrl; private string $websiteId; public function __construct() { $this->baseUrl = config('deepseek.base_url', 'http://localhost:5000'); $this->websiteId = config('deepseek.website_id'); } /** * 发送聊天请求 */ public function chat(array $messages, array $options = []): array { $payload = [ 'website_id' => $this->websiteId, 'model' => $options['model'] ?? 'deepseek-chat', 'messages' => $messages, 'temperature' => $options['temperature'] ?? 0.7, 'max_tokens' => $options['max_tokens'] ?? 2000, ]; try { $response = Http::timeout(30) ->withHeaders(['Content-Type' => 'application/json']) ->post("{$this->baseUrl}/api/request.php", $payload); if ($response->failed()) { Log::error('DeepSeek API 请求失败', [ 'status' => $response->status(), 'body' => $response->body(), ]); throw new \Exception('DeepSeek API 请求失败: ' . $response->status()); } return $response->json(); } catch (\Exception $e) { Log::error('DeepSeek 调用异常', ['message' => $e->getMessage()]); throw $e; } } /** * 快速提问 */ public function ask(string $question, string $system = ''): string { $messages = []; if ($system) { $messages[] = ['role' => 'system', 'content' => $system]; } $messages[] = ['role' => 'user', 'content' => $question]; $result = $this->chat($messages); return $result['choices'][0]['message']['content'] ?? ''; } } // ── config/deepseek.php ── return [ 'base_url' => env('DEEPSEEK_BASE_URL', 'http://localhost:5000'), 'website_id' => env('DEEPSEEK_WEBSITE_ID', ''), ]; // ── .env ── // DEEPSEEK_BASE_URL=http://localhost:5000 // DEEPSEEK_WEBSITE_ID=69f0a25a8b73d // ── app/Http/Controllers/ChatController.php ── namespace App\Http\Controllers; use App\Services\DeepSeekService; use Illuminate\Http\JsonResponse; use Illuminate\Http\Request; class ChatController extends Controller { public function __construct( private DeepSeekService $deepseek ) {} public function chat(Request $request): JsonResponse { $request->validate([ 'message' => 'required|string|max:5000', ]); $reply = $this->deepseek->ask( $request->input('message'), '你是一个友好的AI助手' ); return response()->json([ 'success' => true, 'reply' => $reply, ]); } } // ── routes/api.php ── // Route::post('/chat', [ChatController::class, 'chat']); ?>

复制 <?php // ── app/service/DeepSeekService.php ── namespace app\service; use think\facade\Log; class DeepSeekService { protected string $baseUrl; protected string $websiteId; public function __construct() { $this->baseUrl = env('DEEPSEEK_BASE_URL', 'http://localhost:5000'); $this->websiteId = env('DEEPSEEK_WEBSITE_ID', ''); } /** * 发送聊天请求 */ public function chat(array $messages, array $options = []): array { $payload = [ 'website_id' => $this->websiteId, 'model' => $options['model'] ?? 'deepseek-chat', 'messages' => $messages, 'temperature' => $options['temperature'] ?? 0.7, 'max_tokens' => $options['max_tokens'] ?? 2000, ]; $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => $this->baseUrl . '/api/request.php', CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode($payload), CURLOPT_HTTPHEADER => ['Content-Type: application/json'], CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode($response, true); if ($httpCode >= 400) { Log::error('DeepSeek API 调用失败', [ 'code' => $httpCode, 'body' => $response, ]); throw new \Exception('DeepSeek API 调用失败'); } return $data; } /** * 快速提问 */ public function ask(string $question, string $system = ''): string { $messages = []; if ($system) { $messages[] = ['role' => 'system', 'content' => $system]; } $messages[] = ['role' => 'user', 'content' => $question]; $result = $this->chat($messages); return $result['choices'][0]['message']['content'] ?? ''; } } // ── app/controller/Chat.php ── namespace app\controller; use app\service\DeepSeekService; use think\Request; use think\facade\Config; class Chat { public function index(Request $request) { $data = $request->only(['message']); if (empty($data['message'])) { return json(['code' => 400, 'msg' => '消息不能为空']); } try { $service = new DeepSeekService(); $reply = $service->ask($data['message'], '你是一个友好的AI助手'); return json([ 'code' => 0, 'msg' => 'success', 'data' => ['reply' => $reply], ]); } catch (\Exception $e) { return json(['code' => 500, 'msg' => $e->getMessage()]); } } } // ── .env ── // DEEPSEEK_BASE_URL = http://localhost:5000 // DEEPSEEK_WEBSITE_ID = 69f0a25a8b73d ?>