API调试模式

API配置

选择接口

参数配置

Cloudace LLM API接口文档

强大的人工智能服务，助力您的业务创新

支持的模型

LLM模型

  • auto - 自动选择最优的模型进行回答
  • gemini-3-pro - Vertex AI Preview版本，支持Google Search grounding
  • gemini-2.5-pro - Vertex AI GA版本，支持Google Search grounding
  • gemini-2.5-flash - Vertex AI GA版本，支持Google Search grounding

Imagen模型

  • Nano banana - 对应Vertex AI gemini-3.0-pro-image

Veo模型

  • veo3 - 对应Vertex AI veo-3.0-generate-001（带声音）

认证方式

OpenAI标准认证 - 本API兼容OpenAI的认证标准。

其中 /v1/chat/completions 和 /v1/models 接口完全遵循OpenAI API标准，支持使用OpenAI SDK直接调用。

所有API请求都需要在请求头中包含有效的Bearer Token进行认证，格式与OpenAI API完全一致。 

Authorization: Bearer YOUR_API_KEY

聊天接口

接口信息

请求方法： POST

接口地址： /v1/chat/completions

Content-Type： application/json

请求参数

参数名 类型 必需 说明 支持值
model string 必填 使用的模型名称 auto, gemini-3-pro, gemini-2.5-pro, gemini-2.5-flash
messages array 必填 对话消息列表 消息对象数组
stream boolean 可选 是否使用流式输出 true, false (默认: false)
temperature float 可选 控制随机性 0.0 - 1.0
max_tokens integer 可选 最大输出令牌数 正整数
top_p float 可选 核采样参数 0.0 - 1.0
stop string/array 可选 停止序列 字符串或字符串数组
frequency_penalty float 可选 频率惩罚 -2.0 - 2.0
presence_penalty float 可选 存在惩罚 -2.0 - 2.0
user string 可选 用户标识符 字符串

cURL示例

curl -X POST "http://your-api-domain/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gemini-2.5-pro",
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下你自己"
      }
    ],
    "stream": false,
    "temperature": 0.7,
    "max_tokens": 1000
  }'

流式输出示例

curl -X POST "http://your-api-domain/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gemini-2.5-pro",
    "messages": [
      {
        "role": "user",
        "content": "请写一首关于春天的诗"
      }
    ],
    "stream": true
  }'

OpenAI SDK兼容示例

OpenAI标准接口 - 本接口完全兼容OpenAI API标准，可以直接使用OpenAI SDK调用。

只需设置正确的base_url即可无缝切换到我们的服务。 

from openai import OpenAI

# 使用您的API端点和密钥
client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="http://your-api-domain/v1"
)

# 调用聊天接口
response = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
)

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

错误处理

401 Unauthorized

API Key无效或缺失

404 Not Found

请求的模型不存在

400 Bad Request

请求参数错误或内容为空

503 Service Unavailable

服务暂时不可用，请稍后重试

模型列表接口

接口信息

请求方法： GET

接口地址： /v1/models

Content-Type： application/json

接口说明

OpenAI标准接口 - 本接口完全兼容OpenAI API标准，可以直接使用OpenAI SDK调用。

返回所有可用的模型列表，包括LLM模型和模型别名。

cURL示例

curl -X GET "http://your-api-domain/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

OpenAI SDK兼容示例

from openai import OpenAI

# 使用您的API端点和密钥
client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="http://your-api-domain/v1"
)

# 获取模型列表
models = client.models.list()

# 打印所有可用模型
for model in models.data:
    print(f"模型ID: {model.id}, 创建时间: {model.created}")

响应格式

{
  "object": "list",
  "data": [
    {
      "id": "gemini-2.5-pro",
      "object": "model",
      "created": 1640995200,
      "owned_by": "web-automation"
    },
    {
      "id": "gemini-2.5-flash",
      "object": "model",
      "created": 1640995200,
      "owned_by": "web-automation"
    },
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1640995200,
      "owned_by": "web-automation"
    },
    {
      "id": "gpt-4",
      "object": "model",
      "created": 1640995200,
      "owned_by": "web-automation"
    }
  ]
}

错误处理

401 Unauthorized

API Key无效或缺失

503 Service Unavailable

服务暂时不可用，请稍后重试

图片生成接口

接口信息

请求方法： POST

接口地址： /v1/imagen

Content-Type： application/json

请求参数

参数名 类型 必需 说明
prompt string 可选 图片描述提示词。prompt 和 images 至少需要一个。
images array 可选 Base64编码的图片字符串数组 (格式: "data:image/...;base64,...")。

cURL示例 (文生图)

curl -X POST "http://your-api-domain/v1/imagen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "prompt": "一只可爱的小猫坐在花园里，阳光明媚，高清摄影风格"
  }'

cURL示例 (图文生成)

以下示例展示了如何传入两张图片和一段文字提示，让模型根据这些输入生成新内容。

curl -X POST "http://your-api-domain/v1/imagen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "prompt": "把第一只猫和第二只狗合成为一张图片",
    "images": [
      "data:image/png;base64,iVBOR... (第一张图片的base64)",
      "data:image/png;base64,iVBOR... (第二张图片的base64)"
    ]
  }'

响应格式

{
  "text": "这是生成的文本描述...",
  "image": "base64编码的图片数据"
}

错误处理

401 Unauthorized

API Key无效或缺失

400 Bad Request

提示词为空

503 Service Unavailable

服务暂时不可用

408 Request Timeout

图片生成超时

视频生成接口

接口信息

请求方法： POST

接口地址： /v1/veo

Content-Type： application/json

请求参数

参数名 类型 必需 说明 支持值
prompt string 必填 视频描述提示词 非空字符串

cURL示例

curl -X POST "http://your-api-domain/v1/veo" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "prompt": "夕阳下的海滩，海浪轻拍着沙滩，远处有海鸥飞翔"
  }'

响应格式

{
  "video": "base64编码的视频数据"
}

错误处理

401 Unauthorized

API Key无效或缺失

400 Bad Request

提示词为空

503 Service Unavailable

服务暂时不可用

408 Request Timeout

视频生成超时