927AI API 文档
官网控制台模型与价格文档首页
官网控制台模型与价格文档首页
  1. 内容生成
  • 快速开始
    • 欢迎使用
    • 价格说明
  • 开发工具接入
    • 开发工具接入
    • Claude Code
    • Codex
    • Cursor
    • OpenCode
    • Grok CLI
    • Gemini CLI
    • OpenClaw
    • Hermes
    • WorkBuddy
    • 常见问题
  • 模型 API 接口
    • OpenAI 格式
      • 文本生成
        • Completions
        • Responses
      • 图片
        • 图片生成
        • 图片编辑
    • Anthropic 格式
      • 文本生成
        • Messages
    • Gemini 格式
      • 模型
        • Models
      • 内容生成
        • Generate Content
          POST
        • Stream Generate Content
          POST
      • 向量化
        • Embed Content
        • Batch Embed Contents
    • 视频生成API
      • Seedance
        • OpenAI 格式
          • 创建视频生成任务
          • 查询视频生成任务
          • 下载生成的视频
        • 火山方舟格式
          • 创建视频生成任务
          • 查询视频生成任务
      • Grok
        • OpenAI 格式
          • 创建 Grok 视频任务
          • 查询 Grok 视频任务
          • 下载 Grok 视频
      • Wan
        • OpenAI 格式
          • 创建 Wan 视频任务
          • 查询 Wan 视频任务
          • 下载 Wan 视频
  1. 内容生成

Generate Content

POST
/v1beta/models/{model}:generateContent
根据输入内容生成完整响应,兼容 Gemini models.generateContent 原生接口。
contents 为必填参数。单轮请求通常只包含一条 user 内容;多轮对话应按时间顺序传入
user 与 model 历史消息,并把当前用户消息放在最后。系统提示词使用顶层
systemInstruction,不要在 contents 中使用 system 角色。
每条内容的 parts 可以包含文本、Base64 内联媒体、文件 URL、函数调用、函数结果、可执行代码或
代码执行结果。tools 可声明函数、Google Search、URL Context 和代码执行工具。部分高级字段是否
生效取决于所选模型的能力。
图片生成模型仍使用本接口。设置 generationConfig.responseModalities 后,图片通常以
candidates[].content.parts[].inlineData.data 中的 Base64 数据返回;客户端需要根据同一对象的
mimeType 解码。图片编辑时,在同一条 user 内容中同时传入文字指令与图片即可。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Path 参数

Body 参数application/json必填

示例
{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "你好,请用一句话介绍你自己。"
                }
            ]
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://vip.927ai.ai/v1beta/models/:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "你好,请用一句话介绍你自己。"
                }
            ]
        }
    ]
}'

返回响应

🟢200
application/json
内容生成成功
Bodyapplication/json

示例
{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "text": "我是一个通过 927AI API 提供服务的 Gemini 助手。"
                    }
                ]
            },
            "finishReason": "STOP",
            "index": 0,
            "safetyRatings": []
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 12,
        "candidatesTokenCount": 20,
        "totalTokenCount": 32
    }
}
🟠400BadRequest
🟠401Unauthorized
🟠403Forbidden
🟠404NotFound
🟠413PayloadTooLarge
🟠429RateLimited
🔴500InternalError
🔴504Timeout
上一页
Models
下一页
Stream Generate Content
Built with