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

# CloseAI髮<49><E9ABAE>謖<EFBFBD>漉

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

---

## <20>搭 CloseAI邂€莉?

### 莉€荵域弍CloseAI<41>?

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

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

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

---

## <20>肌 驟咲ｽｮ菫｡諱ｯ

### 邇ｯ蠅<EFBDAF>序驥城<E9A9A5>鄂ｮ

```env
# 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
```

### 謾ｯ謖∫噪讓｡蝙?

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

---

## <20>捗 莉｣遐<EFBDA3>寔謌<E5AF94>

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

```bash
npm install openai
```

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

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

```typescript
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>

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

```typescript
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,
    };
  }
}
```

---

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

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

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

```typescript
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<EFBDAF>壻ｸ画ｨ｡蝙句<E89D99>隸<EFBFBD>ｻｲ陬<EFBDB2>

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

```typescript
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<EFBDAF>壽<EFBFBD>譛ｬ莨伜喧遲也<E981B2>?

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

```typescript
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,
  };
}
```

---

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

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

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

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

**遲也払A<E68995>壼宵逕ｨDeepSeek**
- 謌先悽<E58588>堋?0-30
- 蜃<>｡ｮ邇<EFBDAE>ｼ<EFBFBD>85%
- 騾ら畑<E38289>夐｢<E5A490>ｮ玲怏髯撰ｼ悟庄謗･蜿嶺ｸ€螳夊ｯｯ蟾?

**遲也払B<E68995>咼eepSeek + GPT-5 蜿梧ｨ｡蝙?*
- 謌先悽<E58588>堋?50-200
- 蜃<>｡ｮ邇<EFBDAE>ｼ<EFBFBD>92%
- 騾ら畑<E38289>夊ｴｨ驥剰ｦ∵ｱるｫ假ｼ碁｢<E7A281>ｮ怜<EFBDAE>雜?箝?謗ｨ闕<EFBDA8>

**遲也払C<E68995>壻ｸ画ｨ｡蝙句<E89D99>隸<EFBFBD>ｼ?0%蜀ｲ遯∝星逕ｨClaude<64>?*
- 謌先悽<E58588>堋?80-220
- 蜃<>｡ｮ邇<EFBDAE>ｼ<EFBFBD>95%
- 騾ら畑<E38289>壽怙鬮倩ｴｨ驥剰ｦ∵ｱ?

**遲也払D<E68995>壽<EFBFBD>譛ｬ莨伜喧<E4BC9C><E596A7>80%逕ｨDeepSeek<65>?0%逕ｨGPT-5<>?*
- 謌先悽<E58588>堋?0-80
- 蜃<>｡ｮ邇<EFBDAE>ｼ<EFBFBD>90%
- 騾ら畑<E38289>夊ｴｨ驥丞柱謌先悽蟷ｳ陦｡ 箝?諤ｧ莉ｷ豈疲怙鬮?

---

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

### 1. API Key螳牙<E89EB3>

```typescript
// 笶?髞呵ｯｯ<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>炊

```typescript
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>

```typescript
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));
    }
  }
}
```

---

## <20>答 逶ｸ蜈ｳ譁<EFBDB3>｡｣

- [邇ｯ蠅<EFBFBD><EFBFBD>鄂ｮ謖<EFBFBD>漉](../../07-霑千ｻｴ譁<EFBDB4>｡｣/01-邇ｯ蠅<EFBDAF><E8A085>鄂ｮ謖<EFBDAE>漉.md#3-closeai驟咲ｽｮ莉｣逅<EFBDA3>penai蜥慶laude)
- [邇ｯ蠅<EFBFBD>序驥城<EFBFBD>鄂ｮ讓｡譚ｿ](../../07-霑千ｻｴ譁<EFBDB4>｡｣/02-邇ｯ蠅<EFBDAF>序驥城<E9A9A5>鄂ｮ讓｡譚ｿ.md)
- [LLM鄂大<EFBFBD>蠢ｫ騾滉ｸ贋ｸ区枚](./[AI蟇ｹ謗･]%20LLM鄂大<E98482>蠢ｫ騾滉ｸ贋ｸ区枚.md)

---

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