APIPro
网站首页
网站首页
  1. Gemini 接口
  • (必读)使用说明
  • API Base URL地址
  • 列出模型
    • Models(列出模型)
      GET
  • OpenAI 接口 (兼容各大原厂模型)
    • OpenAI SDK使用指南
    • Responses API 接口使用指南
    • 对话(openai, gemini, claude, deepseek...)
      • 聊天(chat)
      • 流式返回(chat)
      • 思考模式(chat)
      • 结构化输出(chat)
      • 工具调用(chat)
      • MCP调用(chat)
      • web search(chat)
      • 聊天(responses)
      • 流式返回(responses)
      • 思考模式(responses)
      • web search(responses)
    • 图像(gpt, dalle, banana, jimeng,doubao)
      • 文生图(chat)
      • 图生图(chat)
      • 分析图片(chat)
      • 文生图(images)
      • 图生图(images)
    • 视频(sora, veo, 可灵)
      • VEO, SORA 接口参数信息说明
      • 文生视频-异步 (veo)
      • 图生视频-异步 (veo)
      • 首尾帧视频-异步 (veo)
      • 查询视频状态 (veo)
      • 获取视频内容 (veo)
      • 分镜模式-异步 (sora)
      • 角色创建-异步 (sora)
      • 文生视频-同步 (veo)
      • 图生视频-同步 (veo)
      • 首尾帧视频-同步 (veo)
      • 文生视频-异步 (可灵, 通义万象)
      • 图生视频-异步 (可灵, 通义万象)
      • 首尾帧生视频-异步 (可灵, 通义万象)
      • 查询视频状态 (可灵, 通义万象)
    • 语音
      • 语音回复(chat)
      • 语音识别(audio)
      • 语音合成(audio)
    • 向量化
      • 文本向量化
    • 音乐(suno接口)
      • 生成歌词lyrics接口
      • 生成音乐suno接口
      • 上传音乐接口
      • 歌曲拼接接口
      • 查询歌词/音乐任务
  • Anthropic 接口
    • Anthropic SDK使用指南
    • 聊天
      POST
    • 聊天(prompt cache)
      POST
    • 流式返回
      POST
    • 聊天(深度思考)
      POST
    • 工具调用(function call)
      POST
    • 分析图片
      POST
  • Gemini 接口
    • Gemini SDK使用指南
    • 聊天
      POST
    • 流式返回
      POST
    • 联网搜索
      POST
    • 文生图
      POST
    • 图生图(传file)
      POST
    • 图生图(传url)
      POST
    • 分析图片(传base64)
      POST
    • 分析图片(传url)
      POST
  • Midjourney 接口
    • 接口使用示例 (局部重绘)
    • 任务查询接口
    • 获取种子(Seed)
    • 文生图(Imagine)
    • 图片融合(Blend)
    • 图生文(Describe)
    • 换脸(FaceSwap)
    • 上传(upload)
    • 任务批量查询接口
    • 按钮点击(Action)
    • 窗口执行(Modal)
    • 刷新链接(Refresh)
    • 编辑图片(Edit)
  • 第三方接入
    • 问问接入各编程平台指南
    • OpenClaw接入APIPro
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
  1. Gemini 接口

分析图片(传url)

POST
/v1beta/models/{model-name}:generateContent
gemini API的使用方式和openai的不同,模型名字要在url中传递,比如:https://api.wenwen-ai.com/v1beta/models/gemini-3-flash-preview:generateContent

请求参数

Path 参数

Header 参数

Body 参数application/json

示例
{
  "contents": [
    {
      "parts": [
        {
          "text": "分析图片"
        },
        {
          "fileData": {
            "mimeType": "image/png",
            "fileUri": "https://aric.oss-cn-beijing.aliyuncs.com/woman_image.png"
          }
        }
      ]
    }
  ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.wenwen-ai.com/v1beta/models/:generateContent' \
--header 'x-goog-api-key: sk-xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
  "contents": [
    {
      "parts": [
        {
          "text": "分析图片"
        },
        {
          "fileData": {
            "mimeType": "image/png",
            "fileUri": "https://aric.oss-cn-beijing.aliyuncs.com/woman_image.png"
          }
        }
      ]
    }
  ]
}'

返回响应

🟢200成功
application/json
Body

示例
{'candidates': [
        {'content': {'parts': [
                    {'text': '这张图片是一个近距离的女性肖像照,展现了模特的上半部分脸庞和部分发型。\n\n以下是具体的图 片内容分析:\n\n1.  **主体人物:**\n    *   **年龄与性别:** 一位看起来很年轻的女性。\n    *   **面部特征:**\n        *   **眼睛:** 她的眼睛是琥珀色或浅棕色,眼神直接而专注,略带柔和。眼妆精致,睫毛浓密卷翘,眉毛修剪和描画得非常自然且有型。\n        *   **鼻子:** 鼻梁挺拔 ,鼻型秀气。\n        *   **嘴唇:** 嘴唇饱满,涂抹着柔和的玫瑰色或豆沙色唇膏,带有微微的光泽。嘴角略微上扬,展现出一种内敛而友好的微笑, 右侧脸颊(观众的左侧)在微笑时出现了一个浅浅的酒窝或法令纹。\n        *   **肤色与妆容:** 肤色呈现温暖的小麦色或橄榄色,T区和颧骨有自然的光泽,整体妆容显得非常干净、精致且自然,凸显了她的五官优势。\n    *   **发型:** 她拥有一头深棕色、带有自然波浪或卷度的长发。发量看起来很 丰盈,发丝在脸部周围形成柔和的弧度,部分发丝在光线下显得非常有层次感和光泽。\n\n2.  **构图与焦点:**\n    *   这是一张特写肖像,将焦点完全集中在女性的脸部。\n    *   构图将她的脸部放置在画面中央,吸引了观者的全部注意力。\n    *   采用了浅景深效果,主体人物清晰锐利,而背景则被大幅虚化,进一步突出人物。\n\n3.  **光线与色彩:**\n    *   **光线:** 光线柔和,可能来自前方或侧前方,在人物脸上形成自然的明暗过渡,很好 地勾勒出脸部轮廓,同时也在眼睛中产生了明亮的“眼神光”,使双眼更有神。\n    *   **色彩:** 整体色调温暖而和谐。以人物的棕色系发色、琥珀色眼 珠、暖色调肤色和柔和的唇色为主,与虚化的暖色调背景(米色、棕色渐变)相得益彰。\n\n4.  **背景:**\n    *   背景是高度虚化的模糊色块,左侧呈现米白色或浅灰色,向右侧逐渐过渡为深棕色。这种处理方式避免了任何干扰,使人物成为画面的绝对中心。\n\n5.  **整体氛围与情绪:**\n    *   图片传达出一种平静、优雅、自信而又亲和的氛围。模特的微笑和眼神给人以温暖和放松的感觉。\n    *   这张图片具有很高的专业水准,无论是光线、构图还是人物的表情管理都非常到位,常用于广告、杂志封面或个人品牌形象照。\n    *   值得一提的是,图像的精致度和完美无瑕的细节,有时也暗示这可能是一张由人工智能(AI)生成的高质量图像。'
                    }
                ], 'role': 'model'
            }, 'finishReason': 'STOP', 'index': 0
        }
    ], 'usageMetadata': {'promptTokenCount': 263, 'candidatesTokenCount': 723, 'totalTokenCount': 2461, 'promptTokensDetails': [
            {'modality': 'TEXT', 'tokenCount': 5
            },
            {'modality': 'IMAGE', 'tokenCount': 258
            }
        ], 'thoughtsTokenCount': 1475
    }, 'modelVersion': 'gemini-2.5-flash', 'responseId': 'bYeBaZjtD7O0qtsP9ozU6Ac'
}
修改于 2026-03-31 15:12:51
上一页
分析图片(传base64)
下一页
接口使用示例 (局部重绘)
Built with