Skip to content

INTERN_AI_INTEGRATION.md

Latest commit

 

History

History
255 lines (178 loc) · 5.69 KB

INTERN_AI_INTEGRATION.md

File metadata and controls

255 lines (178 loc) · 5.69 KB
Raw

Intern AI API 集成指南

概述

Intern AI 是上海 AI 实验室提供的多模态大语言模型 API 服务，支持文本和图像理解。该 API 使用 OpenAI 兼容的格式，可以轻松集成到现有系统中。

API 信息

  • 基础 URL: https://chat.intern-ai.org.cn/api/v1/
  • 认证方式: Bearer Token
  • 请求格式: OpenAI 兼容
  • 响应格式: OpenAI 兼容

可用模型

多模态模型

模型名称 描述 上下文长度
intern-latest 最新模型别名，当前指向 intern-s1 32K
intern-s1 最新多模态模型，具有强大的科学推理能力 32K
intern-s1-mini 轻量级多模态模型 32K
internvl3.5-241b-a28b 最新多模态模型，增强的图像文本理解 32K
internvl3-latest InternVL3 系列最新模型别名 32K
internvl3-78b 最新多模态模型，长序列视觉推理 32K

大语言模型

模型名称 描述 上下文长度
internlm3-latest InternLM3 系列最新模型别名 32K
internlm3-8b-instruct 最新推理模型，领先的推理能力 32K
internlm2.5-latest InternLM2.5 系列最新模型别名 32K

集成步骤

1. 获取 API 密钥

  1. 访问 Intern AI 官网
  2. 注册账户并登录
  3. 在控制台中生成 API 密钥
  4. 复制 API 密钥（格式：eyJ0eXBlIjoiSl...）

2. 配置游戏设置

在游戏设置中选择：

  • API 类型: InternAI
  • 模型: 选择适合的模型（推荐 intern-latest 或 internlm3-latest）
  • API 密钥: 粘贴你的 API 密钥

3. 推荐配置

开发环境

API类型: InternAI
模型: internlm3-8b-instruct
用途: 文本对话和推理

生产环境

API类型: InternAI
模型: intern-latest
用途: 多模态对话和科学推理

高性能环境

API类型: InternAI
模型: internvl3.5-241b-a28b
用途: 复杂多模态任务

使用示例

Python 示例

import requests
import json

url = 'https://chat.intern-ai.org.cn/api/v1/chat/completions'
headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
}

data = {
    "model": "intern-latest",
    "messages": [
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

OpenAI SDK 示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY_HERE",
    base_url="https://chat.intern-ai.org.cn/api/v1/",
)

response = client.chat.completions.create(
    model="intern-latest",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ],
    temperature=0.7,
    max_tokens=1024
)

print(response.choices[0].message.content)

特性优势

1. 多模态能力

  • 支持图像和文本理解
  • 强大的视觉推理能力
  • 科学计算和推理

2. 高性能

  • 领先的开源模型性能
  • 与 GPT-4o 和 Gemini Pro 相当
  • 32K 上下文长度

3. 中文优化

  • 对中文理解优秀
  • 适合中文对话场景
  • 本土化服务

4. 成本效益

  • 相比国外 API 更经济
  • 稳定的服务质量
  • 快速响应

错误处理

常见错误码

  • 401: 认证失败，检查 API 密钥
  • 429: 请求频率限制
  • 500: 服务器内部错误

调试建议

  1. 检查 API 密钥格式是否正确
  2. 确认网络连接正常
  3. 验证模型名称是否有效
  4. 查看控制台错误日志

性能优化

1. 模型选择

  • 文本任务: 使用 internlm3-8b-instruct
  • 多模态任务: 使用 intern-latest
  • 轻量级任务: 使用 intern-s1-mini

2. 参数调优

{
  "temperature": 0.7, // 创造性平衡
  "max_tokens": 1024, // 响应长度
  "top_p": 0.9, // 核采样
  "frequency_penalty": 0.0, // 频率惩罚
  "presence_penalty": 0.0 // 存在惩罚
}

3. 请求优化

  • 合理设置 max_tokens
  • 使用适当的 temperature
  • 避免重复请求

监控和调试

1. 日志监控

游戏会在控制台输出详细的 API 调用信息：

[APIManager] 发送请求到 InternAI API，模型：intern-latest
[APIManager] 请求URL：https://chat.intern-ai.org.cn/api/v1/chat/completions
[APIConfig] 响应解析成功

2. 性能指标

  • 响应时间
  • 成功率
  • 错误率
  • 使用量统计

故障排除

问题 1: 认证失败

解决方案：

  1. 检查 API 密钥是否正确
  2. 确认密钥格式（不包含"Bearer "前缀）
  3. 重新生成 API 密钥

问题 2: 模型不可用

解决方案：

  1. 检查模型名称是否正确
  2. 尝试使用 intern-latest 别名
  3. 查看 API 状态页面

问题 3: 响应速度慢

解决方案：

  1. 选择更小的模型（如 intern-s1-mini）
  2. 减少 max_tokens 参数
  3. 检查网络连接

更新日志

v1.0 - Intern AI 集成

  • 添加 Intern AI API 支持
  • 集成 9 个可用模型
  • 支持多模态和纯文本模型
  • 完整的错误处理和调试支持

相关链接