Gemini 原生（图像）

Gemini 原生（图像）

curl --request POST \
  --url https://api.tennda.ai/v1beta/models/{model}:generateContent \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.tennda.ai/v1beta/models/{model}:generateContent"

headers = {"Authorization": "<authorization>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: '<authorization>'}};

fetch('https://api.tennda.ai/v1beta/models/{model}:generateContent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tennda.ai/v1beta/models/{model}:generateContent",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tennda.ai/v1beta/models/{model}:generateContent"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tennda.ai/v1beta/models/{model}:generateContent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

POST

v1beta

models

{model}

:generateContent

Gemini 原生（图像）

curl --request POST \
  --url https://api.tennda.ai/v1beta/models/{model}:generateContent \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.tennda.ai/v1beta/models/{model}:generateContent"

headers = {"Authorization": "<authorization>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: '<authorization>'}};

fetch('https://api.tennda.ai/v1beta/models/{model}:generateContent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tennda.ai/v1beta/models/{model}:generateContent",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tennda.ai/v1beta/models/{model}:generateContent"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tennda.ai/v1beta/models/{model}:generateContent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

简介

Gemini 图像可通过两种协议调用：

Gemini 原生：POST /v1beta/models/{model}:generateContent，设置 responseModalities: ["IMAGE"] 与 imageConfig
OpenAI 兼容：POST /v1/images/generations（见 Nano Banana）或 POST /v1/chat/completions（部分图像模型）

若使用 OpenAI SDK 或统一 images/generations 入口，请优先阅读 Nano Banana 文档。

认证

string

必填

Bearer Token，如 Bearer sk-xxxxxxxxxx

string

可选：x-goog-api-key: sk-xxxxxxxxxx

支持的模型（示例）

模型 ID	说明	推荐端点
`gemini-2.5-flash-image`	Nano Banana	`/v1/images/generations` 或原生 `generateContent`
`gemini-3-pro-image-preview`	Nano Banana Pro	同上

请求示例

Gemini 原生（generateContent）
OpenAI Chat（图像）

curl -X POST "https://api.tennda.ai/v1beta/models/gemini-2.5-flash-image:generateContent" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "画一只在花园里玩耍的橙色小猫，高质量摄影"}]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K",
        "imageOutputOptions": {"mimeType": "image/png"}
      }
    }
  }'

图片在 candidates[0].content.parts[].inlineData（Base64）。

部分集成通过 Chat Completions 调用 Gemini 图像模型：

curl -X POST "https://api.tennda.ai/v1/chat/completions" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash-image",
    "messages": [
      {"role": "user", "content": "生成一张赛博朋克风格的城市夜景"}
    ]
  }'

具体响应字段因模型而异，推荐新接入使用 generateContent 或 Nano Banana。

常用参数

generationConfig.responseModalities：须包含 "IMAGE"
generationConfig.imageConfig.aspectRatio：如 1:1、16:9
generationConfig.imageConfig.imageSize：如 1K、2K、3K
contents[].parts：文生图为 text；图生图可加入 inlineData（图片 Base64）

完整 Gemini 能力（思考模式、工具调用、流式等）见原生 Gemini 格式。

快速开始与基础

文本与对话生成

音频处理与内容安全

图像生成与编辑

视频生成与任务管理

接口模块

简介

认证

支持的模型（示例）

请求示例

常用参数

​简介

​认证

​支持的模型（示例）

​请求示例

​常用参数

简介

认证

支持的模型（示例）

请求示例

常用参数