OpenAI 接口兼容模式 | 大装置帮助中心
跳到主要内容

OpenAI 接口兼容模式

本指南介绍了如何从 OpenAI 模型快速迁移到SenseNova 日日新大模型服务，我们用实例展示这个过程，帮助您更好的完成迁移工作。同时，商汤面向 OpenAI API用户还将提供「特别搬家计划」，帮助您轻松切换至国产大模型。

基础工具包​

OpenAI SDK为我们提供了一个开箱即用的调用工具，对此，我们在后端兼容了OpenAI的所有Endpoint, 提供了便捷的迁移方式，仅需更换api_key与base_url，就可以使用我们的模型。

调用前的准备工作 “使用ModelStudio API Key鉴权”

  • 切换API Endpoint

    • 【对话生成】

    from openai import OpenAI 

    client = OpenAI(
        api_key="API_KEY or API_TOKEN",
        base_url="https://api.sensenova.cn/compatible-mode/v2"
    ) 

    response = client.chat.completions.create(
        model="SenseChat-5",  
        messages=[    
            {"role": "system", "content": "请你扮演一名优秀的故事创作者，并按照以下步骤完成故事创作：1.根据用户的要求设定【故事主题】。2.按照以下格式输出：【故事主题】xxx、【故事名称】xxx、【故事内容】xxx。3.输出的内容不要超过500个字。"},    
            {"role": "user", "content": "帮我写一个关于勇者斗恶龙的故事。"} 
        ],
        top_p=0.7,
        temperature=1.0
     ) 
     
    print(response .choices[0].message)

    【多模态】

    from openai import OpenAI 

    client = OpenAI(
        api_key="API_KEY or API_TOKEN",
        base_url="https://api.sensenova.cn/compatible-mode/v2"
    ) 

    response = client.chat.completions.create(
        model="SenseNova-V6-Pro",  
        messages=[  
            {
            "role": "user",
            "content": [
            {
                "type": "text",
                "text": "图片里有什么"
            },
            {
                "type": "image_url",
                "image_url": {
                "url": "https://img0.baidu.com/it/u=3775751201,1094020238&fm=253&fmt=auto&app=138&f=JPEG?w=500&h=615"
            }
            }
            ]
            }
        ],
        top_p=0.7,
        temperature=1.0
     ) 
     
    print(response .choices[0].message)


请求示例 -文本（Request Example）​

curl --request POST \
  --url https://api.sensenova.cn/compatible-mode/v2/chat/completions \
  --header 'Authorization: Bearer {api-key}' \
  --header 'content-type: application/json' \
  --data '{
  "model": "SenseChat-5",
  "max_completion_tokens": 4096,
  "messages": [
    {
      "role": "system",
      "content": "当涉及到几月几号、日期、时间、星期等相关的问题，请务必优先使用这个日期与当前时间: '\''2025-09-16 Tuesday 22:52 PM'\''"
    },
    {
      "role": "user",
      "content": "莎士比亚与原神有什么关系"
    }
  ],
  "repetition_penalty": 1.05,
  "stream": false,
  "temperature": 0.01,
  "top_p": 0.7,
  "plugins": {},
  "reasoning_effort": "medium"
}'

响应示例 - 文本（Request Example）​

  • 非流式
{
    "id": "1a572125-ddf2-4c96-936f-65d4c5e351da",
    "created": 1758268864,
    "model": "SenseChat-5",
    "object": "chat.completion",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "莎士比亚，即威廉·莎士比亚，是英国文艺复兴时期最伟大的剧作家、诗人之一，他的作品对世界文学产生了深远的影响。莎士比亚的作品涵盖了悲剧、喜剧、历史剧等多种类型，其中《哈姆雷特》、《罗密欧与朱丽叶》、《麦克白》等剧作至今仍被广泛演出和研究。\n\n原神是一款由中国的miHoYo（现更名为HoYoverse）公司开发的开放世界角色扮演游戏，于2020年全球发行。游戏以其开放世界的设定、丰富的角色故事、精彩的战斗系统以及高品质的音乐和美术设计受到了全球玩家的喜爱。\n\n莎士比亚与原神本身并无直接关系，因为他们来自不同的时代和文化背景。然而，在原神中，可以发现一些受到莎士比亚作品启发的元素。例如，原神的角色“莫娜”的背景设定和性格特点，被一些玩家解读为参考了莎士比亚剧作中的典型人物形象。此外，原神的故事叙述和角色对话中，也融入了戏剧化的表达方式，这可能是受到了莎士比亚戏剧的间接影响。\n\n总的来说，莎士比亚与原神之间的关系更多地体现在文化传承和艺术启发上，而非直接的联系。原神作为一款现代游戏，其创作过程中可能汲取了来自多种文化和艺术形式的灵感，其中就包括莎士比亚的经典剧作。"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 47,
        "completion_tokens": 287,
        "total_tokens": 334
    },
    "service_tier": "default"
}

  • 流式
data:{"id":"0cd8a87f-b68f-49ed-9bef-fae9414ef63f","created":1758269052,"model":"SenseChat-5","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":"莎"},"finish_reason":""}],"service_tier":"default"}

data:{"id":"0cd8a87f-b68f-49ed-9bef-fae9414ef63f","created":1758269052,"model":"SenseChat-5","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":"士"},"finish_reason":""}],"service_tier":"default"}

...

data:{"id":"0cd8a87f-b68f-49ed-9bef-fae9414ef63f","created":1758269052,"model":"SenseChat-5","object":"chat.completion.chunk","choices":[],"service_tier":"default","usage":{"prompt_tokens":47,"completion_tokens":483,"total_tokens":530}}

data:[DONE]

请求示例 - 多模态（Request Example）​

curl --request POST \
  --url https://api.sensenova.cn/compatible-mode/v2/chat/completions \
  --header 'Authorization: Bearer {api-key}' \
  --header 'content-type: application/json' \
  --data '{
    "model": "SenseNova-V6-5-Pro",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "图片里有什么"
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://img0.baidu.com/it/u=3775751201,1094020238&fm=253&fmt=auto&app=138&f=JPEG?w=500&h=615"
                    }
                }
            ]
        }
    ],
    "temperature": 0.8,
    "stream": false,
    "max_completion_tokens": 1024,
    "reasoning_effort": "low",
    "frequency_penalty": 1.05,
    "top_p": 0.7
}'

响应示例 - 多模态（Request Example）​

{
    "id": "5f0eef95-6fc0-4529-bdf7-1549bcfff26f",
    "created": 1758783696,
    "model": "SenseNova-V6-5-Pro",
    "object": "chat.completion",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "图片中主要包含以下内容：\n\n1. **主体小猫**：\n   - 一只小橘猫占据画面中心，毛色呈现橙白相间的渐变效果\n   - 竖立的三角形耳朵透着粉嫩内耳廓，蓝色虹膜的大眼睛如琉璃般透亮\n   - 呈现拟人化的呆萌表情：微张的粉嫩鼻翼与半露的小乳牙形成\"懵懂脸\"\n   - 前肢呈标准坐姿并拢，绒毛蓬松的尾巴自然蜷曲在身侧\n\n2. **环境要素**：\n   - 虚化的背景中可见原木色栅栏与蕨类植物剪影\n   - 晨昏时段的45度侧光在猫毛边缘形成金色轮廓光\n   - 空气中漂浮的微尘在逆光中形成丁达尔效应光束\n\n3. **后期处理痕迹**：\n   - 右下角带有\"@修图师美图秀秀\"的水印字样\n   - 猫眼部位有明显的眼神光增强处理\n   - 毛色饱和度经过优化，橙色部分呈现奶油质感\n\n该影像通过浅景深突出主体，结合柔焦滤镜营造出童话般的视觉效果，整体呈现专业宠物摄影的典型特征。"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 260,
        "completion_tokens": 654,
        "total_tokens": 914
    },
    "service_tier": "default"
}

模型列表​

SenseNova 日日新大模型服务提供了包括通用大模型、多模态大模型、拟人对话大模型等多种模型。

模型
类型		 模型名称   模型描述   输入单价  输出单价 
通用大模型SenseChat-5最新版本模型 (V5)，128K上下文长度，语言、知识、推理、数学、代码等领域能力显著提升，达到或超越GPT-4 Turbo0.008元/千tokens0.02元/千tokens
SenseChat基础版本模型 (V4)，4K上下文长度，通用能力强大0.012元/千tokens0.012元/千tokens
SenseChat-Turbo适用于快速问答、模型微调场景0.0003元/千tokens0.0006元/千tokens
SenseChat-5-Cantonese32K上下文长度，在粤语的对话理解上超越了GPT-4，在知识、推理、数学及代码编写等多个领域均能与GPT-4 Turbo相媲美0.027元/千tokens0.027元/千tokens
多模态大模型SenseNova-V6.5-Pro最新版本模型 (V6.5)，128K上下文长度，实现图片、文本、视频能力的原生统一，突破传统多模态分立局限，在OpenCompass和SuperCLUE评测中斩获双冠军0.003元/千tokens0.009元/千tokens
SenseNova-V6.5-Turbo最新版本模型 (V6.5)，128K上下文长度，实现图片、文本、视频能力的原生统一，突破传统多模态分立局限，在OpenCompass和SuperCLUE评测中斩获双冠军0.0015元/千tokens0.0045元/千tokens
SenseChat-Vision4K上下文长度，图文感知能力达到全球领先水平，在多个知名多模态榜单均取得领先成绩0.01元/千tokens0.06元/千tokens
拟人对话大模型SenseChat-Character-Pro高级版模型，32K上下文长度，能力全面提升，支持中/英文对话0.015元/千tokens0.015元/千tokens
SenseChat-Character标准版模型，8K上下文长度，高响应速度0.012元/千tokens0.012元/千tokens