中国站
帮助中心 > 人工智能 > 大模型服务 > API参考 > TEXT > MaaS_Ge OpenAI协议API

MaaS_Ge OpenAI协议API

请求协议

Http
Header
参数名
Authorization Bearer {YOUR AK}
Content-Type application/json

请求url

https://api.yisu.com/v1/ai/{YOUR ENDPOINT}/chat/completions

请求Body

Google 模型 Chat Completions API 支持参数

基础参数

参数 支持情况 说明
messages ✅ 支持 支持以下消息类型:
- 系统消息
- 用户消息(支持 textimage_url 类型,image_url 支持 Cloud Storage URI 或 base64 编码)
- 助手消息
- 工具消息
- 函数消息(已弃用,但保持兼容)
model ✅ 支持 模型名称
max_tokens / max_completion_tokens ✅ 支持 响应最大 token 数
temperature ✅ 支持 采样温度
top_p ✅ 支持 核采样参数
n ✅ 支持 生成结果数量
stream ✅ 支持 流式输出
stop ✅ 支持 停止序列
presence_penalty ✅ 支持 存在惩罚
frequency_penalty ✅ 支持 频率惩罚
seed ✅ 支持 对应 Gemini 的 GenerationConfig.seed

多模态输入

参数 支持情况 说明
input_audio ✅ 支持 支持 URI 或 blob 格式,所有有效 MIME 类型
image_url ✅ 支持 支持 URI 或 blob 格式,detail 参数全请求统一

工具和函数

参数 支持情况 说明
tools ✅ 支持 工具定义
tool_choice ✅ 支持 选项:none, auto, required(ANY模式), validated(VALIDATED模式)
functions ⚠️ 已弃用 保持兼容
function_call ⚠️ 已弃用 保持兼容

Gemini特有参数

  1. {
  2. "extra_body": {
  3. "google": {
  4. "safety_settings": "安全设置",
  5. "cached_content": "缓存内容",
  6. "thinking_config": "思考配置"
  7. }
  8. },
  9. "extra_part": {
  10. "google": {
  11. "thought": "显式标记思考内容"
  12. }
  13. }
  14. }

请求demo

  1. curl --location 'https://api.yisu.com/v1/ai/{YOUR ENDPOINT}/chat/completions' \
  2. --header 'Authorization: Bearer {YOUR AK}' \
  3. --header 'Content-Type: application/json' \
  4. --data '{
  5. "temperature": 1,
  6. "model": "gemini-2.5-flash",
  7. "messages": [
  8. {
  9. "role": "user",
  10. "content": "hi"
  11. }
  12. ],
  13. "stream": false
  14. }'