AIclinicalresearch/docs/02-通用能力层/01-LLM大模型网关/03-CloseAI集成指南.md

CloseAI髮<EFBFBD><EFBFBD>謖<EFBFBD>漉

*譁<EFBFBD>｡｣迚域悽<EFBFBD>? v1.0
*蛻帛ｻｺ譌･譛滂ｼ? 2025-11-09
逕ｨ騾費ｼ<EFBFBD> 騾夊ｿ④loseAI莉｣逅<EFBDA3>ｹｳ蜿ｰ隶ｿ髣ｮOpenAI GPT-5蜥靴laude-4.5
*騾ら畑蝨ｺ譎ｯ<EFBFBD>? AI譎ｺ閭ｽ譁<EFBDBD>鍵蜿梧ｨ｡蝙狗ｭ幃€峨€<E5B3A8>ｫ倩ｴｨ驥乗枚譛ｬ逕滓<E98095>

---

<EFBFBD>搭 CloseAI邂€莉?

莉€荵域弍CloseAI<EFBFBD>?

CloseAI譏ｯ荳€荳?API莉｣逅<EFBFBD>ｹｳ蜿ｰ*<2A>御ｸｺ荳ｭ蝗ｽ逕ｨ謌ｷ謠蝉ｾ帷ｨｳ螳夂噪OpenAI蜥靴laude API隶ｿ髣ｮ譛榊苅縲?

*譬ｸ蠢<EFBFBD>ｼ伜漢<EFBFBD>?

• 笨?蝗ｽ蜀<EFBDBD>峩霑橸ｼ梧裏髴€遘大ｭｦ荳顔ｽ<E9A194>
• 笨?荳€荳ｪAPI Key蜷梧慮隹<E685AE>畑OpenAI蜥靴laude
• 笨?蜈ｼ螳ｹOpenAI SDK譬<4B>㊥謗･蜿｣
• 笨?謾ｯ謖∵怙譁ｰ讓｡蝙具ｼ<E585B7>PT-5縲，laude-4.5<EFBFBD>?

*螳倡ｽ托ｼ? https://platform.openai-proxy.org

---

<EFBFBD>肌 驟咲ｽｮ菫｡諱ｯ

邇ｯ蠅<EFBFBD>序驥城<EFBFBD>鄂ｮ

# CloseAI扈滉ｸ€API Key
CLOSEAI_API_KEY=sk-cu0iepbXYGGx2jc7BqP6ogtSWmP6fk918qV3RUdtGC3Edlpo

# OpenAI遶ｯ轤ｹ
CLOSEAI_OPENAI_BASE_URL=https://api.openai-proxy.org/v1

# Claude遶ｯ轤ｹ
CLOSEAI_CLAUDE_BASE_URL=https://api.openai-proxy.org/anthropic

謾ｯ謖∫噪讓｡蝙?

讓｡蝙<EFBFBD>	Model ID	隸ｴ譏<EFBFBD>	騾ら畑蝨ｺ譎ｯ
GPT-5-Pro	gpt-5-pro	譛€譁ｰGPT-5 箝?	譁<EFBFBD>鍵邊ｾ蜃<EFBFBD>ｭ幃€峨€∝､肴揩謗ｨ逅?
GPT-4-Turbo	gpt-4-turbo-preview	GPT-4鬮俶€ｧ閭ｽ迚?	雍ｨ驥剰ｦ∵ｱるｫ倡噪莉ｻ蜉｡
GPT-3.5-Turbo	gpt-3.5-turbo	蠢ｫ騾溽ｻ乗ｵ守沿	邂€蜊穂ｻｻ蜉｡縲∵<EFBFBD>譛ｬ莨伜<EFBFBD>?
Claude-4.5-Sonnet	claude-sonnet-4-5-20250929	譛€譁ｰClaude 箝?	隨ｬ荳画婿莉ｲ陬√€∫ｻ捺桷蛹冶ｾ灘<EFBFBD>
Claude-3.5-Sonnet	claude-3-5-sonnet-20241022	Claude-3.5遞ｳ螳夂<EFBFBD>?	鬮倩ｴｨ驥乗枚譛ｬ逕滓<EFBFBD>?

---

<EFBFBD>捗 莉｣遐<EFBDA3>寔謌<E5AF94>

1. 螳芽｣<E88ABD>ｾ晁ｵ<E69981>

npm install openai

2. 蛻帛ｻｺLLM譛榊苅邀?

*譁<EFBFBD>ｻｶ菴咲ｽｮ<EFBFBD>? backend/src/common/llm/closeai.service.ts

import OpenAI from 'openai';
import { config } from '../../config/env';

export class CloseAIService {
  private openaiClient: OpenAI;
  private claudeClient: OpenAI;

  constructor() {
    // OpenAI螳｢謌ｷ遶ｯ<E981B6>磯€夊ｿ④loseAI<41>?
    this.openaiClient = new OpenAI({
      apiKey: config.closeaiApiKey,
      baseURL: config.closeaiOpenaiBaseUrl,
    });

    // Claude螳｢謌ｷ遶ｯ<E981B6>磯€夊ｿ④loseAI<41>?
    this.claudeClient = new OpenAI({
      apiKey: config.closeaiApiKey,
      baseURL: config.closeaiClaudeBaseUrl,
    });
  }

  /**
   * 隹<>畑GPT-5-Pro
   */
  async chatWithGPT5(prompt: string, systemPrompt?: string) {
    const messages: any[] = [];
    
    if (systemPrompt) {
      messages.push({ role: 'system', content: systemPrompt });
    }
    messages.push({ role: 'user', content: prompt });

    const response = await this.openaiClient.chat.completions.create({
      model: 'gpt-5-pro',
      messages,
      temperature: 0.3,
      max_tokens: 2000,
    });

    return {
      content: response.choices[0].message.content,
      usage: response.usage,
      model: 'gpt-5-pro',
    };
  }

  /**
   * 隹<>畑Claude-4.5-Sonnet
   */
  async chatWithClaude(prompt: string, systemPrompt?: string) {
    const messages: any[] = [];
    
    if (systemPrompt) {
      messages.push({ role: 'system', content: systemPrompt });
    }
    messages.push({ role: 'user', content: prompt });

    const response = await this.claudeClient.chat.completions.create({
      model: 'claude-sonnet-4-5-20250929',
      messages,
      temperature: 0.3,
      max_tokens: 2000,
    });

    return {
      content: response.choices[0].message.content,
      usage: response.usage,
      model: 'claude-sonnet-4-5-20250929',
    };
  }

  /**
   * 豬∝ｼ丞桃蠎費ｼ<E8B2BB>PT-5<>?
   */
  async *streamGPT5(prompt: string, systemPrompt?: string) {
    const messages: any[] = [];
    
    if (systemPrompt) {
      messages.push({ role: 'system', content: systemPrompt });
    }
    messages.push({ role: 'user', content: prompt });

    const stream = await this.openaiClient.chat.completions.create({
      model: 'gpt-5-pro',
      messages,
      temperature: 0.3,
      max_tokens: 2000,
      stream: true,
    });

    for await (const chunk of stream) {
      const content = chunk.choices[0]?.delta?.content || '';
      if (content) {
        yield content;
      }
    }
  }
}

3. 扈滉ｸ€LLM譛榊苅<E6A68A>亥性4荳ｪ讓｡蝙具ｼ<E585B7>

*譁<EFBFBD>ｻｶ菴咲ｽｮ<EFBFBD>? backend/src/common/llm/llm.service.ts

import OpenAI from 'openai';
import { config } from '../../config/env';

export type LLMProvider = 'deepseek' | 'gpt5' | 'claude' | 'qwen';

export class UnifiedLLMService {
  private deepseek: OpenAI;
  private gpt5: OpenAI;
  private claude: OpenAI;
  private qwen: OpenAI;

  constructor() {
    // DeepSeek (逶ｴ霑<EFBDB4>)
    this.deepseek = new OpenAI({
      apiKey: config.deepseekApiKey,
      baseURL: config.deepseekBaseUrl,
    });

    // GPT-5 (騾夊ｿ④loseAI)
    this.gpt5 = new OpenAI({
      apiKey: config.closeaiApiKey,
      baseURL: config.closeaiOpenaiBaseUrl,
    });

    // Claude (騾夊ｿ④loseAI)
    this.claude = new OpenAI({
      apiKey: config.closeaiApiKey,
      baseURL: config.closeaiClaudeBaseUrl,
    });

    // Qwen (螟<>畑)
    this.qwen = new OpenAI({
      apiKey: config.dashscopeApiKey,
      baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
    });
  }

  /**
   * 扈滉ｸ€隹<C280>畑謗･蜿｣
   */
  async chat(
    provider: LLMProvider,
    prompt: string,
    options?: {
      systemPrompt?: string;
      temperature?: number;
      maxTokens?: number;
    }
  ) {
    const { systemPrompt, temperature = 0.3, maxTokens = 2000 } = options || {};

    const messages: any[] = [];
    if (systemPrompt) {
      messages.push({ role: 'system', content: systemPrompt });
    }
    messages.push({ role: 'user', content: prompt });

    // 騾画叫讓｡蝙<EFBDA1>
    const modelMap = {
      deepseek: { client: this.deepseek, model: 'deepseek-chat' },
      gpt5: { client: this.gpt5, model: 'gpt-5-pro' },
      claude: { client: this.claude, model: 'claude-sonnet-4-5-20250929' },
      qwen: { client: this.qwen, model: 'qwen-max' },
    };

    const { client, model } = modelMap[provider];

    const response = await client.chat.completions.create({
      model,
      messages,
      temperature,
      max_tokens: maxTokens,
    });

    return {
      content: response.choices[0].message.content || '',
      usage: response.usage,
      model,
      provider,
    };
  }
}

---

<EFBFBD>識 AI譎ｺ閭ｽ譁<EFBDBD>鍵蠎皮畑蝨ｺ譎ｯ

蝨ｺ譎ｯ1<EFBFBD>壼曙讓｡蝙句ｯｹ豈皮ｭ幃€会ｼ域耳闕撰ｼ俄ｭ<EFBFBD>

*遲也払<EFBFBD>? DeepSeek<65>亥ｿｫ騾溷<E9A8BE>遲幢ｼ<E5B9A2> + GPT-5<>郁ｴｨ驥丞､肴<EFBDA4>ｸ<EFBFBD><EFBDB8>

export class LiteratureScreeningService {
  private llm: UnifiedLLMService;

  constructor() {
    this.llm = new UnifiedLLMService();
  }

  /**
   * 蜿梧ｨ｡蝙区枚迪ｮ遲幃€?
   */
  async screenLiterature(title: string, abstract: string, picoConfig: any) {
    const prompt = `
隸ｷ譬ｹ謐ｮ莉･荳輝ICO譬<EFBFBD>㊥<EFBFBD>悟愛譁ｭ霑咏ｯ<EFBFBD>枚迪ｮ譏ｯ蜷ｦ蠎碑ｯ･郤ｳ蜈･<EFBFBD><EFBFBD>

**PICO譬<4F>㊥<EFBFBD>?*
- Population: ${picoConfig.population}
- Intervention: ${picoConfig.intervention}
- Comparison: ${picoConfig.comparison}
- Outcome: ${picoConfig.outcome}

**譁<>鍵菫｡諱ｯ<E8ABB1>?*
譬<EFBFBD>｢假ｼ?{title}
鞫倩ｦ<EFBFBD>ｼ?{abstract}

隸ｷ霎灘<EFBFBD>JSON譬ｼ蠑擾ｼ?
{
  "decision": "include/exclude/uncertain",
  "reason": "蛻､譁ｭ逅<EFBDAD>罰",
  "confidence": 0.0-1.0
}
    `;

    // 蟷ｶ陦瑚ｰ<E7919A>畑荳､荳ｪ讓｡蝙<EFBDA1>
    const [deepseekResult, gpt5Result] = await Promise.all([
      this.llm.chat('deepseek', prompt),
      this.llm.chat('gpt5', prompt),
    ]);

    // 隗｣譫千ｻ捺棡
    const deepseekDecision = JSON.parse(deepseekResult.content);
    const gpt5Decision = JSON.parse(gpt5Result.content);

    // 螯よ棡荳､荳ｪ讓｡蝙倶ｸ€閾ｴ<E996BE>檎峩謗･驥<EFBDA5>ｺｳ
    if (deepseekDecision.decision === gpt5Decision.decision) {
      return {
        finalDecision: deepseekDecision.decision,
        consensus: 'high',
        models: [deepseekDecision, gpt5Decision],
      };
    }

    // 螯よ棡荳堺ｸ€閾ｴ<E996BE>瑚ｿ泌屓蜿梧婿諢剰ｧ<E589B0>ｼ悟ｾ<E6829F>ｺｺ蟾･螟肴<E89E9F>ｸ
    return {
      finalDecision: 'uncertain',
      consensus: 'low',
      models: [deepseekDecision, gpt5Decision],
      needManualReview: true,
    };
  }
}

蝨ｺ譎ｯ2<EFBFBD>壻ｸ画ｨ｡蝙句<EFBFBD>隸<EFBFBD>ｻｲ陬<EFBFBD>

*遲也払<EFBFBD>? 蠖謎ｸ､荳ｪ讓｡蝙句<E89D99>遯∵慮<E288B5>悟星逕ｨClaude菴應ｸｺ隨ｬ荳画婿莉ｲ陬?

async screenWithArbitration(title: string, abstract: string, picoConfig: any) {
  // 隨ｬ荳€霓ｮ<E99C93>壼曙讓｡蝙狗ｭ幃€?
  const initialScreen = await this.screenLiterature(title, abstract, picoConfig);

  // 螯よ棡荳€閾ｴ<E996BE>檎峩謗･霑泌屓
  if (initialScreen.consensus === 'high') {
    return initialScreen;
  }

  // 螯よ棡荳堺ｸ€閾ｴ<E996BE>悟星逕ｨClaude莉ｲ陬<EFBDB2>
  console.log('蜿梧ｨ｡蝙狗ｻ捺棡荳堺ｸ€閾ｴ<E996BE>悟星逕ｨClaude莉ｲ陬<EFBDB2>...');

  const claudeResult = await this.llm.chat('claude', prompt);
  const claudeDecision = JSON.parse(claudeResult.content);

  // 荳画ｨ｡蝙区兜逾?
  const decisions = [
    initialScreen.models[0].decision,
    initialScreen.models[1].decision,
    claudeDecision.decision,
  ];

  const voteCount = {
    include: decisions.filter(d => d === 'include').length,
    exclude: decisions.filter(d => d === 'exclude').length,
    uncertain: decisions.filter(d => d === 'uncertain').length,
  };

  // 螟壽焚蜀?
  const finalDecision = Object.keys(voteCount).reduce((a, b) => 
    voteCount[a] > voteCount[b] ? a : b
  );

  return {
    finalDecision,
    consensus: voteCount[finalDecision] >= 2 ? 'medium' : 'low',
    models: [...initialScreen.models, claudeDecision],
    arbitration: true,
  };
}

蝨ｺ譎ｯ3<EFBFBD>壽<EFBFBD>譛ｬ莨伜喧遲也<EFBFBD>?

*遲也払<EFBFBD>? 蜿ｪ蟇ｹ荳咲｡ｮ螳夂噪扈捺棡菴ｿ逕ｨGPT-5螟肴<E89E9F>ｸ

async screenWithCostOptimization(title: string, abstract: string, picoConfig: any) {
  // 隨ｬ荳€霓ｮ<E99C93>夂畑DeepSeek蠢ｫ騾溷<E9A8BE>遲幢ｼ井ｾｿ螳懶ｼ?
  const quickScreen = await this.llm.chat('deepseek', prompt);
  const quickDecision = JSON.parse(quickScreen.content);

  // 螯よ棡扈捺棡譏守｡ｮ<EFBDA1><EFBDAE>nclude謌貌xclude荳皮ｽｮ菫｡蠎ｦ>0.8<EFBFBD>会ｼ檎峩謗･驥<EFBFBD>ｺｳ
  if (quickDecision.confidence > 0.8 && quickDecision.decision !== 'uncertain') {
    return {
      finalDecision: quickDecision.decision,
      consensus: 'high',
      models: [quickDecision],
      costOptimized: true,
    };
  }

  // 蜷ｦ蛻呻ｼ檎畑GPT-5螟肴<E89E9F>ｸ
  const detailedScreen = await this.llm.chat('gpt5', prompt);
  const detailedDecision = JSON.parse(detailedScreen.content);

  return {
    finalDecision: detailedDecision.decision,
    consensus: 'medium',
    models: [quickDecision, detailedDecision],
    costOptimized: true,
  };
}

---

<EFBFBD>投 諤ｧ閭ｽ蜥梧<E89CA5>譛ｬ蟇ｹ豈?

讓｡蝙区€ｧ閭ｽ蟇ｹ豈<EFBFBD>

謖<EFBFBD><EFBFBD><EFBFBD>	DeepSeek-V3	GPT-5-Pro	Claude-4.5	Qwen-Max
*蜃<EFBFBD>｡ｮ邇?	85%	95% 箝?	93%	82%
騾溷ｺｦ	*蠢? 箝?	荳ｭ遲<EFBFBD>	荳ｭ遲<EFBFBD>	蠢?
謌先悽	ﾂ･0.001/1K 箝?	ﾂ･0.10/1K	ﾂ･0.021/1K	ﾂ･0.004/1K
荳ｭ譁<EFBFBD>炊隗｣	莨倡ｧ€ 箝?	莨倡ｧ€	濶ｯ螂ｽ	莨倡ｧ€
*扈捺桷蛹冶ｾ灘<EFBFBD>?	濶ｯ螂ｽ	莨倡ｧ€	莨倡ｧ€ 箝?	濶ｯ螂ｽ

遲幃€?000遽<30>枚迪ｮ逧<EFBDAE><E980A7>譛ｬ莨ｰ邂<EFBDB0>

遲也払A<EFBFBD>壼宵逕ｨDeepSeek

• 謌先悽<EFBFBD>堋?0-30
• 蜃<EFBFBD>｡ｮ邇<EFBFBD>ｼ<EFBFBD>85%
• 騾ら畑<EFBFBD>夐｢<EFBFBD>ｮ玲怏髯撰ｼ悟庄謗･蜿嶺ｸ€螳夊ｯｯ蟾?

*遲也払B<EFBFBD>咼eepSeek + GPT-5 蜿梧ｨ｡蝙?

• 謌先悽<EFBFBD>堋?50-200
• 蜃<EFBFBD>｡ｮ邇<EFBFBD>ｼ<EFBFBD>92%
• 騾ら畑<EFBFBD>夊ｴｨ驥剰ｦ∵ｱるｫ假ｼ碁｢<EFBFBD>ｮ怜<EFBFBD>雜?箝?謗ｨ闕<EFBDA8>

*遲也払C<EFBFBD>壻ｸ画ｨ｡蝙句<EFBFBD>隸<EFBFBD>ｼ?0%蜀ｲ遯∝星逕ｨClaude<64>?

• 謌先悽<EFBFBD>堋?80-220
• 蜃<EFBFBD>｡ｮ邇<EFBFBD>ｼ<EFBFBD>95%
• 騾ら畑<EFBFBD>壽怙鬮倩ｴｨ驥剰ｦ∵ｱ?

*遲也払D<EFBFBD>壽<EFBFBD>譛ｬ莨伜喧<EFBFBD><EFBFBD>80%逕ｨDeepSeek<65>?0%逕ｨGPT-5<>?

• 謌先悽<EFBFBD>堋?0-80
• 蜃<EFBFBD>｡ｮ邇<EFBFBD>ｼ<EFBFBD>90%
• 騾ら畑<EFBFBD>夊ｴｨ驥丞柱謌先悽蟷ｳ陦｡ 箝?諤ｧ莉ｷ豈疲怙鬮?

---

笞<EFBFBD><EFBFBD><EFBFBD> 豕ｨ諢丈ｺ矩｡ｹ

1. API Key螳牙<E89EB3>

// 笶?髞呵ｯｯ<EFBDAF>夂｡ｬ郛也<E9839B>、PI Key
const client = new OpenAI({
  apiKey: 'sk-cu0iepbXYGGx2jc7BqP6ogtSWmP6fk918qV3RUdtGC3Edlpo',
});

// 笨?豁｣遑ｮ<E98191>壻ｻ守識蠅<E8AD98>序驥剰ｯｻ蜿<EFBDBB>
const client = new OpenAI({
  apiKey: process.env.CLOSEAI_API_KEY,
});

2. 髞呵ｯｯ螟<EFBDAF>炊

async chat(provider: LLMProvider, prompt: string) {
  try {
    const response = await this.llm.chat(provider, prompt);
    return response;
  } catch (error) {
    // CloseAI蜿ｯ閭ｽ霑泌屓逧<E5B193>漠隸?
    if (error.status === 429) {
      // 騾溽紫髯仙宛
      console.error('API隹<49>畑騾溽紫雜<E7B4AB>剞<EFBFBD>瑚ｯｷ遞榊錘驥崎ｯ<E5B48E>');
    } else if (error.status === 401) {
      // 隶､隸∝､ｱ雍･
      console.error('API Key譌<79>謨茨ｼ瑚ｯｷ譽€譟･驟咲ｽ?);
    } else if (error.status === 500) {
      // 譛榊苅遶ｯ髞呵ｯ?
      console.error('CloseAI譛榊苅蠑ょｸｸ<EFBFBD>瑚ｯｷ遞榊錘驥崎ｯ<EFBFBD>');
    }
    throw error;
  }
}

3. 隸ｷ豎る㍾隸<E38DBE>

async chatWithRetry(provider: LLMProvider, prompt: string, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await this.llm.chat(provider, prompt);
    } catch (error) {
      if (i === maxRetries - 1) throw error;
      
      // 謖<>焚騾€驕?
      const delay = Math.pow(2, i) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
    }
  }
}

---

<EFBFBD>答 逶ｸ蜈ｳ譁<EFBDB3>｡｣

• 邇ｯ蠅<EFBFBD><EFBFBD>鄂ｮ謖<EFBFBD>漉
• 邇ｯ蠅<EFBFBD>序驥城<EFBFBD>鄂ｮ讓｡譚ｿ
• LLM鄂大<EFBFBD>蠢ｫ騾滉ｸ贋ｸ区枚

---

*譖ｴ譁ｰ譌･蠢暦ｼ?

• 2025-11-09: 蛻帛ｻｺ譁<EFBDBA>｡｣<EFBDA1>梧ｷｻ蜉<EFBDBB>CloseAI髮<49><E9ABAE>謖<EFBFBD>漉
• 謾ｯ謖；PT-5-Pro蜥靴laude-4.5-Sonnet譛€譁ｰ讓｡蝙?